Skip to main content
Codex CLI와 Codex App은 로컬 작업에 config.toml과 auth.json을 함께 사용합니다. 이 설정은 OpenAI Responses를 통해 BetterToken API Key를 사용합니다.

​
주요 설정

​
준비 사항

​
설치하기

​
파일 위치 확인 및 백업

사용자 지정 CODEX_HOME이 설정되어 있으면 해당 디렉터리의 config.toml과 auth.json을 편집하세요. 그렇지 않으면 macOS / Linux에서는 ~/.codex, Windows에서는 %USERPROFILE%\.codex를 사용합니다. CLI와 App은 같은 디렉터리를 사용해야 합니다. WSL은 별도의 사용자 디렉터리를 사용합니다. 편집하기 전에 Codex를 완전히 종료하고 두 파일을 비공개 위치에 백업하세요. 없는 파일은 생성합니다. 기존 설정을 교체하고 키나 테이블을 중복으로 추가하지 마세요. 관련 없는 설정은 유지하세요.
이 설정은 ChatGPT 로그인에서 API Key 인증으로 전환하며 공식 계정 접근 상태를 유지하지 않습니다. auth.json과 백업을 보호하고 공유하거나 저장소에 커밋하지 마세요.

​
명령줄 설정

BetterToken 자동 설정 스크립트는 Codex 제공자 설정을 작성합니다. Node.js가 필요하며 API Key 또는 Model ID를 인수로 전달하지 않으면 직접 입력하라는 메시지가 표시됩니다.
설치 후 두 파일을 아래 수동 설정과 비교하고 차이가 있으면 수정한 뒤 Codex를 시작하세요.

​
수동 설정

​
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을 완전히 종료한 다음 다시 열고 새 로컬 작업을 만드세요. 사용하는 각 클라이언트에서 짧은 프롬프트를 보내 정상 응답을 확인하세요.

​
모델 전환

model을 변경하고 필요하면 review_model도 변경하세요. 파일을 저장하고 현재 Codex 프로세스를 종료한 뒤 다시 시작하세요. 설정 대화 상자 또는 모델 광장의 Model ID를 사용하세요.

​
흔한 오류

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을 사용하는지 확인하세요.

​
고급 설정

​
지원 Provider

표시된 상태는 이 페이지에서 설명하는 BetterToken 설정 방식에 적용됩니다.
  • 명령줄 + 수동 설정: 생성된 명령을 사용하거나 전체 수동 단계를 따르세요.
  • 수동 설정: API Key, Base URL, Model을 입력하세요.
  • 지원되지 않음: 검증된 직접 연결 방식이 아직 없습니다.

​
Codex 확장 프로그램

Codex VS Code 확장 프로그램은 config.toml을 공유하지만 공식 로그인을 유지하려면 다른 인증 설정이 필요합니다. Codex 확장 프로그램 설정 가이드를 참고하세요.

​
관련 FAQ

​
공식 레퍼런스

​
기술 세부 정보

Codex는 OpenAI Responses를 사용합니다. base_url을 https://bettertoken.ai/v1로 설정하고 wire_api = "responses"를 유지하세요. Codex가 /responses를 추가합니다.