메인 콘텐츠로 건너뛰기
이 가이드를 사용해 CometAPI를 model provider로 설정하여 Codex CLI를 실행할 수 있습니다. 공식 참고 자료:
model 사용 가능 여부는 자주 변경됩니다. 아래 예시에서는 your-model-id를 사용합니다 — CometAPI Models page에서 현재 사용 가능한 코딩 친화적인 model ID로 교체하세요.

​
사전 요구 사항

RequirementDetails
OSmacOS 12+, Linux (Ubuntu 20.04+ / Debian 10+), 또는 Windows 11(WSL2 사용)
Node.js22+ (LTS 권장)
Git2.23+ 권장
CometAPI keyCometAPI Dashboard에서 발급받으세요 (sk-로 시작)

​
Codex CLI 설치

npm i -g @openai/codex
또는 Homebrew를 통해 설치할 수 있습니다: 
brew install --cask codex
설치가 완료되었는지 확인하세요: 
codex --version

​
CometAPI 구성

Codex가 CometAPI를 가리키도록 설정하는 방법은 두 가지입니다. 워크플로에 맞는 방법을 선택하세요.
가장 쉬운 방법입니다 — 한 줄만으로 내장 OpenAI provider를 CometAPI로 리디렉션할 수 있습니다. 사용자 지정 provider를 정의할 필요가 없습니다.~/.codex/config.toml 파일을 생성하세요:
model = "your-model-id"
openai_base_url = "https://api.cometapi.com/v1"

​
API 키 저장

~/.codex/auth.json 파일을 생성하세요: 
{
  "OPENAI_API_KEY": "sk-your-cometapi-key"
}
sk-your-cometapi-key를 실제 CometAPI 키로 바꾸세요.
이 파일은 필수입니다. auth.json에 유효한 OPENAI_API_KEY 항목이 없으면, Codex는 API key auth is missing a key 오류와 함께 종료됩니다.

​
Codex 시작

cd your-project
codex
처음 실행하면 Codex가 테마를 선택하고 안전 설정을 확인하도록 안내합니다.

​
세션별로 model 재정의

config.toml을 수정하지 않고 한 번의 실행에 대해서만 다른 model로 전환하려면 다음을 사용하세요: 
codex --model your-model-id

​
대안: 환경 변수

auth.json 대신 키를 직접 export할 수도 있습니다: 
export OPENAI_API_KEY="sk-your-cometapi-key"
codex
이 방법은 현재 터미널 세션에만 키를 설정합니다. 계속 유지하려면 export 줄을 ~/.zshrc 또는 ~/.bashrc에 추가하세요.

​
문제 해결

SymptomFix
API key auth is missing a key~/.codex/auth.json에 "OPENAI_API_KEY": "sk-..."가 포함되어 있는지 확인하세요
로그인 프롬프트가 예상치 않게 표시됨기존의 ~/.codex/auth.json을 삭제하고 CometAPI 키로 다시 생성하세요
model을 찾을 수 없음현재 사용 가능한 model은 Models page에서 확인하세요
연결 시간 초과config.toml에서 openai_base_url 또는 base_url이 https://api.cometapi.com/v1인지 확인하세요
Windows 관련 문제Codex는 Windows에서 WSL2가 필요합니다 — 기본 CMD/PowerShell은 지원되지 않습니다