30款热门AI模型一站整合DeepSeek/GLM/Claude 随心用限时 5 折。 点击领海量免费额度最近在尝试使用 OpenAI 的 Codex 智能编程助手时发现其官方模型调用成本对于个人开发者或小团队来说确实是一笔不小的开销。有没有一种方法既能享受 Codex 强大的代码生成和对话能力又能大幅降低成本呢答案是肯定的。通过一个名为 Moon Bridge 的转发层我们可以将 Codex 的请求无缝转发到 DeepSeek 的 API从而以极低的成本使用 Codex。本文将手把手带你完成从环境准备、配置、部署到验证的完整流程让你轻松实现 Codex 与 DeepSeek 的零代码接入。本文适合所有对 AI 编程助手感兴趣希望降低使用成本并具备基本命令行操作能力的开发者。无论你是想为个人项目寻找一个高性价比的代码助手还是希望为团队探索更经济的 AI 开发工具方案这篇教程都能提供清晰的指引。接下来我们将从核心概念讲起逐步深入到每一个实操步骤。1. 背景与核心概念在开始动手之前我们有必要先理清几个关键概念理解我们即将搭建的这套系统是如何工作的。1.1 什么是 CodexCodex 是 OpenAI 推出的一款智能编程代理Coding Agent它提供了命令行界面CLI和桌面应用程序两种形态。与传统的代码补全工具不同Codex 被设计成一个可以与你对话、理解项目上下文、并执行复杂编码任务的“AI 结对程序员”。你可以通过自然语言向它描述需求例如“为这个函数添加错误处理”或“写一个 Flask 的登录 API”它便能生成相应的代码片段甚至完整的文件。Codex 的核心优势在于其强大的上下文理解能力和与开发环境的深度集成。然而其官方后端依赖于 OpenAI 的模型使用成本较高且对于国内开发者而言在访问稳定性和速度上也可能面临挑战。1.2 什么是 DeepSeekDeepSeek 是国内深度求索公司推出的一系列高性能大语言模型以其出色的代码能力和极具竞争力的价格受到开发者社区的广泛关注。DeepSeek 提供了开放的 API允许开发者直接调用其模型能力。相较于国际同类服务DeepSeek 在中文理解、本地化支持以及性价比方面具有显著优势。1.3 Moon Bridge 的作用关键的转发层那么如何让原本设计为连接 OpenAI 的 Codex转而使用 DeepSeek 的模型呢这就是Moon Bridge发挥作用的地方。Moon Bridge 是一个开源项目其核心功能是作为一个协议转换与请求转发层。它监听本地的特定端口当 Codex 客户端遵循 OpenAI Responses API 规范发送请求时Moon Bridge 会接收这些请求将其转换为 DeepSeek API 能够理解的格式然后转发给 DeepSeek 的服务器。同样地它也会将 DeepSeek 返回的结果转换回 Codex 客户端期望的格式。你可以把 Moon Bridge 想象成一个“智能适配器”或“翻译官”。Codex 说“OpenAI 方言”DeepSeek 说“DeepSeek 方言”而 Moon Bridge 精通两者确保了它们之间的顺畅沟通。整个架构的流程图如下所示[Codex CLI/App] --(OpenAI Responses API)-- [Moon Bridge (localhost:38440)] --(DeepSeek API)-- [DeepSeek Cloud]通过这种方式我们实现了零代码修改接入。你不需要改动 Codex 客户端的任何一行代码只需要通过配置告诉 Codex 你的“OpenAI 兼容服务”地址是本地运行的 Moon Bridge 即可。2. 环境准备与前置条件在开始配置之前请确保你的开发环境满足以下要求。我们将分别针对 macOS/Linux 和 Windows 系统给出说明。2.1 系统与工具要求Node.js 18: Codex CLI 是基于 Node.js 开发的因此需要先安装 Node.js。你可以访问 Node.js 官网 下载安装包或使用包管理器安装如brew install node在 macOS 上。安装后在终端运行node --version确认版本。Go 1.25: Moon Bridge 是用 Go 语言编写的因此需要 Go 环境来运行它。访问 Go 官网 下载并安装。安装后运行go version确认版本。Git: 用于克隆 Moon Bridge 的代码仓库。通常系统已自带可通过git --version检查。终端Terminal或 PowerShell: 用于执行命令。一个有效的 DeepSeek API Key: 这是调用 DeepSeek 模型的凭证。你需要前往 DeepSeek 开放平台 注册账号并创建 API Key。请妥善保管此 Key。2.2 安装 Codex CLI打开你的终端使用 npmNode.js 的包管理器全局安装 Codex CLInpm install -g openai/codex安装完成后验证是否安装成功codex --version如果安装正确该命令会输出 Codex 的版本号。2.3 获取 DeepSeek API Key访问 DeepSeek 开放平台 。登录你的账户如果没有请先注册。在控制台界面找到“API Keys”或类似的管理页面。点击“创建新的 API Key”为其命名例如“MyCodexIntegration”。创建成功后系统会生成一个以sk-开头的密钥字符串。请立即复制并保存到安全的地方因为关闭页面后可能无法再次查看完整密钥。至此基础环境与凭证准备完毕。接下来我们将进入核心的配置环节。3. 配置 Moon Bridge 转发层Moon Bridge 是我们整个方案的核心枢纽配置它主要分为三个步骤获取源码、编写配置文件、启动服务。3.1 克隆 Moon Bridge 仓库在终端中选择一个你喜欢的目录执行以下命令克隆项目git clone https://github.com/ZhiYi-R/moon-bridge.git cd moon-bridge这会将 Moon Bridge 的源代码下载到当前目录下的moon-bridge文件夹中并进入该目录。3.2 创建并编辑配置文件Moon Bridge 的配置通过一个 YAML 文件config.yml来定义。我们需要创建这个文件并填入必要的参数特别是你的 DeepSeek API Key。在moon-bridge目录下使用你喜欢的文本编辑器如 VSCode、Vim、Nano创建并打开config.yml文件。# 例如使用 nano 编辑器 nano config.yml然后将以下配置内容粘贴进去。请务必将sk-your-deepseek-api-key替换为你刚才获取的真实 API Key。mode: Transform server: addr: 127.0.0.1:38440 models: deepseek-v4-pro: context_window: 1000000 max_output_tokens: 384000 default_reasoning_level: high supported_reasoning_levels: - effort: high description: High reasoning effort - effort: xhigh description: Extra high reasoning effort supports_reasoning_summaries: true default_reasoning_summary: auto extensions: deepseek_v4: enabled: true deepseek-v4-flash: context_window: 1000000 max_output_tokens: 384000 default_reasoning_level: high supported_reasoning_levels: - effort: high description: High reasoning effort - effort: xhigh description: Extra high reasoning effort supports_reasoning_summaries: true default_reasoning_summary: auto extensions: deepseek_v4: enabled: true providers: deepseek: base_url: https://api.deepseek.com/anthropic api_key: sk-your-deepseek-api-key # 替换为你的真实 Key offers: - model: deepseek-v4-pro - model: deepseek-v4-flash routes: moonbridge: model: deepseek-v4-pro provider: deepseek defaults: model: moonbridge max_tokens: 65536配置文件详解server.addr: 定义了 Moon Bridge 服务监听的地址和端口默认为本地的38440端口。你可以按需修改。models: 定义了 Moon Bridge 向 Codex “宣称”的模型能力。这里配置了deepseek-v4-pro和deepseek-v4-flash两个模型并设置了巨大的上下文窗口100万 tokens和输出长度38.4万 tokens以及推理等级等高级特性。extensions.deepseek_v4.enabled: true是关键它启用了对 DeepSeek V4 模型系列的特殊兼容性支持。providers: 定义了真正的模型提供商Provider—— DeepSeek。base_url是 DeepSeek 的 API 端点api_key是你的凭证offers列出了该提供商实际提供的模型列表。routes: 定义了路由规则。这里将名为moonbridge的虚拟模型路由到deepseek提供商的deepseek-v4-pro模型。当 Codex 请求moonbridge模型时Moon Bridge 就知道该转发给谁。defaults: 设置了默认使用的模型和最大 token 数。保存并关闭配置文件。3.3 启动 Moon Bridge 服务在moon-bridge目录下运行以下命令启动服务go run ./cmd/moonbridge --config config.yml如果一切正常终端会输出一些启动日志并显示服务正在127.0.0.1:38440上运行。请保持这个终端窗口打开不要关闭它否则服务会停止。此时Moon Bridge 已经启动并在本地38440端口提供了一个兼容OpenAI Responses API的端点http://127.0.0.1:38440/v1/responses。Codex 客户端将会向这个地址发送请求。4. 生成并配置 Codex 客户端现在我们需要配置 Codex CLI让它知道不去找 OpenAI而是找我们本地运行的 Moon Bridge。4.1 确定 Codex 配置目录Codex 的配置通常存储在用户主目录下的.codex文件夹中。环境变量CODEX_HOME可以覆盖这个路径。我们接下来的操作会向这个目录写入配置文件。4.2 生成 Codex 配置文件我们需要使用 Moon Bridge 提供的一个工具命令来为 Codex 生成正确的配置文件。这个命令会读取我们刚才写的config.yml并生成 Codex 能识别的config.toml和models_catalog.json文件。重要在生成新配置前建议备份你现有的 Codex 配置如果存在。打开一个新的终端窗口保持 Moon Bridge 运行的终端不动并确保当前目录仍在moon-bridge下。对于 macOS 或 Linux 用户# 1. 设置或获取 Codex 的配置目录路径 CODEX_HOME_DIR${CODEX_HOME:-$HOME/.codex} # 2. 创建目录如果不存在 mkdir -p $CODEX_HOME_DIR # 3. 可选备份现有配置 cp $CODEX_HOME_DIR/config.toml $CODEX_HOME_DIR/config.toml.bak 2/dev/null || true # 4. 生成新的配置文件 MODEL$(go run ./cmd/moonbridge --config config.yml --print-codex-model) go run ./cmd/moonbridge \ --config config.yml \ --print-codex-config $MODEL \ --codex-base-url http://127.0.0.1:38440/v1 \ --codex-home $CODEX_HOME_DIR \ $CODEX_HOME_DIR/config.toml对于 Windows PowerShell 用户# 1. 设置或获取 Codex 的配置目录路径 $CODEX_HOME_DIR if ($env:CODEX_HOME) { $env:CODEX_HOME } else { $HOME\.codex } # 2. 创建目录如果不存在 New-Item -ItemType Directory -Force -Path $CODEX_HOME_DIR | Out-Null # 3. 可选备份现有配置 if (Test-Path $CODEX_HOME_DIR\config.toml) { Copy-Item $CODEX_HOME_DIR\config.toml $CODEX_HOME_DIR\config.toml.bak -Force } # 4. 生成新的配置文件 $MODEL go run ./cmd/moonbridge --config config.yml --print-codex-model go run ./cmd/moonbridge --config config.yml --print-codex-config $MODEL --codex-base-url http://127.0.0.1:38440/v1 --codex-home $CODEX_HOME_DIR | Set-Content -Path $CODEX_HOME_DIR\config.toml执行上述命令后会在你的CODEX_HOME_DIR通常是~/.codex目录下生成两个文件config.toml: Codex 的主配置文件其中指定了wire_api responses以及我们 Moon Bridge 的地址。models_catalog.json: 模型目录文件描述了moonbridge这个“模型”的能力如上下文长度、支持的工具等Codex 客户端会根据这个文件来展示和启用相应功能。你可以查看一下生成的config.toml文件内容确认其中指向了本地服务cat ~/.codex/config.toml你应该能看到类似base_url http://127.0.0.1:38440/v1的配置项。5. 启动 Codex 并验证连接万事俱备现在可以启动 Codex 并测试它是否通过 Moon Bridge 成功连接到了 DeepSeek。5.1 启动 Codex CLI打开一个新的终端窗口。导航到你想要进行编码工作的项目目录。Codex 会分析当前目录的上下文。cd /path/to/your/project直接运行codex命令启动 Codex 交互式界面。codex如果配置一切正确Codex 会正常启动。你可能会看到 Codex 的欢迎信息或提示符。现在你可以尝试向它提问或发出编程指令例如/code 写一个Python函数计算斐波那契数列的第n项。Codex 会将你的请求发送到http://127.0.0.1:38440/v1/responses即 Moon BridgeMoon Bridge 将其转发至 DeepSeek API获取响应后再返回给 Codex 界面显示。5.2 验证服务连通性在启动 Codex 前后我们可以通过几个简单的命令验证各环节是否正常工作。1. 检查 Moon Bridge 模型列表在 Moon Bridge 运行的同时另开一个终端执行curl http://127.0.0.1:38440/v1/models如果返回一个包含id: moonbridge等信息的 JSON说明 Moon Bridge 的 API 端点工作正常。2. 直接向 Moon Bridge 发送测试请求curl http://127.0.0.1:38440/v1/responses \ -H Content-Type: application/json \ -d { model: moonbridge, input: 用一句简短的话介绍你自己。, max_output_tokens: 1024 }如果收到包含 DeepSeek 风格回复的 JSON 响应则证明 Moon Bridge 到 DeepSeek API 的链路是通的。3. 观察 Moon Bridge 运行日志当你通过 Codex 发送请求时运行 Moon Bridge 的终端窗口会打印出类似POST /v1/responses的访问日志。这是最直接的证据表明 Codex 的请求已经到达了 Moon Bridge。5.3 使用一键启动脚本可选Moon Bridge 项目还提供了便捷的一键启动脚本可以自动完成启动 Moon Bridge、生成配置、启动 Codex 的整个过程。macOS/Linux:./scripts/start_codex_with_moonbridge.sh --project-directory /path/to/your/projectWindows PowerShell:.\scripts\start_codex_with_moonbridge.ps1 -ProjectDirectory C:\path\to\your\project这个脚本会处理依赖检查和流程串联适合快速启动。但对于理解整个架构和排查问题还是建议按上述分步操作。6. 常见问题与故障排查在配置过程中你可能会遇到一些问题。下面列出了一些常见错误及其解决方法。问题现象可能原因排查与解决思路启动 Moon Bridge 时报错如command not found: go或go: go.mod file not found1. Go 环境未安装或未加入 PATH。2. 未在moon-bridge项目根目录执行命令。1. 运行go version检查 Go 安装。确保在正确的目录包含go.mod文件的目录执行命令。curl http://127.0.0.1:38440/v1/models返回connection refusedMoon Bridge 服务未成功启动或监听端口不对。1. 回到运行go run ./cmd/moonbridge --config config.yml的终端检查是否有错误日志。2. 确认config.yml中server.addr的端口是否是38440。3. 使用netstat -an | grep 38440(Linux/macOS) 或Get-NetTCPConnection -LocalPort 38440(PowerShell) 检查端口是否被监听。Codex 启动后提示找不到模型或无法连接1. Codex 配置文件未正确生成或路径不对。2.models_catalog.json文件缺失。1. 确认~/.codex/config.toml文件存在且内容正确包含base_url。2. 确认~/.codex/models_catalog.json文件存在。3.重新执行第 4.2 节的生成配置命令确保没有报错。Codex 或 curl 测试返回401 UnauthorizedDeepSeek API Key 配置错误或无效。1. 仔细检查config.yml中的api_key值确保没有多余空格且是完整的sk-开头字符串。2. 前往 DeepSeek 平台确认 API Key 是否启用、是否有余额。Codex 或 curl 测试返回402 Payment RequiredDeepSeek 账户余额不足。登录 DeepSeek 平台为账户充值。配置加载失败错误提示包含field provider not found使用了过时格式的config.yml。Moon Bridge 的配置格式已更新。请严格使用本文提供的config.yml格式其中providers、models、routes、defaults是顶级字段而不是嵌套在provider下。Codex 处理图像输入失败在config.yml中启用了视觉扩展但未配置正确的视觉提供商。如果你不需要图像处理功能请确保配置中extensions部分没有启用视觉扩展如visual.enabled: true。如果需要请参考 Moon Bridge 文档配置额外的视觉提供商如 Kimi及其 API Key。如果遇到上述未涵盖的问题请首先检查所有终端窗口确保 Moon Bridge 服务进程一直处于运行状态。网络连接确保你的机器可以正常访问api.deepseek.com。版本兼容性确认你的 Node.js、Go、Codex CLI 版本符合要求。查看日志Moon Bridge 的运行终端和 Codex 的输出通常会提供详细的错误信息。7. 最佳实践与进阶配置建议成功搭建只是第一步要让这套组合稳定、高效、安全地服务于你的开发工作还需要注意以下几点。7.1 安全与密钥管理永远不要提交密钥config.yml文件中包含你的 DeepSeek API Key。务必将该文件添加到你的.gitignore文件中避免意外提交到公开仓库。使用环境变量更安全的方式是通过环境变量传递 API Key。你可以修改config.ymlproviders: deepseek: base_url: https://api.deepseek.com/anthropic api_key: ${DEEPSEEK_API_KEY} # 从环境变量读取然后在启动 Moon Bridge 前设置环境变量export DEEPSEEK_API_KEYsk-your-real-key-here go run ./cmd/moonbridge --config config.yml最小权限原则在 DeepSeek 平台创建 API Key 时如果支持请仅授予其必要的权限。7.2 性能与稳定性选择模型config.yml中我们路由到了deepseek-v4-pro这是能力最强的模型但成本也相对较高。对于日常代码补全和对话deepseek-v4-flash速度更快成本更低是性价比之选。你可以在routes部分轻松切换。routes: moonbridge: model: deepseek-v4-flash # 改为使用 flash 模型 provider: deepseek管理上下文长度虽然我们配置了很大的max_output_tokens但在实际使用中过长的输出可能会消耗大量 tokens。可以在 Codex 的交互中或通过配置文件合理限制单次请求的最大输出 tokens以控制成本。服务常驻如果你频繁使用 Codex可以考虑将 Moon Bridge 部署为系统后台服务如使用systemd(Linux)、launchd(macOS) 或nssm(Windows)避免每次手动启动。7.3 配置优化与扩展多模型/多提供商Moon Bridge 支持配置多个模型和提供商。例如你可以同时配置 DeepSeek 和另一个兼容 OpenAI API 的服务并在routes中根据规则进行路由。详细配置请参考 Moon Bridge 项目中的config.example.yml文件。使用配置文件目录可以将config.yml放在独立目录并通过--config参数指定绝对路径方便管理。Codex App 配置如果你使用 Codex 的桌面应用程序App其配置目录可能与 CLI 不同通常在~/Library/Application Support/Codex/(macOS) 或%APPDATA%\Codex\(Windows)。你需要将生成的config.toml和models_catalog.json文件也复制到对应的 App 配置目录中。7.4 成本监控定期查看用量养成习惯定期登录 DeepSeek 开放平台查看 API 调用量和费用消耗。DeepSeek 提供了非常清晰的使用量统计和账单信息。设置预算预警如果平台支持可以设置每月预算或用量告警防止意外超额。通过本文的详细步骤你已经成功地将昂贵的 Codex 官方后端替换为了高性价比的 DeepSeek。这套方案不仅显著降低了使用成本还为国内开发者提供了更稳定、快速的访问体验。从环境搭建、配置详解到故障排查和最佳实践我们覆盖了从入门到熟练所需的全部知识点。现在你可以尽情享受 AI 结对编程带来的效率提升而无需担心高昂的账单了。如果在实践中遇到新的问题多查看终端日志、善用社区资源如 Moon Bridge 的 GitHub Issues大部分技术难题都能找到解决方案。 30款热门AI模型一站整合DeepSeek/GLM/Claude 随心用限时 5 折。 点击领海量免费额度