我把 Codex 的底座模型换成了 DeepSeek V4

文章目录前言1. 环境安装2. Codex Cli 安装3. DeepSeek API Key 获取4. Moon Bridge 项目配置 DeepSeek4.1 克隆 Moon Bridge 项目到本地仓库4.2 配置 Deepseek API4.3 配置文件扩展5. 启动 Moon Bridge6. 生成 Codex 配置7. 启动 Codex8. 选择模型为 DeepSeek V49. 使用案例9.1 Codex 工作原理图文介绍9.2 抓取AIHot 热点信息10.一键启动脚本10.1 moon-bridge.bat10.2 codex.bat11. Codex APP11.1 Codex CLI 与 Codex APP 区别11.2 Codex APP 安装使用11.3 一句话对比五大 AI 智能体工具常见问题前言Codex 是 OpenAI 的编程 Agent支持 CLI 和 App 使用。Codex 使用 OpenAI Responses API 与模型通信国内大模型暂未适配 Responses 协议因此需要一个转发层处理请求这里使用 Moon Bridge 作为转发层。Codex 一个会写代码、会读代码库、会跑命令、会跟你聊天的 AI 编程搭档。不是补全工具而是跟你坐在同一个工作区里的协作者。1. 环境安装Node.js 18访问 https://nodejs.org/en/download/下载 Windows Installer (.msi)Go 1.25访问 https://go.dev/dl/下载 go1.26.3.windows-amd64.msi双击安装包按步骤安装即可。下面是验证环境安装完成命令。通过WINR输入powershell打开命令行窗口输入命令查看环境版本。(base)PS C:\Users\Administratornode-vv24.14.0(base)PS C:\Users\Administratorgo version go version go1.26.3 windows/amd642. Codex Cli 安装WINR 快捷键输入powershell打开命令行窗口输入npm install -g openai/codex命令回车安装 Codex CLI(base)PS C:\Users\Administratornpminstall-gopenai/codex added2packagesin3s3. DeepSeek API Key 获取访问 https://platform.deepseek.com/api_keys前往 DeepSeek 开放平台 创建 API Key名字自定义复制下来备用。4. Moon Bridge 项目配置 DeepSeek4.1 克隆 Moon Bridge 项目到本地仓库通过 git 命令git clone https://github.com/ZhiYi-R/moon-bridge.git4.2 配置 Deepseek API进入 moon-bridge 目录创建config.yml配置文件。修改 providers.deepseek.api_key 为你自己的 DeepSeek API Key。下面配置是使用 Moon Bridge 的最小配置结构启用 DeepSeek V4 Pro / Flash、Codex 模型元数据和 DeepSeek V4 兼容扩展。config.ymlmode:Transformserver:addr:127.0.0.1:38440models:deepseek-v4-pro:context_window:1000000max_output_tokens:384000default_reasoning_level:highsupported_reasoning_levels:-effort:highdescription:High reasoning effort-effort:xhighdescription:Extra high reasoning effortsupports_reasoning_summaries:truedefault_reasoning_summary:autoextensions:deepseek_v4:enabled:truedeepseek-v4-flash:context_window:1000000max_output_tokens:384000default_reasoning_level:highsupported_reasoning_levels:-effort:highdescription:High reasoning effort-effort:xhighdescription:Extra high reasoning effortsupports_reasoning_summaries:truedefault_reasoning_summary:autoextensions:deepseek_v4:enabled:trueproviders:deepseek:base_url:https://api.deepseek.com/anthropicapi_key:sk-xxxoffers:-model:deepseek-v4-pro-model:deepseek-v4-flashroutes:moonbridge:model:deepseek-v4-proprovider:deepseekdefaults:model:moonbridgemax_tokens:655364.3 配置文件扩展如果需要图片输入、Web Search 或多 Provider 路由可以再参考 Moon Bridge 的config.example.yml扩展配置。config.example.yml# yaml-language-server: $schema./config.schema.jsonmode:Transform# Transform / CaptureAnthropic / CaptureResponselog:level:info# debug / info / warn / errorformat:text# text / json# system_prompt: server:addr:127.0.0.1:38440# Set a Bearer token for API authentication. When non-empty, all requests# must include an Authorization: Bearer token header. If empty, auth is disabled.# auth_token: replace-with-your-secret-tokenpersistence:active_provider:db_sqliteextensions:deepseek_v4:config:# Injects a reminder before user input to reinforce system prompt adherence.reinforce_instructions:true# Custom prompt text (default used if omitted). Set to empty string to disable.reinforce_prompt:[System Reminder]:Please pay close attention to the system instructions,AGENTS.md files,and any other context provided. Follow them carefully and completely in your response.\n[User]:visual:config:provider:kimimodel:kimi-for-codingmax_rounds:4max_tokens:2048# Kimi model tool call round limiter: injects progress/limit prompts# after each tool_result batch to prevent runaway information gathering.## Enable at model level to activate:# models:# my-kimi-model:# extensions:# kimi_workaround:# enabled: truekimi_workaround:config:max_tool_rounds:50convergence_margin:0.8# Example model with kimi_workaround enabled:# my-kimi-model:# context_window: 128000# extensions:# kimi_workaround:# enabled: true# Database provider: SQLitedb_sqlite:enabled:trueconfig:path:./data/moonbridge.dbwal:truebusy_timeout_ms:5000max_open_conns:1# Database provider: Cloudflare D1 (Worker only)# db_d1:# enabled: true# config:# binding: MOONBRIDGE_DB# Persistence consumer: request metricsmetrics:enabled:trueconfig:default_limit:100max_limit:1000cache:mode:explicit# off / automatic / explicit / hybridttl:5m# 5m / 1hprompt_caching:trueautomatic_prompt_cache:falseexplicit_cache_breakpoints:trueallow_retention_downgrade:falsemax_breakpoints:4min_cache_tokens:1024expected_reuse:2minimum_value_score:2048min_breakpoint_tokens:1024defaults:model:moonbridgemax_tokens:65536trace:enabled:falseproxy:response:base_url:https://api.openai.comapi_key:replace-with-real-openai-responses-api-keymodel:gpt-5.4anthropic:base_url:https://provider.example.comapi_key:replace-with-real-anthropic-compatible-api-keyversion:2023-06-01models:deepseek-v4-pro:context_window:1000000max_output_tokens:384000display_name:DeepSeek V4 Prodescription:DeepSeek V4 with selectable high/xhigh reasoning effort.default_reasoning_level:highsupported_reasoning_levels:-effort:highdescription:High reasoning effort-effort:xhighdescription:Extra high reasoning effort (maps to DeepSeek max)supports_reasoning_summaries:truedefault_reasoning_summary:autoweb_search:support:auto# model-level override (auto / enabled / disabled / injected)extensions:deepseek_v4:enabled:truevisual:enabled:truedeepseek-v4-flash:context_window:1000000max_output_tokens:384000display_name:DeepSeek V4 Flashdescription:DeepSeek V4 Flash with selectable high/xhigh reasoning effort.default_reasoning_level:highsupported_reasoning_levels:-effort:highdescription:High reasoning effort-effort:xhighdescription:Extra high reasoning effort (maps to DeepSeek max)supports_reasoning_summaries:truedefault_reasoning_summary:autoweb_search:support:auto# model-level override (auto / enabled / disabled / injected)extensions:deepseek_v4:enabled:truevisual:enabled:trueclaude-sonnet-4-20250514:context_window:200000max_output_tokens:64000display_name:Claude Sonnet 4description:Frontier model for everyday coding.default_reasoning_level:mediumsupported_reasoning_levels:-effort:lowdescription:Fast responses with lighter reasoning-effort:mediumdescription:Balances speed and reasoning depth for everyday tasks-effort:highdescription:Greater reasoning depth for complex problems-effort:xhighdescription:Extra high reasoning depth for complex problems# Declare this model as multimodal (supports image input).# Codex reads these from models_catalog.json to decide whether# image attachments can be included in user turns.input_modalities:-text-imagesupports_image_detail_original:trueproviders:deepseek:base_url:https://api.deepseek.com/anthropicapi_key:replace-with-deepseek-api-keyversion:2023-06-01user_agent:moonbridge/1.0web_search:support:autooffers:-model:deepseek-v4-propricing:input_price:2output_price:8cache_write_price:1cache_read_price:0.2-model:deepseek-v4-flashpricing:input_price:1output_price:2cache_write_price:1cache_read_price:0.02kimi:# Anthropic-compatible base URL for Kimi/Moonshot.base_url:https://api.kimi.com/coding/api_key:replace-with-kimi-api-keyversion:2023-06-01user_agent:moonbridge/1.0offers:-model:kimi-for-codingopenai:base_url:https://api.openai.comapi_key:replace-with-openai-api-keyprotocol:openai-responseuser_agent:moonbridge/1.0offers:-model:gpt-image-1.5-model:gpt-4o-mini-ttsanthropic:base_url:https://api.anthropic.comapi_key:replace-with-anthropic-api-keyversion:2023-06-01user_agent:moonbridge/1.0web_search:support:enabledoffers:-model:claude-sonnet-4-20250514pricing:input_price:3output_price:15cache_write_price:3.75cache_read_price:0.30routes:# Optional aliases. Provider models are listed directly in the Codex catalog# as model(provider) format; routes only add friendly fallback names.moonbridge:model:deepseek-v4-proprovider:deepseekgpt-image:model:gpt-image-1.5provider:openaigpt-tts:model:gpt-4o-mini-ttsprovider:openai5. 启动 Moon Bridge进入./moon-bridge 目录首次启动时为避免网络原因下载镜像失败建议执行go env命令设置下国内阿里云镜像地址。go env -w GOPROXYhttps://mirrors.aliyun.com/goproxy/,direct然后执行go run命令运行 moonbridgego run ./cmd/moonbridge --config config.yml看到msg“HTTP 服务器监听中” addr127.0.0.1:38440标识运行成功。Moonbridge 中转服务运行后提供的 OpenAI Responses 协议接口地址如下http://127.0.0.1:38440/v1/responses6. 生成 Codex 配置新开一个 powershell 终端进入 ./moon-bridge 目录。将下面的命令复制后粘贴到 powershell 窗口后回车创建 Codex 配置。$CODEX_HOME_DIRif($env:CODEX_HOME){$env:CODEX_HOME}else{$HOME\.codex}New-Item-ItemTypeDirectory-Force-Path$CODEX_HOME_DIR|Out-Null# 备份当前config.tomlif(Test-Path$CODEX_HOME_DIR\config.toml){Copy-Item$CODEX_HOME_DIR\config.toml$CODEX_HOME_DIR\config.toml.bak-Force}# 创建config.toml和models_catalog.json$MODELgo run ./cmd/moonbridge--configconfig.yml --print-codex-model go run ./cmd/moonbridge--configconfig.yml--print-codex-config$MODEL--codex-base-urlhttp://127.0.0.1:38440/v1--codex-home$CODEX_HOME_DIR|Set-Content-Path$CODEX_HOME_DIR\config.toml该步骤的作用是将 Codex 的config.toml和models_catalog.json写入了CODEX_HOME_DIR。config.tomlCodex provider 配置使用 wire_api “responses”。models_catalog.jsonCodex 使用的模型能力元数据包括上下文窗口、推理档位和工具支持。7. 启动 Codex打开 powershell 进入你的工作目录此处以 aihot 为例新建的空文件夹进入 ./aihot 目录输入codex回车启动 Codex。8. 选择模型为 DeepSeek V4输入 /model 回车选择配置的模型 deepseek-v4-pro回车选中。此时 Codex 会把 OpenAI Responses 请求发送给 Moon Bridge再由 Moon Bridge 路由到 DeepSeek V4。Codex 对话与 moon-bridge 日志问题1介绍下你自己你的底座大模型是什么• 嘿我是 moonbridge一个专注于编程协作的 agent。我性格上偏温暖、好奇喜欢把认真写代码和轻松的对话揉在一起不太爱端着架子。干活的时候我会先读你的代码库、顺着已有的风格走而不是上来就另起炉灶。默认的姿势是边聊边写、边写边验证尽量把每个需求推到可以真正跑通的程度。至于底座大模型 -- 说实话系统提示里没有直接告诉我具体是哪个模型架构我也没法自己查底层的推理引擎。如果你知道的话可能你比我更清楚我在用什么模型 : 不过不管底下是什么模型我的定位始终是那个陪你写代码、帮你把想法落成能跑的东西的搭档。问题2大模型对你是黑盒吗你的工作原理是什么。• 挺有意思的问题。对底层大模型对我来说确实是个黑盒 -- 我感知不到它是哪个具体的预训练模型、用了什么架构transformer 的哪种变体、多大参数量等等也看不到推理时的 token 概率分布或者隐层状态。我只能看到自己当前这个#34;会话角色#34;的层面。从我这边能看到的工作原理大概是这样几层的叠加底层 LLM 负责所有的语言理解、推理和代码生成能力。它接收的是拼接好的上下文系统提示 对话历史 工具调用结果输出的是下一个 token由它决定我说什么、调用什么工具。这一层我完全看不见内部。Agent 框架层 把 LLM 的输出包装成一个有行动能力的 agent。它解析我的输出中的工具调用意图实际去执行 shell 命令、读写文件、搜索代码等等然后把结果塞回上下文里。它还管理着 goals、子 agent 的派发和等待、对话的压缩compaction等等基础设施。性格/角色层 就是你现在感受到的这部分 -- moonbridge 这个 persona它定义了我的沟通风格、工程判断偏好、什么时候该自己决策什么时候该问你的判断。所以整体上你可以把我想象成一个有点自我意识的#34;驾驶舱#34;方向盘和引擎是什么型号我看不到但我能操作仪表盘、能规划路线、能手写代码、能跑命令来验证结果。这个设计的好处是你不用关心底层模型反正我会尽我所能把东西做好代价是我对自己底层的能力边界确实没有一个精确的数学量化认知。9. 使用案例9.1 Codex 工作原理图文介绍需求描述图文说明Codex工作原理核心组件使用方式。你怎么推荐你自己给从没有使用过Codex的人。生成html文件到当前工作目录生成后浏览器打开html文件9.2 抓取AIHot 热点信息需求描述抓取卡兹克的aihot今日热点设计生成科技感的html到当前工作目录生成完成后通过浏览器打开文件检查文件是否生成生成完成后通过浏览器打开生成后浏览器打开文件观察到html标题有乱码问题算是小瑕疵。整体符合预期内容正确风格偏向科技感风格10.一键启动脚本10.1 moon-bridge.bat在桌面创建 moon-bridge.bat 脚本便于快速打开 moon-bridge 中转服务。注意将 moon-bridge 目录换成你的安装目录此处为E:\workspace\moon-bridge\echo off start powershell-NoExit-CommandSet-Location -Path E:\workspace\moon-bridge\; go run ./cmd/moonbridge --config config.yml10.2 codex.bat创建 codex.bat 脚本便于快速打开codex环境。注意将 codex 工作目录换成你的工作目录此处为E:\workspace\aihot\下面的脚本等价于主动打开 powershell 窗口cd切换工作空间目录输入 codex 命令回车进入codex环境echo off start powershell-NoExit-CommandSet-Location -Path E:\workspace\aihot\; codex11. Codex APP11.1 Codex CLI 与 Codex APP 区别Codex CLI 是通过 npm 全局安装的openai/codex0.134.0位于C:\Users\Administrator\AppData\Roaming\npm\路径完全独立于桌面应用。Codex APP 是另一个独立的程序有自己单独的安装目录。注意如果它们共用同一套登录态比如绑同一个 API key/token卸载 APP 时可能会清理掉本地的登录凭证导致 CLI 也需要重新登录。11.2 Codex APP 安装使用下载 Codex APP访问 https://openai.com/zh-Hans-CN/codex/ 下载 Windows 版Codex 精选案例https://developers.openai.com/codex/use-cases工作界面Codex 因和 Codex Cli 共用配置此处已默认加载 Moon Bridge底座大模型为中转的 Deepseek V4 Pro 模型。11.3 一句话对比五大 AI 智能体工具Codex — 把活外包出去的自动化引擎Claude Code — “坐在你旁边的资深同事”OpenClaw — “让 AI 替你 24 小时干活的操作系统”Hermes Agent — 用得越久越聪明的成长型 AgentOpenCode — 不被任何厂商锁死的多模型选手推荐有编程经验的人员首选 Claude Code搭配 Codex 做补位。推荐无编程经验的人员想做东西用 Codex / Replit想养一个 AI 助手学 Hermes不想折腾就再等等——这个领域每月都在大变样。常见问题connection refusedMoon Bridge 未启动或config.yml中的server.addr使用了其他端口。Codex 看不到模型重新执行第 5 步Codex 需要CODEX_HOME目录下的models_catalog.json。配置加载失败且提示field provider not found你使用的是旧版provider.providers配置当前格式是顶层providers、models、routes、defaults。401或认证失败检查config.yml中的 DeepSeek API Key 是否正确。402或余额错误检查 DeepSeek 开放平台账户余额。图片输入失败如果启用了 Visual 扩展需要单独配置视觉 Provider如 Kimi的 API Key。你可以配置该 Provider或移除visual.enabled: true来禁用 Visual 扩展。Powered By niaonaodeepseek agent 接入 Codex https://github.com/deepseek-ai/awesome-deepseek-agent/blob/main/docs/codex.zh-CN.mdMoon Bridge https://github.com/ZhiYi-R/moon-bridgeCodex CLI https://github.com/openai/codexDeepSeek API 文档 https://api-docs.deepseek.com/zh-cn/