클라이언트 연동초보자업데이트

Hermes Agent 설정

이 예제에서는 Kimi K3.1 Pro (k3.1-pro)을 사용합니다. API 키에서 I Code Easy API 키를 발급받습니다.

설치

Linux, macOS 또는 WSL에서 다음 명령을 실행합니다. Windows에서 직접 사용할 경우 공식 설치 가이드의 PowerShell 절차를 따릅니다.

bash
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을 설정했다면 해당 경로를 사용합니다.

yaml
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를 자신의 키로 바꿉니다.

dotenv
ICODEEASY_API_KEY=YOUR_API_KEY

세션 시작

hermes를 실행하여 세션을 시작합니다. 열린 세션에서 모델을 바꾸려면 /model custom:icodeeasy:k3.1-pro를 사용합니다.

첫 요청 검증

간단한 텍스트 프롬프트를 보내고 사용 로그에서 모델과 요청 상태를 확인합니다. 401 오류가 발생하면 키를 확인하고, 모델 또는 권한 오류가 발생하면 모델 ID와 접속 지점을 확인합니다. 연결이 불안정하면 /v1 경로를 유지한 채 도메인을 https://jp.icodeeasy.cc 또는 https://sg.icodeeasy.cc로 바꿉니다.

클라이언트 공식 문서