CometAPI와 함께 Codex 사용하기

이 가이드를 사용해 Codex를 CometAPI를 model provider로 사용하여 실행하세요. 공식 참고 자료:

사전 요구 사항

Requirement	Details
OS	macOS, Linux, Windows 기본 PowerShell 또는 WSL이 설치된 Windows
Git	2.23+ 권장
Codex	Codex quickstart에서 Codex 앱 또는 Codex CLI를 설치하세요
CometAPI API key	CometAPI dashboard에서 발급받으세요
Model ID	Models page의 model ID를 사용하세요

설정 경로 선택하기

Codex를 빠르게 구성할 수 있도록 두 가지 옵션을 제공합니다.

옵션 1: Codex 수동 구성(권장)

사용자 수준 ~/.codex/config.toml 파일을 직접 수정합니다. 특히 Windows 및 WSL 사용자에게 가장 안정적인 방법입니다.

옵션 2: 스크립트로 구성

바로 가기 방식으로 설정 스크립트를 실행합니다. 동일한 provider 구성을 기록하고 Codex용 CometAPI API key를 저장합니다.

Codex 수동 구성

Codex는 사용자 수준 ~/.codex/config.toml 파일에서 개인 provider 기본값을 읽습니다. CometAPI provider는 프로젝트 .codex/config.toml 파일이 아니라 그곳에 구성하세요. Codex는 프로젝트 config 파일의 provider 및 provider-auth 설정을 무시합니다. 권장 설정은 이름이 지정된 cometapi provider와 명령 기반 인증을 사용합니다. 이렇게 하면 CometAPI를 내장 OpenAI provider와 분리할 수 있고, 셸 환경 상속이 필요하지 않으며, ~/.codex/auth.json도 대체하지 않습니다.

macOS / Linux / WSL
Windows PowerShell

CometAPI API 키를 로컬 키 파일에 저장합니다:

mkdir -p "$HOME/.codex"
printf "%s\n" "$COMETAPI_KEY" > "$HOME/.codex/cometapi_key"
chmod 600 "$HOME/.codex/cometapi_key"

~/.codex/config.toml에 다음 구성을 추가합니다:

model_provider = "cometapi"
model = "your-model-id"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
wire_api = "responses"

[model_providers.cometapi.auth]
command = "sh"
args = ["-c", "cat \"$HOME/.codex/cometapi_key\""]

CometAPI API 키를 Windows Codex 홈 디렉터리에 저장합니다:

New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
Set-Content -NoNewline -Path "$HOME\.codex\cometapi_key" -Value $env:COMETAPI_KEY

$HOME\.codex\config.toml에 다음 구성을 추가합니다:

model_provider = "cometapi"
model = "your-model-id"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
wire_api = "responses"

[model_providers.cometapi.auth]
command = "powershell.exe"
args = [
  "-NoProfile",
  "-Command",
  "$p=Join-Path $HOME '.codex/cometapi_key'; (Get-Content -Raw $p).Trim()",
]

Windows 네이티브 Codex는 $HOME\.codex를 사용하며, 일반적으로 C:\Users\<user>\.codex입니다. WSL은 Linux 배포판의 ~/.codex를 사용합니다. Codex agent가 실행되는 환경에 맞는 디렉터리를 수정하세요.

환경 변수 인증 사용

CometAPI API 키를 환경 변수에 유지하려면 [model_providers.cometapi.auth] 블록 대신 env_key를 사용하세요. Codex를 실행하는 환경에서 COMETAPI_KEY를 사용할 수 있을 때만 이 provider 구성을 사용하세요:

model_provider = "cometapi"
model = "your-model-id"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
wire_api = "responses"
env_key = "COMETAPI_KEY"

env_key를 [model_providers.cometapi.auth]와 함께 사용하지 마세요. Codex는 custom provider당 하나의 인증 방법만 지원합니다.

설정 스크립트 실행

설정 스크립트는 선택 사항입니다. 이 스크립트는 동일한 cometapi provider 구성을 ~/.codex/config.toml에 작성하고, CometAPI API 키를 ~/.codex/cometapi_key에 저장하며, 파일 변경 전에 백업을 생성하고, Codex CLI를 사용할 수 있을 때 codex exec로 구성을 검증합니다. macOS, Linux 또는 WSL의 경우, 대화형 설치 프로그램을 실행하세요:

sh -c "$(curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh)"

비대화형 설정의 경우, API 키를 명시적으로 전달하세요:

curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh | sh -s -- --key "$COMETAPI_KEY"

Windows 네이티브 PowerShell의 경우, 대화형 설치 프로그램을 실행하세요:

powershell -c "irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1' | iex"

비대화형 Windows 설정의 경우, API 키를 명시적으로 전달하세요:

powershell -c "& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1'))) -Key $env:COMETAPI_KEY"

기본적으로 이 스크립트는 ~/.codex/auth.json을 대체하지 않으며 ChatGPT 로그인을 제거하지도 않습니다. 스크립트가 auth.json을 통해 Codex API 키 로그인을 관리하도록 하려는 경우에만 --force-auth-json 또는 -ForceAuthJson을 사용하세요.

model ID 선택 또는 변경

Models 페이지의 model ID를 사용하세요. 수동 구성에서는 ~/.codex/config.toml의 model 값을 변경하세요. macOS, Linux 또는 WSL의 경우, 설정 스크립트를 실행할 때 --model을 전달하세요:

curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh | sh -s -- --key "$COMETAPI_KEY" --model your-model-id

Windows 네이티브 PowerShell의 경우, 설정 스크립트를 실행할 때 -Model을 전달하세요:

powershell -c "& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1'))) -Key $env:COMETAPI_KEY -Model 'your-model-id'"

스크립트는 설정되어 있으면 CODEX_HOME을 사용합니다. 그렇지 않으면 현재 환경의 ~/.codex에 작성합니다.

설정 검증

Codex CLI로 설정을 검증하려면, 아무 로컬 프로젝트에서나 다음 읽기 전용 명령을 실행하세요:

codex exec --ephemeral --skip-git-repo-check --sandbox read-only --color never "Reply exactly with: COMETAPI_CODEX_OK"

Codex CLI를 PATH에서 사용할 수 없다면, Codex 앱을 열고 로컬 프로젝트에서 짧은 프롬프트를 보내세요.

문제 해결

Codex가 여전히 기본 OpenAI provider를 사용합니다

사용자 수준 ~/.codex/config.toml 파일에 model_provider = "cometapi"가 있는지 확인하세요.

API 키가 변경되었습니다

~/.codex/cometapi_key를 업데이트하거나, 업데이트된 $COMETAPI_KEY 값으로 설정 스크립트를 다시 실행하세요.

PowerShell 스크립트가 사전 점검 중 실패합니다

수동 Windows 네이티브 PowerShell 단계를 사용한 다음, 검증 명령을 실행하세요.

파이프된 shell 설정에서 API 키를 묻지 않습니다

--key "$COMETAPI_KEY"를 사용하거나, COMETAPI_KEY를 설정하거나, 대화형 sh -c "$(curl ...)" 명령을 실행하세요.

연결 시간이 초과되거나 잘못된 base URL을 사용합니다

~/.codex/config.toml에서 base_url이 https://api.cometapi.com/v1인지 확인하세요.

모델을 찾을 수 없습니다

사용 가능한 model ID는 Models 페이지에서 확인하세요.

Windows 설정이 잘못된 환경에 영향을 줍니다

Windows 네이티브 모드에서는 $HOME\.codex를 편집하고, WSL 에이전트 모드에서는 WSL 내부의 ~/.codex를 편집하세요.

ChatGPT 로그인이 변경되었습니다

API 키 로그인 모드를 원하지 않는 한 --force-auth-json 또는 -ForceAuthJson을 사용하지 마세요.

개요

AI 코딩 에이전트

AI 에이전트

AI 채팅 클라이언트

번역 및 언어

자동화 플랫폼

관측성 및 평가

AI 프레임워크

사전 요구 사항

설정 경로 선택하기

옵션 1: Codex 수동 구성(권장)

옵션 2: 스크립트로 구성

Codex 수동 구성

환경 변수 인증 사용

설정 스크립트 실행

model ID 선택 또는 변경

설정 검증

문제 해결

​사전 요구 사항

​설정 경로 선택하기

옵션 1: Codex 수동 구성(권장)

옵션 2: 스크립트로 구성

​Codex 수동 구성

​환경 변수 인증 사용

​설정 스크립트 실행

​model ID 선택 또는 변경

​설정 검증

​문제 해결

사전 요구 사항

설정 경로 선택하기

Codex 수동 구성

환경 변수 인증 사용

설정 스크립트 실행

model ID 선택 또는 변경

설정 검증

문제 해결