Codex CLI와 Codex App은 로컬 작업에 config.toml과 auth.json을 함께 사용합니다. 이 설정은 OpenAI Responses를 통해 BetterToken API Key를 사용합니다.
gpt-6-astra를 사용하기 전에 Codex를 업데이트하세요.
파일 위치 확인 및 백업
사용자 지정 CODEX_HOME이 설정되어 있으면 해당 디렉터리의 config.toml과 auth.json을 편집하세요. 그렇지 않으면 macOS / Linux에서는 ~/.codex, Windows에서는 %USERPROFILE%\.codex를 사용합니다. CLI와 App은 같은 디렉터리를 사용해야 합니다. WSL은 별도의 사용자 디렉터리를 사용합니다.
편집하기 전에 Codex를 완전히 종료하고 두 파일을 비공개 위치에 백업하세요. 없는 파일은 생성합니다. 기존 설정을 교체하고 키나 테이블을 중복으로 추가하지 마세요. 관련 없는 설정은 유지하세요.
이 설정은 ChatGPT 로그인에서 API Key 인증으로 전환하며 공식 계정 접근 상태를 유지하지 않습니다. auth.json과 백업을 보호하고 공유하거나 저장소에 커밋하지 마세요.
config.toml 편집
model_provider, model, cli_auth_credentials_store를 프로필 안이 아닌 모든 TOML 테이블 앞의 최상위에 배치하세요. 제공업체 ID와 테이블 이름이 일치해야 합니다. 이 파일 인증 방식에서는 선택한 제공업체의 env_key와 experimental_bearer_token을 제거하세요.
예제는 GPT-6 Astra(gpt-6-astra)를 사용합니다. 다른 모델은 모델 광장에서 전체 ID를 복사해 model을 바꾸세요. GPT, Kimi, GLM은 같은 파일 인증 구조를 사용하며 자동 설정은 GPT에서 사용할 수 있습니다.
auth.json 편집
auth.json은 config.toml과 같은 디렉터리에 있습니다. auth.json이 없으면 해당 디렉터리에 새로 만드세요. 파일 내용을 다음 JSON으로 설정하고, YOUR_API_KEY를 자신의 BetterToken API Key로 바꾼 다음 저장하세요.
재시작 및 확인
두 파일을 저장한 뒤 터미널에서 새 Codex CLI 세션을 바로 시작하세요.
백그라운드 프로세스를 포함해 Codex App을 완전히 종료한 다음 다시 열고 새 로컬 작업을 만드세요. 사용하는 각 클라이언트에서 짧은 프롬프트를 보내 정상 응답을 확인하세요.
문제 해결
401, 403 또는 로그인 요청이 표시되면 활성 디렉터리, auth.json의 Key, auth_mode = apikey, cli_auth_credentials_store = file, requires_openai_auth = true를 확인하세요. 제공업체나 모델 오류가 발생하면 제공업체 ID 일치 여부, https://bettertoken.ai/v1, wire_api = responses, 모델 사용 가능 여부를 확인하세요. 변경 사항이 적용되지 않으면 설정 재정의 항목을 확인하고 CLI와 App이 같은 CODEX_HOME을 사용하는지 확인하세요.
관련 가이드
