最近在 Windows 上折腾 Codex + WeCode 这套组合,前后踩了一堆坑,从"装完打不开"到"API 报 400",再到"本地代理切换失败",每个问题都能让人卡上半天。这篇文章把整个配置过程、踩坑点、完整解决方案全部记录下来,尤其是接入第三方 API(以 DeepSeek 为例)的部分,网上几乎没有讲透的。如果你也准备在 Windows 下把 Codex CLI 接进 WeCode,用国产大模型 API 跑 AI 编程,这篇文章可以直接当攻略抄。
Codex 是 OpenAI 推出的命令行 AI 编程智能体,WeCode 是腾讯出的 AI 原生 IDE(VS Code 的分支版本),两个工具本身都挺好用,但"Windows + Codex + WeCode + 第三方 API"这个组合,官方文档基本只覆盖了最理想的情况,实际跑起来会遇到一堆中国开发者特有的问题。比如 Codex CLI 二进制找不到、DeepSeek 模型名不被识别、上下文窗口超限、CC Switch 切换本地代理失败等,每一个都是真实踩过的坑。下面按实际操作顺序,从原理到配置,再到排错,完整过一遍。
1. 先搞清楚这套组合到底在干什么
1.1 Codex CLI:一个跑在终端里的 AI 编程员
Codex CLI 是 OpenAI 开源的终端编程智能体,核心能力是让你用自然语言和它对话,它能在你的项目目录里读代码、改代码、执行命令、检查运行结果,像一个坐在你旁边帮你写代码的结对程序员。和 ChatGPT 网页版最大的区别在于,它直接跑在你的本地环境里,能操作真实文件,调用真实命令,甚至能自己跑测试来验证改动是否正确。
从技术实现上看,Codex CLI 本质上是 OpenAI API 的客户端,通过 responses 接口调用大模型。它本身不内置模型,需要配置模型提供商和 API Key。这就引出了两个关键点:一是官方默认配置指向 OpenAI 自己的 API,二是它通过统一的 OpenAI 兼容接口来对接不同的模型服务商。理解了这两点,后面配置第三方 API 的时候就容易多了。
1.2 WeCode:AI 原生的代码编辑器
WeCode 是腾讯推出的 AI 原生 IDE,基于 VS Code 的分支开发,界面和操作习惯和 VS Code 基本一致,内置了腾讯自家的 AI 能力,同时兼容 VS Code 生态的大量扩展。对于国内开发者来说,WeCode 有个天然优势:从官网下载、登录、更新都在国内网络环境下顺畅完成,不需要额外处理网络问题。
在 WeCode 里使用 Codex,主要是通过安装 Codex 扩展来实现。WeCode 的扩展市场兼容 VS Code 扩展,所以可以直接搜索安装 Codex 扩展。这里有一个容易踩的坑:Codex 扩展需要调用本机的 Codex CLI 二进制,如果 WeCode 找不到这个可执行文件,就会报 unable to locate the codex cli binary 错误。这个问题后面专门讲。
1.3 第三方 API:把模型换成自己选的大模型
所谓第三方 API,指的就是不直接用 OpenAI 官方接口,而是通过其他模型服务商提供的 OpenAI 兼容接口来驱动 Codex。目前国内用得最多的是 DeepSeek,原因是便宜、上下文窗口大、代码能力在同价位里表现突出,而且国内服务器直连,不需要额外的网络配置。
使用第三方 API 的核心逻辑在于:Codex 通过标准的 OpenAI 兼容接口和模型服务商通信,只要服务商提供了兼容接口,把 Codex 配置里的接口地址、模型名、API Key 换成服务商的信息,就能跑起来。这个方案的好处是灵活,你可以根据预算和需求随时切换模型,不用被某一个厂商绑定。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. Windows 下的环境准备与前置安装
2.1 前置依赖:Node.js 和 Git 一个都不能少
先说 Node.js。Codex CLI 的安装包本身是 npm 包,需要 Node.js 环境来安装和运行。我当时第一遍装的时候,机器上 Node.js 版本是 14,安装 Codex 的时候各种报错,后来把 Node.js 升级到 20 LTS 版才顺利装上。这里建议直接装最新的 LTS 版本,不要用太老的版本,也不要追最新的 non-LTS 版本,LTS 稳定最重要。
安装 Node.js 的时候注意勾选"Add to PATH"选项,这样 npm 命令才可以在命令行里直接使用。装完后在 PowerShell 里跑一下 node -v 和 npm -v 确认版本,两个命令都有输出就说明环境没问题。如果提示找不到命令,多半是 PATH 没配好或者安装时没勾选,把 Node.js 安装目录手动加到系统环境变量里就可以解决。
再说 Git。Codex 有些操作会用到 Git 命令,比如在项目初始化、查看 diff、提交代码的时候。WeCode 本
