Codex CLI 白嫖指南：一条命令让 OpenAI Codex 用上 DeepSeek / Claude 任意模型

Codex CLI 很强，但你用不了

OpenAI 的 Codex CLI 是目前最强的终端 AI 编程助手之一——自动读代码、改代码、跑测试、修 bug，全程终端内闭环。

但有个致命门槛：它只认 OpenAI Responses API。

这意味着你必须有 OpenAI API Key，必须用 GPT-4o / o3 等模型，必须承受美区账单。国内开发者？抱歉，没有 API Key 就只能看着。

直到 codex-proxy 出现。

codex-proxy：本地协议翻译器

codex-proxy 做的事很简单——在本地起一个代理，把 Codex CLI 的 Responses API 请求翻译成你的模型服务商能听懂的格式：

• Chat Completions 兼容：DeepSeek、通义千问、Moonshot、Ollama、vLLM、LocalAI……
• Anthropic Messages 兼容：Claude、百川等

一行命令装好，两个环境变量配好，任何模型都能驱动 Codex CLI。

Codex CLI  →  /v1/responses  →  codex-proxy  →  /v1/chat/completions  →  DeepSeek / Claude / ...

2 分钟上手

1. 安装

npm install -g @lininn/codex-proxy

2. 配置 Provider

codex-proxy --web

浏览器自动打开配置页面，填写三样东西：

保存，重启代理。Web 页面支持暗色模式，API Key 脱敏显示，配置存在本地 ~/.codexproxy/config.json，不上传任何数据。

3. 启动代理 + 连接 Codex CLI

# 启动代理（后台运行）
codex-proxy start

# 让 Codex CLI 指向本地代理
export OPENAI_BASE_URL=http://127.0.0.1:8080/v1
export OPENAI_API_KEY=local-placeholder

# 启动 Codex CLI
codex

搞定。现在 Codex CLI 的每一个请求都走你的模型。

爆火场景

场景一：用 DeepSeek 驱动 Codex CLI，成本降 90%

DeepSeek API 定价约为 GPT-4o 的 1/10。配置如下：

{
  "port": 8080,
  "defaultProvider": "deepseek",
  "providers": [
    {
      "providerType": "chat",
      "name": "deepseek",
      "baseUrl": "https://api.deepseek.com/v1",
      "apiKey": "YOUR_DEEPSEEK_KEY",
      "defaultModel": "deepseek-chat"
    }
  ]
}

效果：Codex CLI 全功能可用——自动编程、文件操作、命令执行——每月 API 费用可能不到一杯咖啡。

场景二：用 Claude 驱动 Codex CLI

Claude 的代码能力与 GPT-4o 不相上下，某些场景甚至更优：

{
  "providerType": "anthropic",
  "name": "claude",
  "baseUrl": "https://api.anthropic.com/v1",
  "apiKey": "YOUR_ANTHROPIC_KEY",
  "defaultModel": "claude-sonnet-4-5"
}

codex-proxy 会自动把 Responses 协议翻译成 Anthropic Messages 协议，包括流式输出和 Tool Use。

场景三：本地模型，零成本

用 Ollama / vLLM 跑本地模型，完全离线：

{
  "providerType": "chat",
  "name": "ollama",
  "baseUrl": "http://127.0.0.1:11434/v1",
  "apiKey": "ollama",
  "defaultModel": "qwen2.5-coder:32b"
}

零 API 费用，零数据外泄。企业内网场景的理想选择。

场景四：多 Provider 自由切换

配置多个 Provider，随时在 Web 页面一键切换：

{
  "providers": [
    { "providerType": "chat", "name": "deepseek", "baseUrl": "https://api.deepseek.com/v1", "apiKey": "sk-xxx", "defaultModel": "deepseek-chat" },
    { "providerType": "anthropic", "name": "claude", "baseUrl": "https://api.anthropic.com/v1", "apiKey": "sk-xxx", "defaultModel": "claude-sonnet-4-5" },
    { "providerType": "chat", "name": "moonshot", "baseUrl": "https://api.moonshot.cn/v1", "apiKey": "sk-xxx", "defaultModel": "moonshot-v1-128k" },
    { "providerType": "chat", "name": "ollama", "baseUrl": "http://127.0.0.1:11434/v1", "apiKey": "ollama", "defaultModel": "qwen2.5-coder:32b" }
  ]
}

写代码用 DeepSeek，复杂架构用 Claude，断网用 Ollama——同一个 Codex CLI，随时切换大脑。

技术亮点

不是简单的请求转发，而是完整的协议翻译：

核心翻译逻辑约 500 行 TypeScript，零外部 AI 依赖，纯粹的字段映射 + 协议转换，稳定可预测。

常用命令速查

codex-proxy start           # 后台启动
codex-proxy start -p 8080   # 指定端口
codex-proxy stop            # 停止
codex-proxy restart         # 重启（重载配置）
codex-proxy --web           # 打开 Web 配置页
codex-proxy config          # 查看配置文件路径

安全说明

• 代理只监听 127.0.0.1，不暴露到外网
• API Key 存在本地 ~/.codexproxy/config.json，不上传任何服务器
• Web 配置页 API Key 脱敏显示
• 可通过 CODEXPROXY_HOME 自定义配置目录

为什么这东西能火？

1. 痛点极强：Codex CLI 只认 OpenAI，国内开发者被挡在门外
2. 解决极简：一条 npm install，两个环境变量，2 分钟搞定
3. 成本极低：DeepSeek 价格是 GPT-4o 的 1/10，甚至可以零成本用本地模型
4. 覆盖极广：Chat Completions + Anthropic Messages 两大协议，覆盖几乎所有主流模型
5. 隐私极好：纯本地代理，Key 不出本机，企业可内网部署

快速开始

# 1. 安装
npm install -g @lininn/codex-proxy

# 2. 配置
codex-proxy --web

# 3. 启动
codex-proxy start

# 4. 使用
export OPENAI_BASE_URL=http://127.0.0.1:8080/v1
export OPENAI_API_KEY=local-placeholder
codex

GitHub: lininn/codex-proxy npm: @lininn/codex-proxy

如果你也在用 Codex CLI 但被 OpenAI API 限制住了，codex-proxy 就是那把钥匙。Star 一下，让更多人看到。