홈 → 가이드 → Codex를 커스텀 API로 쓰기: Codex CLI와 데스크톱 앱의 config.toml 설정

Codex를 커스텀 API로 쓰기: Codex CLI와 데스크톱 앱의 config.toml 설정

Codex는 프로바이더 설정을 파일 하나에서 읽습니다. 설정 다섯 줄과 환경 변수 하나면 명령줄 도구와 데스크톱 앱을 모두 다른 엔드포인트로 바꿀 수 있습니다. 실패는 대부분 설정 파일이 아니라 환경 변수에서 생깁니다.

설정 내용

config.toml에 프로바이더를 추가하고 기본값으로 지정하세요:

model = "gpt-6.1-sol"
model_provider = "apiclan"
model_reasoning_effort = "medium"

[model_providers.apiclan]
name = "APICLAN"
base_url = "https://apiclan.us/v1"
env_key = "APICLAN_API_KEY"
wire_api = "responses"

세 가지가 중요합니다. base_url은 /v1로 끝나야 합니다. Codex가 /responses를 직접 붙이기 때문입니다. wire_api = "responses"는 Codex가 Responses API를 쓰게 하며, 이 게이트웨이가 지원합니다. 그리고 env_key에는 키 자체가 아니라 환경 변수의 이름을 적습니다.

파일 위치

macOS / Linux: ~/.codex/config.toml
Windows: %USERPROFILE%\.codex\config.toml

폴더나 파일이 없으면 새로 만드세요. Codex 데스크톱 앱은 명령줄 도구와 같은 파일을 읽으므로 한 번 고치면 둘 다 적용됩니다. TOML을 직접 고치기 싫다면 CC Switch가 대신 써 줄 수 있습니다. 데스크톱 앱 가이드를 참고하세요.

Codex가 볼 수 있게 키 설정하기

macOS / Linux — 셸 프로필에 추가:

echo 'export APICLAN_API_KEY=sk-your-key' >> ~/.zshrc
source ~/.zshrc

Windows — 사용자 계정에 저장:

setx APICLAN_API_KEY "sk-your-key"

대부분 여기서 막힙니다. export나 $env:로 설정한 변수는 그 터미널 안에서만 유효해서, Dock이나 시작 메뉴로 실행한 데스크톱 앱은 이를 보지 못합니다. Windows의 setx는 영구 저장하지만 그 이후에 실행한 프로그램만 읽을 수 있습니다. Codex를 완전히 종료한 뒤 다시 여세요.

모델과 추론 강도 선택

설정의 model을 바꾸거나, 세션 안에서 /model로 전환하세요:

모델	적합한 용도
`gpt-6.1-sol`, `gpt-5.6-terra`	일상적인 코딩, 수정, 테스트 — 호출당 가장 저렴
`gpt-5.6-sol`	프롬프트를 GPT-5.6에 맞춰 둔 경우
`gpt-6-astra`	다섯 배 가격을 내더라도 더 좋은 답이 필요한 어려운 문제

model_reasoning_effort는 low, medium, high, xhigh를 받습니다. 강도가 높을수록 더 많이 씁니다. 이곳 gpt-5.6-sol의 중앙값 호출은 high에서 출력 373 토큰, medium에서 139 토큰으로 2.7배였고, 모두 출력으로 과금됩니다. medium부터 시작하세요. 가격은 OpenAI API 가격 가이드에 있습니다.

이곳의 Codex 트래픽

지난 30일 동안 이 게이트웨이 GPT 호출의 87%가 Codex에서 왔고, 모두 스트리밍으로 /v1/responses를 거쳤습니다. 중앙값 호출은:

약 6.7만 토큰의 컨텍스트를 실었고 그중 86%가 캐시에서 왔습니다
전체 14초, 첫 토큰은 10초 후
출력 214 토큰

자주 만나는 오류 네 가지

401 Unauthorized → Codex가 APICLAN_API_KEY를 보지 못합니다. 위 방법대로 설정하고 Codex를 완전히 재시작하세요. 같은 환경에서 echo $APICLAN_API_KEY를 실행하면 키가 출력되어야 합니다.
404나 HTML 페이지 → base_url에 /v1이 없거나 두 번 들어갔습니다.
model not found → 모델 이름 오타이거나, 키가 속한 그룹에 그 모델이 없습니다. 기준은 GET https://apiclan.us/v1/models 결과입니다.
stream disconnected나 긴 작업 타임아웃 → 추론이 너무 길어 프록시 대기 한도를 넘었습니다. base_url을 https://api.apiclan.us/v1로 바꾸면 100초 프록시 제한을 피할 수 있습니다.

Claude Code는 반대 규칙(/v1 없음)을 씁니다. Claude Code base URL 가이드를 참고하세요.

사용 시작하기

구독 없음, 월 최소 사용액 없음, 영업 통화 없음. USDT로 충전하고 쓴 만큼만 지불하세요 — 1 USDT는 2 크레딧의 API 잔액이 됩니다.

30초 빠른 시작 읽기

언어: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

이 페이지의 가격은 실제 과금 데이터에서 자동으로 채워집니다. 제3자 조건은 해당 업체의 공개 문서에서 인용했습니다.