---
title: "Hermes Agent에서 RunAPI 사용 - 사용자 지정 endpoint 설정 가이드"
url: "https://runapi.ai/ko/hermes-agent.md"
canonical: "https://runapi.ai/ko/hermes-agent"
locale: "ko"
---

# RunAPI in Hermes Agent

Hermes Agent는 채팅 모델용 OpenAI 호환 사용자 지정 endpoint를 사용할 수 있습니다. Prompt를 Hermes Agent에 붙여넣고 custom provider 생성을 맡기세요. 정확한 YAML이 필요할 때만 config 탭을 사용하면 됩니다.

## Install prompt

Copy this prompt into Hermes Agent:

```text
Configure this Hermes Agent install to use RunAPI.

Requirements:
- Read the API key from RUNAPI_API_KEY. Do not hardcode the key.
- Add a custom provider named runapi.
- Use base_url "https://runapi.ai/v1".
- Use key_env RUNAPI_API_KEY.
- Use api_mode chat_completions.
- Set model.provider to custom:runapi.
- Set the default model to gpt-5.5.
- Run `hermes doctor` and report any config problems before starting a session.
- If RUNAPI_API_KEY is missing, ask me to set it before starting Hermes Agent.
```

## Configuration

```yaml
custom_providers:
  - name: runapi
    base_url: "https://runapi.ai/v1"
    key_env: RUNAPI_API_KEY
    api_mode: chat_completions

model:
  provider: custom:runapi
  default: gpt-5.5
```

## Steps

1. **설정 Prompt 붙여넣기** — 첫 번째 탭의 Prompt를 Hermes Agent에 복사하세요. 이 Prompt는 Hermes Agent가 RUNAPI_API_KEY를 읽고 RunAPI를 이름 있는 custom provider로 추가하도록 지시합니다.
2. **생성된 config 확인** — Hermes Agent는 provider를 custom:runapi로 설정하고 기본값을 gpt-5.2로 두며 key_env가 RUNAPI_API_KEY를 가리키게 해야 합니다.
3. **진단 실행** — config를 수정한 뒤 hermes doctor를 실행하고, Hermes Agent를 열어 짧은 테스트 Prompt를 보낸 다음 더 큰 작업에 사용하세요.

## FAQ

### Hermes Agent에서 RunAPI를 사용자 지정 endpoint로 사용할 수 있나요?

네. Hermes Agent는 모델 선택과 사용자 지정 endpoint를 지원합니다. 이름 있는 custom provider에 RunAPI /v1 base URL을 설정하고, API key는 RUNAPI_API_KEY에 두고, gpt-5.2 같은 RunAPI 모델을 선택하세요.

### hermes model을 사용해야 하나요, 아니면 config 파일을 편집해야 하나요?

안내형 선택기를 원하면 hermes model을 사용하세요. 서버나 공유 환경에서 반복 가능한 설정이 필요하면 config 파일을 편집하세요. 두 경우 모두 이후 hermes doctor로 확인하는 것이 좋습니다.

### Hermes Agent용 RUNAPI_API_KEY는 어디에 설정해야 하나요?

Hermes Agent를 실행하는 같은 shell, service unit 또는 gateway 환경에 RUNAPI_API_KEY를 설정하세요. GUI 또는 daemon 실행은 대화형 shell 변수를 항상 상속하지는 않습니다.

### RunAPI를 추가한 뒤에도 Hermes Agent에서 다른 provider를 사용할 수 있나요?

네. RunAPI를 custom:runapi로 추가해도 다른 Hermes Agent 모델 옵션은 제거되지 않습니다. 설정된 모델 사이를 전환하려면 hermes model 또는 /model 명령을 사용하세요.


## Links

- [Model catalog](https://runapi.ai/ko/models)
- [CLI](https://runapi.ai/ko/cli)
- [MCP Server](https://runapi.ai/ko/mcp)
- [Pricing](https://runapi.ai/ko/pricing)
- [API docs](https://runapi.ai/ko/docs)
- [OpenClaw setup](https://runapi.ai/ko/openclaw)