背景说明
我已经有一个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
- 打开 https://github.com/miloce/DeepCodex/releases
- 下载
deepcodex-app-windows.zip - 解压到固定路径,比如:
C:\Users\<你的用户名>\.codex\deepcodex-app-windows - 确认里面有
deepcodex.exe
第三步:首次配置 DeepCodex
- 双击运行
deepcodex.exe - 首次启动会提示输入 DeepSeek API Key,粘贴你的 Key
- 在菜单中选择
1(使用 DeepSeek) - 看到 Bridge 地址(如
http://127.0.0.1:1314/v1)后,不要关闭该窗口 - 另开一个终端,输入
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进程 |