메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

이 가이드를 사용하면 Codex CLI를 CometAPI를 model provider로 사용해 실행할 수 있습니다. 공식 참고 자료:
Codex는 두 파일이 모두 구성되어 있어야 합니다: ~/.codex/config.toml 및 ~/.codex/auth.json. 이 통합에서는 base-URL-only 설정을 사용하지 마세요.

​
사전 요구 사항

요구 사항세부 정보
OSmacOS 12+, Linux (Ubuntu 20.04+ / Debian 10+), 또는 WSL2를 통한 Windows 11
Node.js22+ (LTS 권장)
Git2.23+ 권장
CometAPI 키CometAPI Dashboard에서 발급받으세요 (sk-로 시작)

​
Codex CLI 설치

npm i -g @openai/codex
또는 Homebrew 사용: 
brew install --cask codex
설치 확인: 
codex --version

​
CometAPI 구성

다음 provider 구성으로 ~/.codex/config.toml을 생성하거나 편집하세요: 
model_provider = "cometapi"
model = "gpt-5.5"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
requires_openai_auth = true
model_provider 및 model 키는 파일의 최상위 레벨에 있어야 합니다. [model_providers.cometapi] 섹션은 CometAPI endpoint를 정의합니다.
dotfiles 저장소를 통해 Codex 설정을 관리하는 경우, dotfiles 사본을 ~/.codex/config.toml과 동기화된 상태로 유지하세요. Codex는 ~/.codex/config.toml에서 파일을 읽습니다.

​
API 키 저장

~/.codex/auth.json을 생성하세요: 
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "sk-your-cometapi-key"
}
sk-your-cometapi-key를 실제 CometAPI 키로 바꾸세요.
이 파일은 필수입니다. auth_mode는 반드시 apikey여야 하며, OPENAI_API_KEY에는 CometAPI 키가 포함되어 있어야 합니다.

​
Codex 시작

cd your-project
codex
처음 실행할 때 Codex는 테마를 선택하고 안전 설정을 확인하라는 메시지를 표시합니다.

​
문제 해결

증상해결 방법
API key auth is missing a key~/.codex/auth.json을 수정하세요. "auth_mode": "apikey" 및 "OPENAI_API_KEY": "sk-..."를 포함해야 합니다
로그인 프롬프트가 예상치 않게 표시됨auth_mode를 apikey로 설정해 ~/.codex/auth.json을 다시 생성한 후 Codex를 재시작하세요
Codex가 계속 기본 OpenAI provider를 사용함~/.codex/config.toml을 수정하세요. model_provider는 반드시 cometapi여야 합니다
요청이 CometAPI에 도달하지 않음~/.codex/config.toml을 수정하세요. [model_providers.cometapi]에 반드시 requires_openai_auth = true가 포함되어야 합니다
연결 시간 초과 또는 잘못된 endpoint~/.codex/config.toml을 수정하세요. base_url은 반드시 https://api.cometapi.com/v1이어야 합니다
모델을 찾을 수 없음사용 가능한 모델은 Models page에서 확인하세요
Windows 문제Codex는 Windows에서 WSL2가 필요합니다 — 기본 CMD/PowerShell은 지원되지 않습니다