Hermes Agent 설정
이 예제에서는 Kimi K3.1 Pro (k3.1-pro)을 사용합니다. API 키에서 I Code Easy API 키를 발급받습니다.
설치
Linux, macOS 또는 WSL에서 다음 명령을 실행합니다. Windows에서 직접 사용할 경우 공식 설치 가이드의 PowerShell 절차를 따릅니다.
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Hermes Agent
이 설정은 Chat Completions 요청을 /v1/chat/completions로 보냅니다.
아래 설정을 ~/.hermes/config.yaml에 추가합니다. Windows의 기본 설정 디렉터리는 %LOCALAPPDATA%\hermes입니다. HERMES_HOME을 설정했다면 해당 경로를 사용합니다.
providers:
icodeeasy:
api: https://api.icodeeasy.cc/v1
key_env: ICODEEASY_API_KEY
transport: chat_completions
model:
default: k3.1-pro
provider: custom:icodeeasy
같은 디렉터리의 .env에 아래 줄을 추가하고 YOUR_API_KEY를 자신의 키로 바꿉니다.
ICODEEASY_API_KEY=YOUR_API_KEY
세션 시작
hermes를 실행하여 세션을 시작합니다. 열린 세션에서 모델을 바꾸려면 /model custom:icodeeasy:k3.1-pro를 사용합니다.
첫 요청 검증
간단한 텍스트 프롬프트를 보내고 사용 로그에서 모델과 요청 상태를 확인합니다. 401 오류가 발생하면 키를 확인하고, 모델 또는 권한 오류가 발생하면 모델 ID와 접속 지점을 확인합니다. 연결이 불안정하면 /v1 경로를 유지한 채 도메인을 https://jp.icodeeasy.cc 또는 https://sg.icodeeasy.cc로 바꿉니다.
클라이언트 공식 문서
관련 가이드
Kimi Code 설정: API Key, K3.1 Pro와 Claude Code
Kimi Code CLI와 Claude Code에서 K3.1 Pro를 설정하세요. 영구·임시 설정, Windows 세션, URL 차이와 첫 호출 확인, 401 및 모델 전환 문제 해결을 안내합니다.
Chat Completions
OpenAI Chat 형식으로 대화를 보냅니다. 요청 전에 모델과 선택한 엔드포인트가 Chat을 지원하는지 확인하세요.
연결이 느리거나 요청에 실패하면 어떻게 해결하나요?
401, 403, 429, 시간 초과, Gemini 경로 오류를 먼저 가릅니다. 네트워크가 원인일 때만 jp 또는 sg 예비 도메인으로 바꿉니다.