UberLLM과 함께하는 Codex CLI: OpenAI의 코딩 에이전트를 모든 모델에서 실행하세요.

단계

1. 키 페이지에서 키를 만들고 크레딧을 추가하세요.
2. 아직 Codex를 설치하지 않았다면 설치하세요: npm install -g @openai/codex.
3. 셸 프로필 (~/.zshrc 또는 ~/.bashrc)에 키를 넣고 새 터미널을 여세요:

export UBERLLM_API_KEY="ull_..."

4. ~/.codex/config.toml를 여세요 (없으면 만드세요) 그리고 추가하세요:

model = "moonshotai/kimi-k3"
model_provider = "uberllm"
web_search = "disabled"

[model_providers.uberllm]
name = "UberLLM"
base_url = "https://api.uberllm.dev/v1"
env_key = "UBERLLM_API_KEY"
wire_api = "responses"

5. 프로젝트 폴더에서 codex를 실행하고 작업을 부여하세요.

/v1로 끝나는 base_url를 유지하세요: Codex가 /responses를 추가합니다. env_key은 변수 이름이며, 키 자체가 아닙니다.

모델 전환

한 세션 동안 -m을(를) 전달하거나, 예를 들어 작은 수정에는 codex -m deepseek/deepseek-v4.1-flash를(을) 사용하거나, 파일에서 model을(를) 변경하세요. uberllm.dev/models에 있는 모든 채팅 모델 ID가 작동합니다.

스크립트 및 CI의 경우, codex exec는 대화형 화면 없이 하나의 작업을 실행합니다:

codex exec --skip-git-repo-check "add a docstring to every function in utils.py"

추가할 만한 설정

• model_context_window: Codex는 OpenAI 목록 외 모델의 컨텍스트 크기를 알지 못하며 272,000 토큰으로 가정합니다. 더 작은 모델의 경우, uberllm.dev/models](uberllm.dev/models](/models)) 페이지에서 해당 숫자를 설정하세요 (예: model_context_window = 131072). 그러면 Codex가 대화 공간이 부족해지기 전에 대화를 압축합니다.
• model_reasoning_effort: "low", "medium" 또는 "high"는 사고하는 모델(DeepSeek, Kimi Thinking, GLM, GPT-5)에 전달됩니다. 모델의 기본값을 사용하려면 생략하세요.
• web_search = "disabled": Codex의 웹 검색은 OpenAI 자체 서버에서 실행되므로 다른 공급자를 통해 실행될 수 없습니다. 이것을 끄면, 모델은 사용할 수 없는 도구를 제공받지 않습니다.

작동하는 것

모든 Codex 도구는 API 측면에서 보면 일반적인 함수 호출입니다. 따라서 Codex에 추가하는 명령어 실행, 파일 편집, 계획 및 MCP 서버는 모두 도구 호출을 지원하는 모든 모델에서 작동합니다. Codex는 매 턴마다 전체 대화를 보냅니다 (store = false). 따라서 호출 사이에 UberLLM에 아무것도 저장되지 않습니다. 각 호출은 대시보드 → 활동에서 앱 이름 codex 아래에 비용과 함께 표시됩니다.

문제 해결

• wire_api = "chat"은 더 이상 지원되지 않습니다: Codex 0.95 이상 버전은 Responses API만 지원합니다. wire_api = "responses"을 설정하세요.
• 401 또는 "환경 변수 누락: UBERLLM_API_KEY": Codex가 실행되는 터미널에 변수가 내보내지지 않았습니다. 프로필을 편집한 후 새 터미널을 열거나, 먼저 export UBERLLM_API_KEY=...를 실행하세요.
• 매 턴마다 404: base_url에 /v1가 없습니다. 정확히 https://api.uberllm.dev/v1여야 합니다.
• "…에 대한 모델 메타데이터를 찾을 수 없습니다. 대체 메타데이터로 기본 설정합니다": Codex는 OpenAI 자체 목록 외의 모든 모델에 대해 이 메시지를 출력합니다. 해롭지 않습니다. 위와 같이 model_context_window을 설정하세요.
• 모델이 응답하지만 명령을 실행하지 않습니다: 첫 번째 표에서 모델을 선택하세요. 작은 모델은 Codex의 도구 형식을 벗어나는 경향이 있습니다.
• 402 크레딧 부족: 크레딧 페이지에서 크레딧을 추가하세요. 엄격한 상한선을 위해 키에 지출 한도를 설정하세요.

계속 읽기

• Codex 문서 · Responses API 참조
• OpenCode 설정 · Cline 설정