문제 해결 · Codex CLI
Codex config.toml 오류 — 작동하는 model_providers 설정
Codex는 잘못된 ~/.codex/config.toml을 로드하지 못합니다: 알 수 없는 프로바이더 이름, 잘못된 wire_api, 누락된 섹션. 커스텀 프로바이더에 필요한 정확한 구조.
표시되는 내용
codex config.toml error발생 원인
- model_provider가 대응하는 [model_providers.<name>] 섹션이 없는 프로바이더를 지정합니다 — 참조와 섹션은 같은 식별자를 써야 합니다.
- TOML 문법 오류: 닫히지 않은 문자열, 섹션 헤더 오타, JSON에서 쉼표·중괄호째 붙여넣은 값.
- wire_api가 엔드포인트가 서비스하는 것과 맞지 않아, 요청이 잘못된 프로토콜 형태로 만들어집니다.
- 편집한 파일이 Codex가 읽는 파일이 아닙니다 — --profile로 전달되는 프로필 파일에는 기대되는 특정 위치와 이름이 있습니다.
해결 방법
- 프로바이더 식별자를 양쪽에서 동일하게 유지하세요: model_provider = "apitoken"에는 [model_providers.apitoken]이 대응해야 합니다.
- Responses API 엔드포인트에는 wire_api = "responses"를 사용하세요 — 이 게이트웨이의 OpenAI 호환 표면은 Responses와 Chat Completions를 서비스합니다.
- 파일이 진짜 TOML인지 검증하세요: 문자열은 따옴표로, 한 줄에 key = value 하나, 섹션 헤더는 대괄호로.
- codex --profile <name>을 실행하고 어떤 파일을 로드한다고 보고하는지 지켜보세요; 비슷하게 생긴 다른 파일이 아니라 그 파일을 고치세요.
최소한의 올바른 프로필
model = "gpt-5.6-sol"
model_provider = "apitoken"
[model_providers.apitoken]
name = "apiToken.sale"
base_url = "https://openai.api.apitoken.sale/v1"
wire_api = "responses"
env_key = "APITOKEN_API_KEY"관련 검색어
unknown model providercodex model_providers not working
자주 묻는 질문
Codex가 왜 제 모델 프로바이더를 unknown이라고 하나요?+
model_provider 값은 같은 파일의 [model_providers.<name>] 섹션과 정확히 일치해야 합니다. 어느 쪽이든 오타가 있으면 조회가 깨집니다.
wire_api는 responses여야 하나요, chat이어야 하나요?+
엔드포인트가 서비스하는 것을 따르세요. 이 게이트웨이의 OpenAI 호환 표면은 Responses API — wire_api = "responses" — 와 Chat Completions를 모두 받습니다.
base_url에 /v1이 필요한가요?+
이 게이트웨이에 대한 Codex 프로필에서는 네: 문서화된 값은 문서에 실린 그대로 https://openai.api.apitoken.sale/v1입니다.