技能介绍

要解决什么问题

OpenAI Codex CLI 在 macOS 上想接 DeepSeek 时，往往会卡在两处硬不兼容：一是 Codex 只走 Responses API（/v1/responses），而 DeepSeek 仍是 Chat Completions（/v1/chat/completions），直连常见 404；二是 Codex CLI v0.137.0+ 的 codex exec 会在同一 Node 进程里拉起 app-server，在 macOS 沙箱 / SIP 下容易权限失败。

技能如何工作

本技能用三层本地桥接把链路打通：

codex-bridge（默认 4000）：把 Responses 请求/响应与 Chat Completions（含 SSE）互转，并维护 previous_response_id 等历史链。
独立 codex app-server（如 9998）：以 WebSocket 单独跑核心服务，CLI 只连 WS，绕过进程内加载二进制的 macOS 问题。
codex_client.mjs：按 app-server 的 JSON-RPC 协议发任务、收流式结果。

配置上，Codex 侧把 model_provider 设为 local_proxy，base_url 指向 http://127.0.0.1:4000/v1，wire_api 仍为 responses；上游用 DeepSeek API Key（sk-...），模型可选 deepseek-v4-flash 或 deepseek-v4-pro。proxy.mjs 也可同时挂 OpenAI 与 DeepSeek，按模型名路由。

适用边界与注意点

环境：方案主要面向 macOS；需 Node.js 22+（含 ws）、已全局安装 Codex CLI，且 DeepSeek 账户有余额。
认证：DEEPSEEK_API_KEY 与代理侧 PROXY_AUTH_KEY 需正确配置；401/429 多为 Key 错误或余额不足，勿误用 Codex 内置 Key 顶替 DeepSeek。
能力边界：桥接解决的是 API 形态与本地启动方式，不保证 Codex 全部工具链与 DeepSeek 模型行为与 OpenAI 官方完全一致；复杂工具调用依赖转换层对 function/tool 字段的映射质量。

截图预览

使用场景

在 macOS 上用 Codex CLI 写代码，但官方端点只能走 Responses API，直连 DeepSeek 报 404，需要本地代理做格式转换。
已安装 Codex CLI v0.137+，执行 `codex exec` 因进程内启动 app-server 触发沙箱报错，需独立 WebSocket 服务再连客户端发任务。
希望沿用 Codex 的 `local_proxy` 与 `wire_api=responses` 配置，把模型换成 `deepseek-v4-flash` 或 `deepseek-v4-pro` 做日常或复杂推理任务。
同一台机器既要走 DeepSeek 又要偶尔用 OpenAI，需在 `proxy.mjs` 里按模型名自动路由到不同上游 API。

适合人员

在 macOS 上已用 Codex CLI 做仓库级改代码，因成本或合规必须用 DeepSeek Key 而非 OpenAI 官方后端的工程师。
负责搭建本机 AI 编程环境、需要核对 `DEEPSEEK_API_KEY`、`PROXY_AUTH_KEY` 与 bridge 日志来排查 401/429 的 DevOps 或平台同学。
遇到 Codex 工具调用与 SSE 流格式问题、想对照 `protocol.md` 与 bridge 转换逻辑（messages/tool_calls）的集成维护者。
需要一键 `start_all.sh` 或分步启动 bridge + app-server，并在固定 `cwd` 下用客户端批量跑 Codex 任务的脚本化使用者。