折腾一下 Codex 接上 DeepSeek 了：CLI 和 App 都能用。Moon Bridge 转发层，13 步配置完成。

背景

最近有好几个朋友都问 Codex 怎么使用 DeepSeek 模型。

关键变化：OpenAI 接口从 Chat Completions API 演进到了 Responses API。像 Codex 这类 AI 编程 Agent，本质上已经不是简单的"发一句话、回一段文本"，而是需要读项目、调用工具、生成补丁、执行命令、处理多轮状态。

接入 DeepSeek 的关键点：不只是"换一个模型地址"，而是要让 DeepSeek 能够接住 Codex 发出的 Responses API 风格请求。

Moon Bridge 做的，正是这一层适配和转发。

完整架构

Codex CLI / codex.app
        ↓
读取同一份 Codex 配置
        ↓
请求本地 Moon Bridge
        ↓
Moon Bridge 转发到 DeepSeek V4 Pro

为什么需要 Moon Bridge

问题	原因
Codex	按 OpenAI Responses API 和模型通信
DeepSeek	不直接支持 Responses API
Moon Bridge	本地转发层，适配两种 API

Moon Bridge 的作用：

Codex 以为自己在调用 OpenAI Responses API 兼容服务
        ↓
实际请求先打到本地 Moon Bridge
        ↓
Moon Bridge 转发到 DeepSeek

完整配置流程

Step 1：获取 DeepSeek API Key

步骤	操作
1	访问 https://platform.deepseek.com
2	注册并登录
3	进入 API Keys 页面
4	创建新的 API Key
5	复制并保存

Step 2：克隆 Moon Bridge

git clone https://github.com/your-repo/moon-bridge.git
cd moon-bridge

Step 3：安装依赖

# Python 环境
python3 -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 安装依赖
pip install -r requirements.txt

Step 4：配置 DeepSeek

# 复制配置模板
cp config.example.yaml config.yaml

# 编辑配置
# 填入 DeepSeek API Key

Step 5：启动 Moon Bridge

# 启动服务
python moon_bridge.py

# 默认端口 8080
# 服务地址 http://localhost:8080

Step 6：验证 Moon Bridge

# 测试接口
curl http://localhost:8080/health

# 返回 {"status": "ok"} 表示正常

Step 7：配置 Codex

平台	配置文件位置
macOS	~/.codex/config.json
Windows	%USERPROFILE%\.codex\config.json
Linux	~/.codex/config.json

Step 8：创建 Codex 配置

# 创建配置目录
mkdir -p ~/.codex

# 创建配置文件
cat > ~/.codex/config.json << 'EOF'
{
  "api_base": "http://localhost:8080/v1",
  "model": "deepseek-chat-v4-pro",
  "api_key": "dummy"
}
EOF

Step 9：安装 Codex CLI

# macOS / Linux
brew install openai-codex

# Windows
# 下载安装包

Step 10：启动 Codex

# Codex CLI
codex

# Codex App
# 下载 codex.app 并安装

Step 11：App 端配置

步骤	操作
1	下载 codex.app
2	安装并启动
3	选择"使用 ChatGPT 继续"登录
4	App 会读取 ~/.codex/config.json
5	自动使用 Moon Bridge 配置

Step 12：验证连接

测试	方法
CLI	在 Codex 里输入问题
App	在 codex.app 里输入问题
查看日志	Moon Bridge 终端输出

Step 13：常见问题排查

问题	解决方案
连接超时	检查 Moon Bridge 是否启动
API 报错	检查 DeepSeek API Key
端口被占用	修改 Moon Bridge 端口
App 不生效	重启 App

CLI vs App 对比

维度	Codex CLI	codex.app
界面	终端	桌面应用
配置	手动编辑 JSON	自动读取配置
启动	codex 命令	点击图标
日志	终端输出	图形界面
适合	程序员	小白用户

Moon Bridge 进阶配置

修改端口

# config.yaml
server:
  host: "127.0.0.1"
  port: 8080

多模型切换

# config.yaml
models:
  deepseek:
    name: "deepseek-chat-v4-pro"
    api_key: "your-key"
  openai:
    name: "gpt-4.5"
    api_key: "your-key"

日志配置

# config.yaml
logging:
  level: "INFO"
  file: "moon_bridge.log"

注意事项

事项	说明
API 费用	DeepSeek 按 Token 计费
本地服务	Moon Bridge 必须保持运行
端口占用	8080 端口不能被占用
配置文件	CLI 和 App 共享同一配置

一句话总结

Moon Bridge = Codex 和 DeepSeek 之间的翻译器，让 Codex CLI 和 App 都能用 DeepSeek V4 Pro。

关键：不只是换模型地址，而是用本地转发层适配 Responses API。

13 步配置：获取 API Key → 克隆 Moon Bridge → 配置启动 → 配置 Codex → 验证连接。