> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CometAPI와 함께 Hermes Agent 사용하기

> 이 가이드를 사용해 OpenAI 호환 chat 또는 Anthropic Messages 설정을 통해 Hermes Agent를 CometAPI에 연결하세요.

[CometAPI](https://www.cometapi.com)를 [Hermes Agent](https://hermes-agent.nousresearch.com/docs/)의 model provider로 사용하세요. 이 가이드에서는 Hermes가 두 가지 CometAPI 경로를 지원합니다. 대부분의 텍스트 모델용 일반적인 OpenAI 호환 엔드포인트와 Anthropic 메시지를 통한 Claude 경로입니다.

## 사전 준비

* Git
* 활성화된 API 키가 있는 CometAPI 계정
* macOS, Linux 또는 WSL2의 터미널

## 설치

<Steps>
  <Step title="CometAPI API 키 가져오기">
    [CometAPI 콘솔](https://www.cometapi.com/console/token)에 로그인하세요. **Add API Key**를 클릭하고 CometAPI API 키를 복사하세요.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/overview/810968_364191.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=aef81a83f29f8eb16655ed4060425f50" alt="Add API Key 버튼이 표시된 CometAPI 대시보드" width="3824" height="1892" data-path="images/overview/810968_364191.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/HhtmQffktazbxUvS/images/overview/810968_364193.png?fit=max&auto=format&n=HhtmQffktazbxUvS&q=85&s=d893f659267150d0faf45f99eb5dffc1" alt="base URL이 표시된 CometAPI API 키 세부 정보" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="Hermes Agent 설치하기">
    다음 명령어는 공식 설치 프로그램을 실행합니다:

    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
    ```

    현재 셸에서 아직 `hermes` 명령어가 보이지 않는다면, 셸 구성을 다시 불러오세요:

    ```bash theme={null}
    source ~/.zshrc
    # or
    source ~/.bashrc
    ```

    <Note>
      Hermes는 설정을 `~/.hermes/`에 저장하고, `hermes` 명령어를 `~/.local/bin`에 링크하며, `~/.local/bin`을 셸 PATH에 추가할 수 있습니다.
    </Note>
  </Step>
</Steps>

## 구성

모델 계열에 맞는 CometAPI 경로를 선택하세요:

| 모델 계열             | Hermes 구성                                                                          | CometAPI 경로                 |
| ----------------- | ---------------------------------------------------------------------------------- | --------------------------- |
| OpenAI 호환 텍스트 모델  | `model.provider: custom` 및 `base_url: https://api.cometapi.com/v1`                 | `/v1/chat/completions`      |
| Claude 모델         | `transport: anthropic_messages`를 사용하는 이름 있는 provider                               | `/v1/messages`              |
| Hermes의 Gemini 모델 | OpenAI 호환 구성을 사용                                                                   | `/v1/chat/completions`      |
| 직접 Gemini API 호출  | Hermes 외부에서 [Gemini `generateContent` API](/api/text/gemini-generating-content) 사용 | `/v1beta` `generateContent` |

<Warning>
  Hermes를 `https://api.cometapi.com/v1beta`로 사용자 지정 Gemini 네이티브 provider로 구성하지 마세요. Gemini 모델에는 OpenAI 호환 Hermes 구성을 사용하세요. 직접 Gemini API를 호출하려면 [Gemini `generateContent` API](/api/text/gemini-generating-content)를 사용하세요.
</Warning>

<Steps>
  <Step title="CometAPI 키 저장">
    `~/.hermes/.env`를 열고 다음 값을 추가하세요:

    ```dotenv theme={null}
    COMETAPI_KEY=<COMETAPI_KEY>
    OPENAI_API_KEY=<COMETAPI_KEY>
    ```

    `COMETAPI_KEY`는 이름 있는 Claude provider에서 사용됩니다. `OPENAI_API_KEY`는 Hermes의 사용자 지정 OpenAI 호환 엔드포인트 폴백이 계속 작동하도록 합니다.
  </Step>

  <Step title="OpenAI 호환 경로 구성">
    이 경로는 Hermes에서 사용하는 Gemini 모델을 포함해 대부분의 CometAPI 텍스트 모델에 사용합니다. `~/.hermes/config.yaml`를 열고 `model` 섹션이 다음과 같은지 확인하세요:

    ```yaml theme={null}
    model:
      provider: custom
      default: your-model-id
      base_url: https://api.cometapi.com/v1
    ```

    `your-model-id`를 [CometAPI Models page](https://www.cometapi.com/models/)의 현재 텍스트 model ID로 바꾸세요.

    <Note>
      API 키는 `~/.hermes/.env`에 보관하세요. `config.yaml`에 비밀 정보를 하드코딩하지 마세요.
    </Note>

    <Note>
      이 설정은 기본 채팅 모델을 구성합니다. Hermes는 비전이나 웹 추출 같은 작업에 별도의 보조 모델을 사용할 수 있습니다.
    </Note>
  </Step>

  <Step title="Claude Messages 경로 구성">
    Hermes가 Anthropic 메시지를 통해 Claude 모델을 호출하도록 하려면 이 경로를 사용하세요. `~/.hermes/config.yaml`를 열고 이름 있는 provider를 사용하세요:

    ```yaml theme={null}
    model:
      provider: cometapi-claude
      default: your-claude-model-id

    providers:
      cometapi-claude:
        base_url: https://api.cometapi.com
        key_env: COMETAPI_KEY
        transport: anthropic_messages
        default_model: your-claude-model-id
    ```

    `your-claude-model-id`를 [CometAPI Models page](https://www.cometapi.com/models/)의 현재 Claude model ID로 바꾸세요.

    <Note>
      이 경로에서는 `base_url`을 `https://api.cometapi.com`로 유지하세요. Hermes는 이름 있는 provider의 Anthropic Messages transport를 사용합니다.
    </Note>
  </Step>
</Steps>

## 검증

<Steps>
  <Step title="구성 확인">
    다음 명령은 Hermes가 config와 API 키를 읽을 수 있는지 확인합니다:

    ```bash theme={null}
    hermes config check
    ```

    업데이트 후 `hermes config check`에서 누락된 옵션이 보고되면 `hermes config migrate`를 실행한 뒤 다시 확인하세요.
  </Step>

  <Step title="실제 채팅 테스트 실행">
    다음 명령은 CometAPI를 통해 실제 요청을 보냅니다:

    ```bash theme={null}
    hermes chat -Q --ignore-rules --max-turns 1 -q "Reply with CONNECTED only."
    ```

    설정이 성공하면 `CONNECTED`가 반환되며 auth 또는 endpoint 오류가 없어야 합니다. Claude Messages 구성이 활성화된 경우, 이는 Hermes가 CometAPI를 통해 `anthropic_messages` transport를 사용할 수 있음을 확인해 줍니다.
  </Step>
</Steps>

## 선택적 구성

<AccordionGroup>
  <Accordion title="클린 재설치(선택 사항)">
    이전 Hermes 설치를 교체하는 경우, 먼저 내장 제거 프로그램을 사용하세요:

    ```bash theme={null}
    hermes uninstall
    ```

    제거 프로그램에서 CLI, PATH 항목, `~/.hermes/` 데이터를 제거하려면 **Full uninstall**을 선택하세요. 그런 다음 설치 단계를 다시 실행하고 동일한 CometAPI 구성으로 계속 진행하세요.
  </Accordion>

  <Accordion title="대신 hermes model 사용(선택 사항)">
    OpenAI 호환 경로에 대해 대화형 흐름을 선호한다면 `hermes model`을 실행하고 **Custom endpoint**를 선택하세요.

    그런 다음 다음 값을 입력하세요:

    * Base URL: `https://api.cometapi.com/v1`
    * API key: CometAPI API 키
    * Model: 현재 CometAPI 텍스트 model ID

    이 흐름은 OpenAI 호환 provider 설정을 `config.yaml`에 기록합니다. Claude Messages의 경우, 이름이 지정된 provider가 `transport: anthropic_messages`를 유지하도록 `config.yaml`을 직접 편집하세요.
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#howto",
        "name": "CometAPI와 함께 Hermes Agent 사용하기",
        "description": "이 가이드를 사용해 OpenAI 호환 채팅 또는 Anthropic 메시지 설정을 통해 Hermes Agent를 CometAPI에 연결하세요.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-1",
            "position": 1,
            "name": "CometAPI API 키 받기",
            "text": "CometAPI 계정을 생성하거나 열고, 대시보드에서 활성 API 키를 복사하세요."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-2",
            "position": 2,
            "name": "Hermes Agent 설치",
            "text": "CometAPI와 함께 Hermes Agent 사용하기 가이드에서 Hermes Agent 설치 단계를 완료하세요."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-3",
            "position": 3,
            "name": "CometAPI 키 저장",
            "text": "CometAPI와 함께 Hermes Agent 사용하기 가이드에서 CometAPI 키 저장 단계를 완료하세요."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-4",
            "position": 4,
            "name": "OpenAI 호환 경로 구성",
            "text": "CometAPI와 함께 Hermes Agent 사용하기 가이드에서 OpenAI 호환 경로 구성 단계를 완료하세요."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-5",
            "position": 5,
            "name": "Claude Messages 경로 구성",
            "text": "CometAPI와 함께 Hermes Agent 사용하기 가이드에서 Claude Messages 경로 구성 단계를 완료하세요."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-6",
            "position": 6,
            "name": "구성 확인",
            "text": "CometAPI와 함께 Hermes Agent 사용하기 가이드에서 구성 확인 단계를 완료하세요."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-7",
            "position": 7,
            "name": "실제 채팅 테스트 실행",
            "text": "CometAPI와 함께 Hermes Agent 사용하기 가이드에서 실제 채팅 테스트 실행 단계를 완료하세요."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI 문서",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "통합",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "CometAPI와 함께 Hermes Agent 사용하기",
            "item": "https://apidoc.cometapi.com/integrations/hermes-agent"
          }
        ]
      }
    ]
    }
    `}
</script>