사용자 지정 제공업체와 함께 사용하는 Codex CLI: config.toml, GPT 및 Claude 모델, IDE 확장 프로그램 및 문제 해결
Codex는 하나의 파일을 읽으며, ~/.codex/config.toml, 이 파일은 CLI와 codex exec IDE 확장 프로그램이 공유합니다. 이 파일에 사용자 지정 공급자를 설정하면 Codex가 이 게이트웨이에 연결되며, 동일한 설정으로 GPT 모델과 Claude 모델을 실행할 수 있습니다. 현재 Codex 버전은 Responses API(wire_api = "responses")만 사용하므로, wire_api = "chat" 을 사용하는 이전 가이드는 더 이상 작동하지 않습니다.
Codex 설치
# macOS / Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# or with a package manager
npm install -g @openai/codex
brew install --cask codex
codex --versionpowershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"VS Code, Cursor, Windsurf용 Codex 확장 프로그램은 편집기의 확장 프로그램 마켓플레이스에서 설치하며, CLI와 동일한 ~/.codex/config.toml 을 사용하므로 아래 내용은 둘 다에 적용됩니다.
올바른 그룹의 키 사용
게이트웨이 키는 하나의 그룹에 속하며, 해당 그룹에 따라 키로 호출할 수 있는 모델이 결정됩니다. GPT 모델의 경우 대시보드에서 **Codex** 그룹에 키를 생성하세요. Claude 모델의 경우 Claude 종량제 키라면 무엇이든 사용할 수 있습니다. 무제한 그룹의 키는 활성 요금제가 필요하며, 활성 요금제가 없으면 모든 요청이 다음 오류로 실패합니다. No active subscription found for this group.
export AIPRIME_CODEX_KEY=key_from_the_codex_group # GPT models
export AIPRIME_CLAUDE_KEY=key_from_a_claude_group # Claude modelssetx AIPRIME_CODEX_KEY "key_from_the_codex_group"
setx AIPRIME_CLAUDE_KEY "key_from_a_claude_group"
# open a new terminal afterwardsGPT 모델용 config.toml
model_provider = "aiprime"
model = "gpt-6-astra"
model_reasoning_effort = "high"
[model_providers.aiprime]
name = "AI Prime Tech"
base_url = "https://aiprimetech.io/v1"
env_key = "AIPRIME_CODEX_KEY"
wire_api = "responses"
supports_websockets = false| 다음 설정은 | 이유 |
|---|---|
[model_providers.aiprime] | 예약된 다음 값을 제외한 모든 ID openai, ollama 및 lmstudio |
base_url = "https://aiprimetech.io/v1" | Codex가 다음 값을 덧붙입니다. /responses 해당 값 뒤에 |
env_key | 키 자체가 아니라 키를 담고 있는 환경 변수의 **이름** |
wire_api = "responses" | 현재 Codex가 허용하는 유일한 값 |
supports_websockets = false | Codex가 일반 HTTP 스트리밍을 사용하도록 유지하여 모든 프록시나 VPN을 통해 작동하게 합니다. |
requires_openai_auth = true 또는 experimental_bearer_token 이 공급자에. 다음 설정을 사용하면 requires_openai_auth = true Codex가 다음 항목을 무시하고 env_key 대신 ChatGPT 또는 OpenAI 로그인 정보를 전송하며, 게이트웨이는 이를 거부합니다.Claude 모델로 Codex 실행
게이트웨이는 Claude 모델에 대한 Responses API 요청을 받아 변환하므로 Codex로 Claude도 사용할 수 있습니다. Claude 키를 사용하는 두 번째 공급자를 추가한 다음, 해당 공급자로 전환할 프로필을 추가하세요.
[model_providers.aiprime_claude]
name = "AI Prime Tech (Claude)"
base_url = "https://aiprimetech.io/v1"
env_key = "AIPRIME_CLAUDE_KEY"
wire_api = "responses"
supports_websockets = falsemodel_provider = "aiprime_claude"
model = "claude-sonnet-5"
model_reasoning_effort = "high"codex --profile claude
codex exec --profile claude "review the last commit for bugs"Codex 0.134.0부터 프로필은 별도 파일로 저장됩니다. ~/.codex/<name>.config.toml, 키는 최상위 수준에 배치합니다. [profiles.<name>] 내부의 테이블은 config.toml 더 이상 읽히지 않습니다. 프로필과 공급자는 사용자 설정에서만 지정할 수 있습니다. 프로젝트의 .codex/config.toml 은 다음 항목을 무시합니다. model_provider 및 model_providers.
모델과 추론 강도
| 모델 ID | 공급자 | 권장 용도 |
|---|---|---|
gpt-6-astra | Codex 그룹 키 | 게이트웨이에서 가장 강력한 GPT 모델. 장시간 에이전트 작업에 적합 |
gpt-6-sol | Codex 그룹 키 | 일상적인 코딩을 위한 더 빠르고 저렴한 GPT |
gpt-5.6-terra | Codex 그룹 키 | 간단한 작업과 빠른 수정 |
claude-sonnet-5 | Claude 키 | 코딩 작업을 위한 기본 Claude 모델 |
claude-opus-5-5 | Claude 키 | 더 어려운 추론과 대규모 리팩터링 |
claude-fable-5-1 | Claude 키 | 성능이 가장 뛰어나며 비용도 가장 높음 |
model_reasoning_effort 은 다음 값을 허용합니다. low, medium, high, xhigh 또는 max, 모델에 따라 다릅니다. 다음 값은 설정하지 마세요. none: 이 모델들은 해당 값을 거부하고 다음 오류를 반환합니다. 'none' is not supported. review_model 은 다음 용도로 다른 모델을 설정합니다. /review 원하는 경우 사용할 수 있습니다. 대시보드에는 키가 속한 그룹에서 호출할 수 있는 모든 모델이 표시됩니다.
IDE 확장 프로그램과 codex exec
IDE 확장 프로그램은 동일한 config.toml을 읽지만, env_key 은 편집기 자체의 환경에서 확인됩니다. Dock이나 시작 메뉴에서 실행한 편집기는 다음 파일에서 내보낸 변수를 인식하지 못합니다. .bashrc, 그러면 Codex는 다음 오류로 실패합니다. Invalid API key CLI는 정상적으로 작동하더라도 말입니다. 변수를 시스템 전체에 설정하거나(Windows에서는 setx 으로 설정할 수 있습니다), 터미널에서 편집기를 실행하세요. 예: code ..
codex exec 은 대화형 UI 없이 작업 하나를 실행하므로 스크립트와 CI에 적합합니다. 동일한 설정과 프로필을 사용합니다.
codex exec "write unit tests for utils.py"
codex exec --profile claude "summarise the changes on this branch"
codex login status # which authentication method is active재시도 및 시간 제한
각 공급자는 자체 재시도 및 스트림 설정을 갖습니다. 기본값은 요청 재시도 4회, 스트림 재연결 5회, 스트림별 유휴 시간 제한 5분입니다. 긴 추론 과정에서는 한동안 출력이 없을 수 있으므로 추론 강도가 높을 때는 유휴 시간 제한을 늘리는 것이 도움이 됩니다.
[model_providers.aiprime]
# ...settings from above...
request_max_retries = 6
stream_max_retries = 8
stream_idle_timeout_ms = 600000문제 해결: Codex 사용자에게 발생하는 오류
아래 오류는 이 게이트웨이에서 Codex 클라이언트가 실제로 발생시키는 오류이며, 가장 흔한 것부터 나열했습니다.
| 표시되는 내용 | 원인 | 해결 방법 |
|---|---|---|
403 No active subscription found for this group | 키가 활성 요금제가 없는 무제한 그룹에 속해 있음 | 종량제 그룹의 키(GPT의 경우 Codex)를 사용하거나 요금제를 구매하세요. |
401 Invalid API key | Codex를 실행하는 프로세스(주로 IDE)에서 변수가 비어 있거나, requires_openai_auth = true 으로 인해 Codex가 다른 로그인 정보를 전송함 | echo $AIPRIME_CODEX_KEY; 다음 항목을 제거하세요. requires_openai_auth; 편집기를 다시 시작하세요. |
404 Model "..." is not supported by any configured account in this group | 모델이 키의 그룹에 속하지 않음. 예: GPT 키로 Claude 모델 사용 | 키가 모델과 일치하도록 공급자나 프로필을 전환하세요. |
426 WebSocket upgrade required | WebSocket 전송이 켜져 있지만 연결이 업그레이드되지 않음 | supports_websockets = false, 그리고 다음 항목을 제거하세요. responses_websockets_v2 다음 항목에서 [features] |
403 Your API key has expired | 키 생성 시 만료일이 지정됨 | 대시보드에서 새 키를 생성하세요. |
'none' is not supported | 추론 강도가 다음 값으로 설정됨 none | 다음을 사용하세요: low 이상 |
404 page not found | base_url 에 다음 내용이 포함됨 /v1 두 번 | 정확히 다음 값을 사용하세요. https://aiprimetech.io/v1 |
다음 항목에 관한 설정 오류 wire_api 업그레이드 후 | A wire_api = "chat" 이전 가이드에 있던 줄 | 설정할 항목: wire_api = "responses" |
Your balance is used up | 잔액이 없음 | 충전 |
Concurrency limit exceeded for user | 여러 Codex 에이전트 또는 창이 동시에 실행 중 | 병렬 실행 수를 줄이거나 지원팀에 동시 실행 한도 상향을 요청하세요 |
하나를 선택하기 전에 Codex와 Claude Code를 비교하고 계신가요? 다음을 참고하세요 Claude Code와 Codex 비교.
자주 묻는 질문
Codex 설정 파일은 어디에 있나요?
Codex CLI에서 Claude 모델을 사용할 수 있나요?
Codex에서 wire_api = "chat"이 아직 작동하나요?
CLI는 작동하는데 Codex VS Code 확장 프로그램에서는 API 키가 유효하지 않다고 표시되는 이유는 무엇인가요?
Codex에서 '이 그룹에 활성 구독이 없습니다'는 무슨 뜻인가요?
API 키를 발급받으세요 — Anthropic 계정이나 대기자 명단 등록이 필요하지 않습니다.
API 키 발급받기AI Prime Tech는 독립적인 API 게이트웨이입니다. Anthropic과 제휴 관계가 없으며, Anthropic의 보증을 받거나 Anthropic의 리셀러로 활동하지 않습니다. Claude 및 관련 모델 이름은 각 소유자의 상표입니다.