AI 编程助手 Codex 与 DeepSeek 接入详细指南
Codex.app作为AI编程助手，原生支持Responses API与MCP插件体系，通过Moon Bridge协议翻译层可顺畅对接DeepSeek模型。下文将说明其优势、配置链路与日常使用方法。
为什么要用 Codex.app？
OpenAI推出的Codex.app是一款AI编程工具，与Cursor和Claude Code形成竞争格局。选择它的主要理由包括：
- 原生 Responses API — 不依赖传统Chat Completions，工具调用与推理链路的稳定性更优。
- MCP与插件体系 — 系统预置文件管理、浏览器控制、文档编辑及电子表格等多重能力，构建开放生态。
- 本地优先 — 通过修改
~/.codex/config.toml单一配置文件，即可切换任意兼容模型。
概括而言：它结合了Cursor的易用性、Claude Code的可配置性以及开放的模型接入能力。
原理
DeepSeek并未直接兼容OpenAI的Responses API。Moon Bridge作为本地代理，能够自动完成协议翻译，使通信链路变为：
Codex.app → 127.0.0.1:38440 → Moon Bridge → api.deepseek.com → DeepSeek
前置依赖
首先安装三项工具：
# 1. Go 1.25+ brew install go # 2. Node.js 18+（通常已有） node --version # 3. Codex CLI（配置链路要用） npm install -g @openai/codex
快速配置（3 步）
第一步：克隆并编译 Moon Bridge
git clone https://github.com/ZhiYi-R/moon-bridge.git cd moon-bridge git reset --hard 4dd578afb25a5389c3f658390ac49a6190efcf52 go build -o /usr/local/bin/moonbridge ./cmd/moonbridge
第二步：编写配置文件
在项目目录内创建config.yml，仅需修改API密钥一项：
mode: "Transform"
server:
addr: "127.0.0.1:38440"
models:
deepseek-chat:
context_window: 128000
max_output_tokens: 8192
providers:
deepseek:
base_url: "https://api.deepseek.com/anthropic"
api_key: "sk-你的DeepSeek-API-Key" # ← 更改此处为你自己的密钥
offers:
- model: deepseek-chat
routes:
moonbridge:
model: deepseek-chat
provider: deepseek
第三步：生成Codex配置并启动
# 在后台启动Moon Bridge moonbridge --config config.yml & # 等待2秒确认启动完成 sleep 2 # 生成Codex的配置文件 moonbridge --config config.yml --print-codex-config moonbridge --codex-base-url "http://127.0.0.1:38440/v1" --codex-home "$HOME/.codex" > "$HOME/.codex/config.toml" # 验证连接 curl -s http://127.0.0.1:38440/v1/models
当返回内容中出现"moonbridge"字样时，表示通道已建立。
打开 Codex.app 直接使用
配置写入至~/.codex/config.toml后，Codex.app启动时自动读取并应用，无需进行额外干预。
通过终端验证功能：
cd /任意项目目录 CODEX_HOME="$HOME/.codex" codex --cd "$PWD" # 输入 "你好，介绍一下你自己" 来确认模型正常响应
日常使用
每次开机后需首先启动Moon Bridge：
moonbridge --config /你的路径/moon-bridge/config.yml &
随后正常打开Codex.app即可使用。
如需开机自启，可将上述命令添加至
~/.zshrc，或通过launchctl创建守护进程。
快速排障
| 表现 | 排查方向 |
|---|---|
connection refused | 检查Moon Bridge进程是否运行，以及端口是否确为38440 |
401 | 核对配置文件中api_key是否正确 |
| Codex内无可选模型 | 确认~/.codex/config.toml已正确生成，并重新执行第三步 |
| Mac重启后无法找到Moon Bridge | 因二进制文件存放于/tmp可能被系统清除，建议使用go build -o /usr/local/bin/moonbridge将其安装到持久位置 |
总结
本文详细阐述了Codex.app通过Moon Bridge桥接工具对接DeepSeek模型的完整流程，涵盖核心原理、环境依赖、三步配置方法、日常使用规范以及常见问题排查策略。借助这一链路，开发者能够高效结合两套系统的优势，实现稳定且灵活的AI编程辅助。