首页 > AI教程 >AI编程助手Codex+DeepSeek接入指南

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

来源：互联网 2026-07-12 06:17:06

通过MoonBridge协议转换工具，将DeepSeek模型接入Codex.app编程助手。配置步骤：安装Go、Node.js和CodexCLI，克隆并编译MoonBridge，修改config.yml填入DeepSeekAPI密钥，生成Codex配置文件并启动服务，即可在Codex中使用DeepSeek模型。

为什么要用 Codex.app？

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

原生 Responses API — 不依赖 Chat Completions，工具调用和推理链路更稳定，少了很多莫名奇妙的兼容问题。
MCP + 插件体系 — 内置了文件系统、浏览器、文档、电子表格这些能力，生态开放，想接什么自己说了算。
本地优先 — 所有配置都放在 ~/.codex/config.toml 里，一份配置就能切换任何兼容模型，省心。

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

长期稳定更新的攒劲资源： >>>点此立即查看<<<

一句话总结：它既有 Cursor 的体验，又有 Claude Code 的可配置性，还保留了开放的模型接入能力。

原理

问题是，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。只改 api_key 那一行就行，其他保持默认：

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，Codex.app 启动时自动读取，不需要你额外操作什么。

在终端里验证一下：

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` 装到系统路径下