---
title: "Hermes Agent Claude API 연결"
description: "Hermes Agent에서 1折AI Claude API 중계 주소, 키, 모델 설정 튜토리얼. 프로토콜 선택, 설정 예제, 검증 단계 및 일반적인 오류를 포함합니다."
headingIds: {"연결 검증 및 문제 해결":"section-1","비용 및 기타 연결 방식":"section-2"}
---

<aside className="docs-publication" data-pagefind-ignore>

[1ZheAI](https://1zheai.com/en/editorial/#publisher)가 관리하는 문서입니다. [출처 및 수정 사항](https://1zheai.com/en/editorial/).

오류를 발견하셨나요? 페이지 주소와 설명을 첨부하여 [고객 지원](mailto:support@1zheai.com)으로 문의해 주세요. API 키나 계정 정보는 보내지 마세요.

</aside>
Hermes Agent의 사용자 지정 공급자 기능을 사용하여 1折AI에 연결합니다. 먼저 [API 키 생성](/ko/docs/api-keys/)을 하고 [현재 사용 가능한 모델](/ko/docs/models/)을 확인하세요. 아래 모델 ID는 예제이므로 키 권한에 맞게 조정하세요.

<Note>
공식 설정 확인 날짜: 2026-10-15. 아래 설정은 공식 문서에 따라 정리되었으며, 이 사이트의 엔드투엔드 검증은 아직 완료되지 않았습니다. 짧은 질의응답과 도구 호출 검증을 먼저 완료한 후 장기 작업에 사용하세요. OpenAI / GPT 모델이 출시되었으며, 모델 목록과 가격은 [모델 설명](/ko/docs/models/)을 참조하세요.
</Note>

[공식 Providers](https://hermes-agent.nousresearch.com/docs/integrations/providers)에 따라: 터미널에서 `hermes model` → Custom endpoint를 실행하고, API mode에서 `chat_completions`를 명시적으로 선택하며, Base URL에 `https://1zheai.com/v1`을 입력하고, 키와 모델을 입력합니다. ChatGPT/Codex 로그인을 선택하지 마세요. 이는 다른 연결 방식입니다.

재사용 가능한 named provider 설정, `~/.hermes/config.yaml`에 병합:

```yaml
providers:
  onezhe:
    api: https://1zheai.com/v1
    key_env: ONEZHE_API_KEY
    transport: chat_completions
    default_model: claude-sonnet-4-6
model:
  provider: custom:onezhe
  default: claude-sonnet-4-6
```

`~/.hermes/.env`에서 로컬로 제공:

```dotenv
ONEZHE_API_KEY=sk-替换为本站密钥
```

설정 후 대화에서 `/model custom:onezhe:claude-sonnet-4-6`을 전환할 수 있습니다. `/model`는 터미널 `hermes model`로 새 provider를 생성하는 대신 사용할 수 없습니다. 공식적으로 `anthropic_messages` 전송을 지원하지만, 이 튜토리얼은 URL에 따라 프로토콜을 자동 추측하지 않기 위해 Chat Completions를 사용합니다. `OPENAI_BASE_URL`는 모든 사용자 지정 provider의 일반 설정이 아닙니다. 위의 명시적 설정을 사용해야 합니다.

## 연결 검증 및 문제 해결

1. 설정을 저장하고 다시 로드하여 현재 선택된 공급자가 `onezhe` 또는 추가한 사용자 지정 모델인지 확인합니다.
2. 짧은 질문을 보내 응답이 반환되는지 확인한 후, 취소 가능한 작은 작업을 시도하여 도구 호출과 다중 턴 대화를 별도로 확인합니다.
3. [호출 로그](/ko/docs/usage-logs/)를 열어 요청 시간, 모델, 상태 및 사용량을 확인합니다. 한 번의 텍스트 응답 성공이 모든 Agent 기능의 호환성을 의미하지는 않습니다.
4. 404가 발생하면 이 문서의 주소와 프로토콜이 일치하는지 확인하고, 401이 발생하면 키 출처와 프로세스가 환경 변수를 읽었는지 확인하며, 429가 발생하면 속도 제한 정보를 확인한 후 재시도합니다. 자세한 내용은 [오류 코드 및 문제 해결](/ko/docs/troubleshooting/)을 참조하세요.

키는 로컬 환경 또는 도구의 자격 증명 저장소에만 저장하며, 코드 저장소, 스크린샷 또는 공개 로그에 커밋하지 마세요. 백그라우드 서비스는 터미널 환경 변수를 상속하지 않을 수 있습니다. 보조 모델, 검색 및 기타 도구에도 별도의 공급자 설정이 있을 수 있으므로 각각 확인해야 합니다.

## 비용 및 기타 연결 방식

[Claude API 실시간 가격](https://1zheai.com/en/pricing/)과 [과금 규칙](/ko/docs/pricing-explained/)을 확인하세요. 다른 클라이언트가 필요하면 [도구 연결 카탈로그](/ko/docs/integrations/)로 돌아가세요. 직접 프로그램을 작성하려면 [SDK 및 개발 가이드](/ko/docs/guides/)를 사용하세요.