AI 编程助手Codex + DeepSeek接入详细指南

为什么要用 Codex.app？

先说说为什么选 Codex.app 这个工具。它是 OpenAI 出品的 AI 编程助手，对标的是 Cursor 和 Claude Code。选它，理由很直白：

• 原生 Responses API
  — 不依赖 Chat Completions，工具调用和推理链路更稳定，少了很多莫名奇妙的兼容问题。

• MCP + 插件体系
  — 内置了文件系统、浏览器、文档、电子表格这些能力，生态开放，想接什么自己说了算。

• 本地优先
  — 所有配置都放在 ~/.codex/config.toml 里，一份配置就能切换任何兼容模型，省心。

一句话总结：

原理

问题是，DeepSeek 并不直接兼容 OpenAI 的 Responses API。怎么办？Moon Bridge 就干一件事：在本地启动一个袋里，自动做协议翻译。通信链路是这样的：

Codex.app → 127.0.0.1:38440 → Moon Bridge → api.deepseek.com → DeepSeek

简单说，你在 Codex 里发请求，它以为是 OpenAI 的接口，实际上被 Moon Bridge 悄悄转成了 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

第二步：写配置文件

在 moon-bridge/ 目录下新建一个 config.yml。

，其他保持默认：

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"   # ← 改成你的 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，

，不需要你额外操作什么。

在终端里验证一下：

cd /任意项目目录
CODEX_HOME="$HOME/.codex" codex --cd "$PWD"
# 问一句 "你好，介绍一下你自己" 确认模型正常响应

日常使用

每次开机后，先启动 Moon Bridge：

moonbridge --config /你的路径/moon-bridge/config.yml &

然后正常打开 Codex.app 就好。如果想让它开机自启，可以把这个命令加到 ~/.zshrc，或者用 launchctl 做一个守护进程。

快速排障

现象	检查什么
connection refused	moonbridge 进程没启动，或者端口不是 38440
401	config.yml 里的 api_key 填错了
Codex 里看不到模型	~/.codex/config.toml 没有正确生成，重新跑第三步
重启 Mac 后 moonbridge 找不到	二进制放在 /tmp 里被清了，用 go build -o /usr/local/bin/moonbridge 装到系统路径下

总结

整个配置链下来，其实就是三步：编译个袋里 → 写个配置文件 → 生成 Codex 配置。搞定之后，Codex.app 就能用上 DeepSeek 的模型了，体验非常接近原生 OpenAI。试试看，有问题对照排障表排查就行。