CometAPI와 함께 Codex 사용하기

Codex를 CometAPI에 연결하려면 Codex를 설치하고 에서 API 키를 받으세요 CometAPI 대시보드.

빠른 시작: 두 파일 수정

연결을 위해 config.toml을 수정하고 API 키를 위해 auth.json을 수정하세요. 사용자 홈 디렉터리의 .codex 폴더를 사용하세요. 폴더나 파일이 없으면 만드세요.

config.toml 구성

~/.codex/config.toml에서 다음 연결 설정을 추가하거나 업데이트하세요:

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

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

your-model-id을 모델 페이지의 모델 ID로 바꾸세요. 모든 model_provider 헤더보다 위에 model 및 [section]을 유지하세요.다른 설정은 유지하고, 중복 항목을 추가하는 대신 일치하는 항목을 업데이트하세요. 이 방법에서는 requires_openai_auth = true을 유지하세요. 방법을 전환하는 경우 env_key 및 [model_providers.cometapi.auth]을 제거하세요.

auth.json 구성

이 방법은 Codex를 API 키 로그인으로 전환합니다. ~/.codex/auth.json이 존재하면 내용을 교체하기 전에 파일을 백업하세요:

{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "<COMETAPI_KEY>"
}

<COMETAPI_KEY>을 CometAPI API 키로 바꾸세요. 필드 이름 OPENAI_API_KEY은 변경하지 마세요.

두 파일을 저장하고 Codex를 다시 시작한 다음, 짧은 메시지를 보내 시작하세요.

Codex 구성 디렉터리 찾기

macOS: Finder에서 다음을 누르세요 Command + Shift + G 을 입력하세요: ~/.codex.
Linux: 사용자 홈 디렉터리에서 .codex을 여세요. ~의 ~/.codex은 홈 디렉터리를 가리킵니다.
Windows 네이티브: 파일 탐색기에서 %USERPROFILE%\.codex을 입력하세요. 일반적으로 C:\Users\<user>\.codex입니다.
WSL: Codex가 실행되는 Linux 배포판 내에서 ~/.codex을 사용하세요.

CODEX_HOME을 설정한 경우 두 파일 모두에 해당 디렉터리를 사용하세요. 프로젝트의 .codex/config.toml 대신 사용자 수준 파일을 구성하세요.

구성 방법 비교

방법	API 키 위치	ChatGPT 로그인
두 파일 빠른 시작	`~/.codex/auth.json`	API 키 로그인으로 전환
권장 구성	`~/.codex/cometapi_key`	저장된 ChatGPT 로그인을 변경하지 않음

ChatGPT 로그인을 유지하려면 아래의 권장 구성을 사용하세요.

권장 구성

다음은 권장 구성입니다. CometAPI API key를 별도 파일에 저장하고 명령으로 API key를 읽습니다. ~/.codex/auth.json은 변경하지 않습니다.

이 방법에서는 requires_openai_auth 및 env_key을 [model_providers.cometapi]에서 제거하세요. 이러한 필드를 [model_providers.cometapi.auth]와 함께 사용하지 마세요.이전에 빠른 시작을 사용했고 ChatGPT 로그인을 복원하려는 경우, auth.json 백업을 복원하거나 ChatGPT로 다시 로그인하세요.

macOS / Linux / WSL
Windows PowerShell

<COMETAPI_KEY>을 CometAPI API key로 바꾸고 API key를 로컬 파일에 저장하세요:

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

~/.codex/config.toml에 이 구성을 추가하거나 업데이트하세요. your-model-id를 모델 ID로 바꾸세요:

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

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

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

<COMETAPI_KEY>을 CometAPI API key로 바꾸고 API key를 Windows Codex 홈 디렉터리에 저장하세요:

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

$HOME\.codex\config.toml에 이 구성을 추가하거나 업데이트하세요. your-model-id를 모델 ID로 바꾸세요:

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

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

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

환경 변수 인증 사용

CometAPI API key를 환경 변수에 유지하려면 env_key 대신 [model_providers.cometapi.auth] 블록을 사용하세요. Codex를 실행하는 환경에서 COMETAPI_KEY를 CometAPI API key로 설정하세요. 이 구성을 사용하고 your-model-id을 모델 ID로 바꾸세요:

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

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

requires_openai_auth 및 [model_providers.cometapi.auth]은 env_key을 사용할 때 제거하세요.

설정 스크립트 실행

선택 사항인 설정 스크립트는 권장 명령 인증을 적용합니다. ~/.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)"

비대화형 설정의 경우 <COMETAPI_KEY>을(를) 교체하고 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 설정의 경우 <COMETAPI_KEY>을(를) 교체하고 API 키를 명시적으로 전달하세요:

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

기본적으로 스크립트는 ~/.codex/auth.json을(를) 변경하지 않습니다. --force-auth-json 또는 -ForceAuthJson을(를) 사용하여 빠른 시작의 API 키 로그인 방식을 선택하세요. 이 옵션은 명령 인증 대신 auth.json에 기록하고 requires_openai_auth = true을(를) 설정합니다.

모델 ID 선택 또는 변경

다음 모델 페이지의 모델 ID를 사용하세요. 수동 구성에서는 model의 값을 ~/.codex/config.toml에서 변경하세요. macOS, Linux 또는 WSL에서는 설정 스크립트를 실행할 때 <COMETAPI_KEY> 및 your-model-id을(를) 교체하세요:

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

Windows 네이티브 PowerShell에서는 설정 스크립트를 실행할 때 <COMETAPI_KEY> 및 your-model-id을(를) 교체하세요:

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

설정된 경우 스크립트는 CODEX_HOME을(를) 사용합니다. 그렇지 않으면 현재 환경의 ~/.codex에 기록합니다.

설정 확인

연결을 확인하기 전에 구성을 저장하고 Codex를 다시 시작하세요. Codex CLI로 설정을 확인하려면 로컬 프로젝트에서 다음 읽기 전용 명령을 실행하세요:

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

PATH에서 Codex CLI를 사용할 수 없는 경우, Codex 앱을 열고 로컬 프로젝트에서 짧은 프롬프트(Prompt)를 전송하세요.

문제 해결

Codex가 여전히 기본 OpenAI 제공업체를 사용합니다

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

API 키가 변경됨

빠른 시작의 경우 OPENAI_API_KEY을 ~/.codex/auth.json에서 업데이트하세요. 권장 구성의 경우 ~/.codex/cometapi_key을 업데이트하세요. 환경 인증의 경우 Codex를 실행하는 환경에서 COMETAPI_KEY을 업데이트하세요. API 키를 변경한 후 Codex를 다시 시작하세요.

인증 설정 충돌

한 가지 인증 방법을 선택하세요. 빠른 시작은 requires_openai_auth = true 및 auth.json을 사용합니다. 명령 인증은 [model_providers.cometapi.auth]을 사용하며 requires_openai_auth 또는 env_key은 사용하지 않습니다. 환경 인증은 다른 두 설정 없이 env_key을 사용합니다.

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

수동 Windows 네이티브 PowerShell 단계를 사용한 후 확인 명령을 실행하세요.

파이프된 셸 설정에서 API 키를 요청하지 않습니다

CometAPI API 키와 함께 --key "<COMETAPI_KEY>"을 전달하거나 다음에서 대화형 설치 관리자를 실행하세요: 설정 스크립트 실행.

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

base_url가 https://api.cometapi.com/v1로 ~/.codex/config.toml에 설정되어 있는지 확인하세요.

모델을 찾을 수 없습니다

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

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

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

ChatGPT 로그인이 변경됨

빠른 시작과 스크립트의 --force-auth-json 또는 -ForceAuthJson 옵션은 API 키 로그인을 선택합니다. ChatGPT 로그인을 다시 사용하려면 auth.json 백업을 복원하거나 ChatGPT로 로그인한 다음, 권장 구성을 사용하세요.

개요

AI 코딩 에이전트

AI 에이전트

AI 채팅 클라이언트

번역 및 언어

자동화 플랫폼

관측성 및 평가

AI 프레임워크

빠른 시작: 두 파일 수정

구성 방법 비교

권장 구성

환경 변수 인증 사용

설정 스크립트 실행

모델 ID 선택 또는 변경

설정 확인

문제 해결

공식 참고 자료

​빠른 시작: 두 파일 수정

​구성 방법 비교

​권장 구성

​환경 변수 인증 사용

​설정 스크립트 실행

​모델 ID 선택 또는 변경

​설정 확인

​문제 해결

​공식 참고 자료

빠른 시작: 두 파일 수정

구성 방법 비교

권장 구성

환경 변수 인증 사용

설정 스크립트 실행

모델 ID 선택 또는 변경

설정 확인

문제 해결

공식 참고 자료