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를 빌드합니다. 처음 실행할 때 로컬 샌드박스 런타임과 이미지를 다운로드할 수 있습니다.
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 오리진만 허용하도록 로컬 볼트에 키를 추가합니다.
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에 연결합니다.
---
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를 생략하면 대화형 세션이 시작됩니다.
exo run icodeeasy-agent.md --prompt "Reply with a short greeting."
요청이 완료되면 사용 로그에서 모델과 상태를 확인합니다. 401 오류가 발생하면 키를 확인하고 모델 또는 권한 오류가 발생하면 모델 ID와 접속 지점을 확인합니다.
클라이언트 공식 문서
관련 가이드
Codex 설정
Codex CLI를 설치하고 auth.json에 API 키를 저장한 뒤 I Code Easy provider와 Base URL을 설정하여 첫 세션을 시작합니다.
OpenAI Responses
OpenAI Responses 형식으로 입력을 보냅니다. 예시는 HTTP 스트리밍을 사용합니다. Codex 설정은 관련 가이드를 참고하세요.
연결이 느리거나 요청에 실패하면 어떻게 해결하나요?
401, 403, 429, 시간 초과, Gemini 경로 오류를 먼저 가릅니다. 네트워크가 원인일 때만 jp 또는 sg 예비 도메인으로 바꿉니다.