Codex

Codex (ChatGPT Desktop) 연결 (Connect Codex in ChatGPT Desktop to LiteLLM)

ChatGPT 데스크톱 앱에서 Codex를 선택하세요. CLI인 Codex와 같은 ~/.codex/config.toml을 읽으므로, 데스크톱과 CLI가 LiteLLM 연결을 공유할 수 있어요.

출처: 문서

본문

이 지침은 Codex의 로컬 모델 제공자와 MCP 서버를 구성해요. 스크린샷은 Linux의 ChatGPT Desktop 26.917.51856을 보여줘요. 메뉴 라벨은 앱 버전에 따라 다를 수 있어요. Codex를 선택하기 전에 앱의 온보딩을 완료하라는 프롬프트가 나오면 완료하세요.

빠른 참조 (Quick reference)

설정	값
콘피그 파일	~/.codex/config.toml (CLI와 공유)
base_url	`<LITELLM_PROXY_BASE_URL>/v1` (예: http://localhost:4000/v1)
제공자 키	LiteLLM 가상 키, `env_key`에 명명된 환경 변수에서 읽음
MCP 엔드포인트	`<LITELLM_PROXY_BASE_URL>/<server_name>/mcp`
MCP 인증	같은 가상 키, `bearer_token_env_var`에 명명된 환경 변수에서 읽음

LLM 설정 (LLM setup)

1. LiteLLM을 모델 제공자로 추가하기

Settings -> Configuration -> Open config.toml을 열거나 ~/.codex/config.toml을 직접 편집하고, 게이트웨이의 Responses API 엔드포인트를 가리키는 provider 블록을 추가하세요. 이는 CLI 설정과 동일해요:

~/.codex/config.toml

model = "claude-sonnet-5"
model_provider = "litellm"

[model_providers.litellm]
name = "LiteLLM"
base_url = "http://localhost:4000/v1"
env_key = "LITELLM_API_KEY"
wire_api = "responses"

claude-sonnet-5를 게이트웨이에 구성된 모델 이름으로 바꾸세요.

데스크톱 앱은 터미널에서 export한 변수를 상속하지 않을 수 있어요. 앱을 실행하기 전에 ~/.codex/.env에 LiteLLM 가상 키를 추가하세요:

~/.codex/.env

LITELLM_API_KEY=sk-1234

데모 키를 가상 키로 바꾸고, 이 파일을 비공개로 유지하며, 변경 후 앱을 재시작하세요. launchctl setenv LITELLM_API_KEY <your-key>를 사용하는 기존 macOS 설정도 그 방식으로 변수를 계속 공급할 수 있어요.

2. ChatGPT Desktop에서 Codex 실행하기

ChatGPT 데스크톱 앱을 열고 모드 전환기에서 Codex를 선택하세요. Codex는 config.toml에서 litellm 제공자를 읽고 게이트웨이 요청에 LITELLM_API_KEY를 사용해요. 새 작업을 시작하세요.

3. 검증 (Verify)

작업을 실행한 다음 Admin UI의 Logs 또는 Usage를 확인하세요. 요청이 가상 키에 귀속되어야 해요.

다른 게이트웨이 모델을 사용하려면 config.toml에서 model을 업데이트하고 새 작업을 시작하세요.

MCP 설정 (MCP setup)

1. 게이트웨이 서버 구성하기

MCP는 같은 ~/.codex/config.toml에서 구성되므로 CLI의 MCP 설정이 그대로 적용돼요. 추가:

~/.codex/config.toml

[mcp_servers.litellm]
url = "http://localhost:4000/my_mcp_server/mcp"
bearer_token_env_var = "LITELLM_API_KEY"

여기서 my_mcp_server는 게이트웨이 콘피그의 mcp_servers: 아래 키와 일치하고 키에 그 서버 액세스가 있어요. LITELLM_API_KEY는 위에서 설명한 대로 앱에서 사용 가능해야 해요. 콘피그나 .env 파일 변경 후 ChatGPT Desktop을 재시작하세요.

캡처된 버전에서는 Settings -> Plugins -> MCPs 아래에서 이 항목을 검사할 수 있어요. Add MCP server 폼도 위에 보이는 URL과 Bearer 토큰 env var를 받아요.

스크린샷은 deepwiki라는 게이트웨이 서버를 사용해요. 등록된 서버 이름으로 대체하세요.

2. 앱에서 연결 검증하기

Settings -> Plugins -> MCPs를 열고 litellm이 활성화됐는지 확인하세요. 일부 버전은 이 목록을 Settings -> MCP servers 아래에 직접 노출해요.

서버의 읽기 전용 도구를 호출하는 작업을 시작하고, 요청되면 승인하고, 결과를 반환하는지 확인하세요.

엔드포인트와 인증 옵션은 MCP configuration reference 참고.

다음 단계 (Next steps)

Codex CLI는 이 콘피그 파일을 공유해요. LiteLLM virtual keys와 MCP gateway reference도 보세요.