전체 가이드 / 코딩 어시스턴트

Codex CLI에서 XHuoAPI 사용하기

Codex CLI는 설정 파일에서 사용자 지정 모델 provider를 추가할 수 있습니다. 요청에는 OpenAI의 Responses 엔드포인트(/v1/responses)만 쓰기 때문에, XHuoAPI를 통해 쓸 수 있는 것은 GPT 계열 모델입니다. codex-cli 0.156.1로 실제 파일 작성 작업을 실행했고, 아래 설정은 테스트에 쓴 그대로입니다.

시작하기 전에

콘솔에서 가입하고 API 토큰을 만듭니다. 가입에는 이메일만 필요하고 전화번호는 필요하지 않습니다.
토큰을 만들 때 티어를 선택합니다. 신규 계정의 기본값은 Standard입니다. 티어는 가격과 안정성, 사용 가능한 모델을 결정합니다. 자세한 내용은 가격 페이지를 참조하세요.

먼저 확인

도구를 설정하기 전에 curl로 키와 모델이 작동하는지 확인하세요. '설정했는데 반응이 없다'는 경우의 절반은 여기서 걸러집니다.

curl https://api.xhuoapi.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v3.2","messages":[{"role":"user","content":"ping"}]}'

설정 단계

Codex CLI를 설치합니다.

npm install -g @openai/codex

~/.codex/config.toml을 편집하고(없으면 새로 만들고) 아래 내용을 넣습니다. wire_api는 반드시 responses여야 합니다.

model = "gpt-5.5"
model_provider = "xhuoapi"

[model_providers.xhuoapi]
name = "XHuoAPI"
base_url = "https://api.xhuoapi.ai/v1"
env_key = "XHUO_API_KEY"
wire_api = "responses"

env_key에 지정한 환경 변수에 API 키를 넣습니다.

export XHUO_API_KEY=YOUR_XHUOAPI_KEY

프로젝트 디렉터리에서 codex를 실행하면 대화형 모드, codex exec로 일회성 작업을 실행할 수 있습니다. -m으로 모델을 잠시 바꿀 수 있습니다.

codex exec -m gpt-5.4 "Explain what this repository does"

주의 사항

wire_api를 chat으로 쓰면 'wire_api = "chat" is no longer supported' 오류가 바로 납니다. 현재 Codex는 responses만 지원합니다.

테스트 결과(2026-10-06, Codex에 파일을 만들고 쓰게 하는 작업): gpt-5.5, gpt-5.4, gpt-4.1은 모두 작업을 마쳤습니다. deepseek-v3.2와 claude-sonnet-4-6은 Codex에서 Reconnecting을 반복하다 실패했으니, 이 모델들은 Claude Code나 Cline 같은 도구에서 쓰세요.

같은 테스트에서 gpt-5.3-codex는 파일을 만들었다고 답했지만 실제로는 생성되지 않았고, Codex는 이 모델의 메타데이터를 찾을 수 없다고 경고했습니다. gpt-5.5나 gpt-5.4를 권장합니다.

모델 ID는 가격 페이지의 표기와 정확히 일치해야 합니다(DeepSeek V4 Pro가 아니라 deepseek-v4-pro). 대소문자와 하이픈도 구분됩니다.

자주 사용하는 모델

이런 도구에서 자주 선택되는 모델입니다. 모델 이름을 클릭하면 티어별 가격을 볼 수 있습니다. 전체 목록은 가격 페이지에 있습니다.

gpt-5.5 gpt-5.4 gpt-4.1

단계는 해당 도구의 현재 공식 문서를 기준으로 정리했습니다. 업데이트 후 UI가 바뀔 수 있습니다. 다른 점이 있으면 알려 주세요.