背景说明

我已经有一个claude code了，想要再装一个codex做相互检查。

Codex 只支持 OpenAI 的 Responses API 协议，而 DeepSeek 只支持 Chat Completions API 协议。两者"语言不通"，所以需要一个本地桥接工具在中间做协议翻译。

---

前置条件

• 已安装 Node.js（Codex 依赖 npm）
• 已安装 Python（部分工具依赖）
• 有一个 DeepSeek API Key

---

第一步：安装 Codex 

npm install -g @openai/codex

安装完成后，确认一下路径：

Get-Command codex | Format-List Name, Source

预期输出中 Source 应指向 C:\Users\<你的用户名>\AppData\Roaming\npm\codex.ps1

---

第二步：下载桥接工具 DeepCodex

1. 打开 https://github.com/miloce/DeepCodex/releases
2. 下载 deepcodex-app-windows.zip
3. 解压到固定路径，比如：C:\Users\<你的用户名>\.codex\deepcodex-app-windows
4. 确认里面有 deepcodex.exe

---

第三步：首次配置 DeepCodex

1. 双击运行 deepcodex.exe
2. 首次启动会提示输入 DeepSeek API Key，粘贴你的 Key
3. 在菜单中选择 1（使用 DeepSeek）
4. 看到 Bridge 地址（如 http://127.0.0.1:1314/v1）后，不要关闭该窗口
5. 另开一个终端，输入 codex 测试是否能正常启动

---

第四步：配置 PowerShell 一键启动

先查看当前 $PROFILE 内容：

Get-Content $PROFILE

然后用以下命令整体覆盖写入（把 start-codex 函数追加到现有配置后面）：

$profileContent = @'
$env:ANTHROPIC_BASE_URL = "https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN = "你的API Key"
$env:ANTHROPIC_MODEL = "deepseek-chat"

function start-codex {
    $bridgeProcess = Get-Process -Name "deepcodex" -ErrorAction SilentlyContinue
    if (-not $bridgeProcess) {
        Write-Host "[*] 正在后台启动 DeepSeek 桥接服务..." -ForegroundColor Green
        Start-Process -FilePath "C:\Users\<你的用户名>\.codex\deepcodex-app-windows\deepcodex.exe"
        Start-Sleep -Seconds 5
    }
    & "C:\Users\<你的用户名>\AppData\Roaming\npm\codex.ps1" @args
}
'@

$profileContent | Set-Content $PROFILE

 把 <你的用户名> 和 你的API Key 替换成你自己的值。

让配置生效：

. $PROFILE

以后每次打开终端，输入 codex 即可一键启动。

---

常见问题与解决方案

问题一：输入 codex 后终端卡死无响应

原因： 函数名叫 codex，函数内部又调用 & "codex"，导致无限递归。

解决： 函数名必须和真正的 codex 命令不同名。本方案使用 start-codex，内部用完整路径 C:\Users\<你的用户名>\AppData\Roaming\npm\codex.ps1 调用真正的 codex，彻底避免递归。

---

问题二：pip install codex-relay 报错找不到包

原因： codex-relay 这个包不存在或已下架。

解决： 放弃 pip 方案，改用 DeepCodex（exe 工具），解压即用，无需安装任何依赖。

---

最终效果

操作	命令
启动 Codex	终端输入 codex
使用 Claude Code	正常使用，配置完全不受影响
查看桥接状态	任务管理器中看有没有 deepcodex.exe 进程