从一年前开始我就在 Windows 上折腾各种 AI 编程工具Codex 和 Claude Code 是其中绕不开的两个。说实话第一次装的时候光环境变量就卡了我两个小时。后来帮同事装了几次发现大家踩的坑几乎一模一样要么node命令找不到要么安装成功但启动报错要么中文乱码要么 VSCode 里根本调不起来。这篇文章就是我把这些坑全部捋平之后整理出来的完整流程覆盖 Codex 和 Claude Code 的安装配置、鉴权登录、常用命令以及 VSCode 接入的几种方式。不用再到处翻官方文档了照着这篇一步步走基本能一遍过。1. 先搞清楚Codex 和 Claude Code 到底解决什么问题1.1 两个工具分别是什么先用一句话说清楚。Codex 是 OpenAI 推出的命令行 AI 编程助手装好之后在终端里输入codex就能直接对话让它写代码、改文件、修 bug、跑命令它会像一个坐在你旁边的工程师一样一边理解你的项目一边直接动手改。Claude Code 是 Anthropic 出的终端编程代理理念更偏“Agent”——给它一个目标它能自己去读代码、列计划、改多个文件、执行测试、再根据报错继续修一直到任务完成。两者最大的区别在工作方式上。我自己的体感是Codex 更擅长处理单点问题比如“帮我看看这个函数为什么报错”、“把这段代码改写成异步实现”Claude Code 更适合处理完整任务链路比如“给这个模块补充单元测试覆盖率做到 80% 以上然后把测试报告写到 docs 目录里”它会自己拆解步骤、逐个完成。对比项CodexClaude Code出品方OpenAIAnthropic启动命令codexclaude交互方式交互式会话 / codex exec 执行单次任务交互式会话 / claude -p 执行单次任务强项单文件重构、代码解释、快速补全多文件改动、完整任务链路、自修复循环安装方式npm 全局安装npm 全局安装鉴权OpenAI 账号登录或 API KeyAnthropic 账号登录或 API Key1.2 为什么 Windows 用户需要单独一篇教程官方文档默认以 macOS 和 Linux 为主很多命令在 Windows 上的表现其实不太一样。最典型的就是全局安装路径的问题macOS 和 Linux 上 npm 全局包装完命令自动就躺在/usr/local/bin里终端随便一敲就有。Windows 不一样npm 全局目录默认在用户目录的 AppData 下面如果这个目录没加进系统 PATH装得再多也永远是“codex 不是内部或外部命令”。再加上 Windows 上有两套终端体系——传统的 Command Prompt 和 PowerShell两者的环境变量语法、脚本执行策略完全不同。很多教程直接甩一段export OPENAI_API_KEYxxx那是 macOS 和 Linux 的写法拿来 PowerShell 里跑没有任何作用。这也是我写这篇的核心原因把 Windows 特有的这些细节补齐你才不会再卡在第一步。1.3 谁适合用这两套组合如果你是做开发的天天用 VSCode想在写代码的时候有个 AI 助手直接帮你改文件这套组合非常合适。如果你只是偶尔写点脚本、处理点数据想用 AI 辅助生成代码也有用武之地——两个工具都能在命令行里直接给出可运行的代码文件。需要提前做好心理准备的是它们的前期配置比网页版聊天工具要繁琐一些毕竟本质是在你的电脑本地起一个终端 Agent权限、环境变量、模型接口这些都是绕不开的。但配好之后体验完全值得。2. 安装前的环境准备Node.js、终端和路径三件事2.1 Node.js 装对版本Codex 和 Claude Code 本质上是 npm 包所以 Node.js 是地基。官方对 Node 版本有要求建议装 LTS 版本目前比较可靠的是 20 LTS 或 22 LTS18 也能用但低于 18 就不要挣扎了先升级再说。下载地址就是 Node.js 官网选择Windows Installer (.msi)版本。安装的时候有一个非常关键的勾选项——Add to PATH默认是勾上的千万别手滑去掉。这一步决定了你之后能在终端里直接敲node -v。装完之后重新打开一个终端窗口分别执行node -v npm -v能正常输出版本号就说明 Node 环境没问题。如果提示node 不是内部或外部命令大概率就是 PATH 没生效。可以先重启电脑或者手动检查环境变量里有没有C:\Program Files\nodejs\这个路径。2.2 把终端换成 Windows TerminalWindows 自带的终端交互体验确实一般尤其是历史记录和复制粘贴。建议去微软商店装一个 Windows Terminal免费装完设置里把默认终端应用改成 Windows Terminal默认配置文件可以根据自己习惯选 PowerShell 7 或者系统自带的 Windows PowerShell。这里有个小建议如果你平时用 PowerShell 5后续执行 npm 脚本时偶尔会遇到执行策略拦截。两个终端对脚本的处理策略略有不同Windows Terminal 本身只是界面真正影响行为的是底层用的哪个 Shell。我个人的组合是 Windows Terminal PowerShell 7pwsh体验最顺。装好之后在终端里跑一个简单命令测试echo hello确保终端能正常输出再继续往下走。2.3 PATH 与 PowerShell 执行策略最多坑的两个点很多人在安装完成之后一敲codex就报“不是内部或外部命令”。原因就是 npm 的全局安装目录不在系统 PATH 里。先执行下面这条命令查看 npm 全局安装目录npm prefix -gWindows 上通常返回C:\Users\你的用户名\AppData\Roaming\npm。你需要确认这个目录已经存在于系统环境变量的 Path 里。操作路径右键“此电脑” → 属性 → 高级系统设置 → 环境变量 → 在“系统变量”里找到Path→ 编辑 → 检查有没有上面那个路径。没有就新建一条加上。另一个大坑是 PowerShell 执行策略。npm 全局安装的脚本本质上是.ps1文件而 Windows 默认的执行策略会拦截这些脚本表现就是运行codex或claude时提示“无法加载因为在此系统上禁止运行脚本”。解决办法是给当前用户放开受信任脚本的执行权限Set-ExecutionPolicy -Scope CurrentUser RemoteSigned这条命令的含义是允许运行本地创建的脚本远程下载的脚本必须有可靠签名。这是 Windows 上比较安全的一种策略组合不会把整个系统的防线全部打开。改完之后用Get-ExecutionPolicy查看当前值显示RemoteSigned就说明设置成功了。3. Codex 安装配置全流程3.1 安装与验证环境准备好之后Codex 的安装就一句话npm install -g openai/codex这个安装过程在 Windows 上一般很快。等它跑完打开新终端验证版本codex --version这里有个经验如果安装完之后敲codex提示找不到命令但版本检查又通过了——不对版本检查其实就是通过codex --version这行命令来做的所以不通过就是 PATH 没配好回到 2.3 去检查 npm 全局目录。安装过程中如果看到一堆npm warn不用慌大多数是对等依赖的提示只要最后没有npm error而且codex --version能输出版本号就说明装成功了。3.2 登录与 API Key 配置Codex 使用前需要鉴权官方给了两种方式。第一种是浏览器登录。在终端执行codex login它会唤起浏览器你登录 OpenAI 账号并授权授权之后终端会自动拿到凭据后面直接codex进入会话就能用。第二种是环境变量方式。直接把 API Key 写进环境变量适合有 OpenAI API 账号的同学也适合后续接入第三方模型这个后面会单独讲$env:OPENAI_API_KEY sk-你的key不过这样设置只在当前终端窗口生效关掉窗口就没了。想要永久生效用setx OPENAI_API_KEY sk-你的key注意setx只对之后新开的终端窗口生效当前窗口仍要自己手动设置或者直接重新开一个终端。3.3 常用命令和第一个任务Codex 有两类用法。直接敲codex回车进入交互式会话模式适合边聊边写如果只是临时让它干一件事用codex exec一步到位codex exec 用 Python 写一个斐波那契数列函数保存到 fib.py它会自动创建文件、写入代码然后告诉你结果。如果你想在项目里面用它先cd到项目目录再执行它会自动扫描项目结构上下文更准确。Codex 的配置文件在C:\Users\你的用户名\.codex\config.toml测下来最常用的几个配置项包括模型选择和输出风格。修改配置文件后重新打开会话才会生效。我自己实际用 Codex 最多的场景是解释代码和单点重构。比如把一段 200 行的函数拆成多个小函数或者给一段逻辑补上类型注解交给它处理又快又省心。注意一点如果项目路径里有中文或空格个别情况下它调用系统命令会出错建议把项目放在纯英文路径下。4. Claude Code 安装配置全流程4.1 安装与验证Claude Code 的安装同样走 npmnpm install -g anthropic-ai/claude-code装完验证claude --version能输出版本号就行了。顺便说一句如果你之前装过又遇到版本更新想升级直接更新全局包即可npm update -g anthropic-ai/claude-code4.2 鉴权方式Claude Code 的鉴权和 Codex 类似。首次运行claude会引导你登录 Anthropic 账号走浏览器授权流程。这种方式适合有 Claude 账号订阅的用户。如果你用的是 API Key 方式设置环境变量$env:ANTHROPIC_API_KEY sk-ant-你的key永久生效同样用setx。注意设置完要先重开终端再运行claude。另外新版本还支持通过ANTHROPIC_MODEL环境变量指定模型。这个看个人需要默认值通常已经很合理。4.3 常用命令和第一个任务进入交互式会话直接claude非交互执行单次任务用-p参数claude -p 读一下当前目录的代码给我写一份 READMEClaude Code 一进入项目就会先扫描目录结构读取关键文件然后才开始干活。我第一次用的时候让它解析一个中型项目它自己读了几十个文件后给出了重构方案这种深度上下文理解是它最值的部分。Claude Code 在 Windows 上会请求访问文件系统权限你需要在会话里确认它读写哪些目录。建议第一次跑的时候让它只访问当前项目目录不要给整盘权限。还有一个小技巧如果想让 Claude Code 输出结构化结果比如 JSON加上claude -p 任务描述 --output-format json这在写自动化脚本、批量生成代码时非常有用。5. VSCode 接入教程两种姿势把 AI 助手塞进编辑器5.1 最省事的方案VSCode 集成终端很多人以为接入 VSCode 一定要装什么扩展其实最顺手的方式就是直接用 VSCode 自带的集成终端。打开 VSCode按Ctrl\ 调出终端直接在项目目录下运行codex或claude就可以了。这个方案的最大好处是天然共享工作区。AI 修改文件之后你在编辑器里立刻就能看到 diff按CtrlZ就能撤销不需要在两个窗口之间来回切换。我自己目前主要用这个方案。如果你想让工作流更顺可以在项目根目录建一个.vscode/tasks.json把常用 AI 命令注册成任务用快捷键直接触发{ version: 2.0.0, tasks: [ { label: codex 审查当前改动, type: shell, command: codex exec \请审查当前 git diff指出潜在问题\, presentation: { reveal: always } } ] }保存后在命令面板搜“codex 审查当前改动”回车就能跑。这种工作流特别适合在提交代码前做一轮 AI 审查。5.2 扩展方案VSCode 里的图形界面入口如果你还是希望在编辑器侧边栏直接对话那就上扩展。Codex 这边直接在 VSCode 扩展市场搜索“Codex”找到 OpenAI 出品的官方扩展装上用你刚才配置好的账号或环境变量里的 API Key登录侧边栏就会出现一个 Codex 面板可以选中代码直接问它“帮我解释这段”或者“基于选中代码生成测试”非常方便。Claude Code 这边的情况不太一样官方主推的仍然是终端方案所以扩展市场里的 Claude Code 扩展大多是社区维护的功能参差不齐。我实际测下来与其装不稳定的扩展不如继续用集成终端。如果你实在想要侧边栏体验可以搜一下官方后续是否出了扩展注意看下载量和更新时间避免装到已经很久不维护的。5.3 贴一套我日常在用的工作流我现在的组合是VSCode 左侧看代码右侧开一个终终分屏跑 Claude Code另开一个终端跑 Codex。需要快速改一段代码时找 Codex需要做完整的模块级任务时找 Claude Code。两者共用一个项目目录互不冲突。动手前我会先建一个 git 分支确保 AI 产生的所有改动都在分支上随时可以回退。改完先git diff看一眼再提交。这个习惯帮我把 AI 编程变成完全可控的操作而不是心惊胆战地接受每处改动。6. 进阶统一接入 DeepSeek 等第三方模型6.1 原理环境变量覆盖接口地址Codex 和 Claude Code 都是开箱对接自家模型的但它们本身就支持通过环境变量来覆盖 API 地址和模型名称。这个能力给第三方模型接入留了空间——只要对方提供了兼容 OpenAI 或 Anthropic 格式的接口就能把这两个工具当成“壳”跑自己想用的模型。具体来说Codex 读取OPENAI_BASE_URL来替换默认的 OpenAI 接口地址Claude Code 读取ANTHROPIC_BASE_URL来替换默认的 Anthropic 接口地址。这也意味着你不需要放弃已经手熟的终端工具就能换用不同的模型服务。6.2 实操配置示例以 DeepSeek 为例。先到 DeepSeek 开放平台注册并创建 API Key然后配置环境变量。PowerShell 临时生效$env:OPENAI_BASE_URL https://api.deepseek.com $env:OPENAI_API_KEY 你的deepseek密钥永久生效setx OPENAI_BASE_URL https://api.deepseek.com setx OPENAI_API_KEY 你的deepseek密钥配置好之后直接运行codex exec测试codex exec 输出 hello world并保存为 hello.py如果正常返回就说明接入了。注意模型名称要选对方支持的比如deepseek-chat有些工具还需要在 config 里指定模型名否则可能报模型不存在。Claude Code 接入第三方模型的方法是同样的套路只是环境变量换成ANTHROPIC_BASE_URL。不同服务商提供的兼容端点格式略有差异有些直接给 Anthropic 兼容地址有些需要走一层转换层具体以服务商文档为准。6.3 切换工具与常见报错管理多套接入配置的时候有人会用 CC Switch 这类第三方配置切换工具。这个工具的好处是可以在多个模型和 API Key 之间一键切换不用每次改环境变量。但在 Windows 上偶尔会看到类似这样的报错cc switch local proxy failed while handling codex endpoint /responses. provi...这个报错的意思是CC Switch 在本地启动了一个转发服务Codex 请求经过它的时候出了问题。常见原因有两个一是本地转发服务没有正常启动或者地址写错了二是当前切换到的目标端点不支持 Codex 默认使用的/responses新接口。我的处理办法是先在 CC Switch 界面重新切换一次配置确认本地服务已经启动如果还不行就临时手动设置环境变量绕过它或者改用官方端点直连。这类工具更新迭代快遇到问题优先看它的 release notes 和 issue 区通常已经有人踩过同样的坑。7. 常见问题与排查技巧实录7.1 报错速查表下面这张表是我帮同事排查时最常命中的几个问题基本覆盖了 Windows 上装这两个工具 90% 的异常情况。现象可能原因解决办法codex或claude不是内部或外部命令npm 全局目录不在 PATH把npm prefix -g输出的目录加进系统 Path重开终端运行报“禁止运行脚本”PowerShell 执行策略限制Set-ExecutionPolicy -Scope CurrentUser RemoteSignednpm install报权限错误全局安装需要写权限以管理员身份运行终端或检查 npm 全局目录权限终端中文乱码代码页不是 UTF-8终端执行chcp 65001或写.bashrc里自动设置调用时报 401 / invalid x-api-keyAPI Key 写错了或环境变量未生效检查 Key 内容setx设置后必须先重开终端接口报 404 / not foundbase URL 路径错误或者模型不支持对应接口核对服务商的接口文档必要时加/v1路径或换模型CC Switch 报 local proxy failed本地转发服务未就绪或端点不兼容重新切换配置、检查本地服务或临时绕过直接连官方地址7.2 几个能省时间的经验第一个经验环境变量别总是手动敲。把常用的 Key 和接口地址写进项目下的.env文件用脚本统一加载。这样换项目的时候不会互相污染也能避免反复设置环境变量。第二个经验Windows 下工程目录尽量用纯英文路径中避免空格。虽然 Codex 和 Claude Code 对中文路径的兼容性在逐步改善但沙箱环境下调用系统工具偶尔还是会出问题没必要在这个环节浪费排查时间。第三个经验AI 动手前先git init这是最实在的保护。哪怕只是在临时目录里跑实验也先初始化一个 git 仓库让 AI 的每一步改动都有据可查。我遇到过它自己把配置文件改坏的场景没有 git 的话就只能手动回了。第四个经验遇到报错先看工具自己的日志。Codex 和 Claude Code 都会在用户目录下保留日志文件报错信息看不懂的时候直接打开日志看完整的堆栈通常比在网上搜更直接。我自己这两套工具现在都是常驻的一个负责快速响应、一个负责干长链路活互补着用效率很高。最后再分享一个小小的体会AI 编程工具再好前提是你自己对项目有清晰的判断力——它改的每一行代码都要能看懂都值得追问一个为什么。工具负责加速方向仍然在你的手里。