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

Exo Harness 설정

이 가이드는 Exo Harness(exoharness/exo)를 다룹니다. 별도 프로젝트인 EXO는 여러 기기에서 로컬 추론을 분산 실행하는 데 사용됩니다.

이 예제에서는 GPT-6.1 Sol (gpt-6.1-sol)을 사용합니다. API 키에서 I Code Easy API 키를 발급받습니다. 접속 지점 선택에서 GPT 모델의 표준 접속 지점을 선택합니다.

설치

Rust, Cargo, pnpm을 준비한 후 공식 저장소에서 Exo를 빌드합니다. 처음 실행할 때 로컬 샌드박스 런타임과 이미지를 다운로드할 수 있습니다.

bash
git clone https://github.com/exoharness/exo.git
cd exo
pnpm install --frozen-lockfile
cargo build -p exo
export PATH="$PWD/target/debug:$PATH"

Exo Harness

로컬 단일 사용자 환경에서 진행합니다. 터미널에서 API 키를 설정한 후 I Code Easy API 오리진만 허용하도록 로컬 볼트에 키를 추가합니다.

bash
export ICODEEASY_API_KEY='YOUR_API_KEY'
exo vault secret create global icodeeasy \
  --token-env ICODEEASY_API_KEY \
  --allow-origin https://api.icodeeasy.cc

icodeeasy-agent.md를 만듭니다. 아래 정의는 Codex 하네스를 선택하고 HTTP Responses로 I Code Easy에 연결합니다.

markdown
---
harness: codex
model:
  name: gpt-6.1-sol
  credential: icodeeasy
  base_url: https://api.icodeeasy.cc/v1
---

짧은 한 문장으로 답하세요.

https://jp.icodeeasy.cc 또는 https://sg.icodeeasy.cc를 사용할 때는 base_url의 /v1을 유지하고 exo vault secret update global icodeeasy의 --allow-origin으로 예비 도메인을 허용합니다. 기존 도메인도 계속 사용하려면 --allow-origin을 반복해서 지정합니다.

첫 요청 검증

아래 명령으로 연결을 확인합니다. --prompt를 생략하면 대화형 세션이 시작됩니다.

bash
exo run icodeeasy-agent.md --prompt "Reply with a short greeting."

요청이 완료되면 사용 로그에서 모델과 상태를 확인합니다. 401 오류가 발생하면 키를 확인하고 모델 또는 권한 오류가 발생하면 모델 ID와 접속 지점을 확인합니다.

클라이언트 공식 문서