企业官网建设流程全解析

从一年前开始，我就在 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 目录里”，它会自己拆解步骤、逐个完成。

1.2 为什么 Windows 用户需要单独一篇教程

官方文档默认以 macOS 和 Linux 为主，很多命令在 Windows 上的表现其实不太一样。最典型的就是全局安装路径的问题：macOS 和 Linux 上 npm 全局包装完，命令自动就躺在/usr/local/bin里，终端随便一敲就有。Windows 不一样，npm 全局目录默认在用户目录的 AppData 下面，如果这个目录没加进系统 PATH，装得再多也永远是“codex 不是内部或外部命令”。

再加上 Windows 上有两套终端体系——传统的 Command Prompt 和 PowerShell，两者的环境变量语法、脚本执行策略完全不同。很多教程直接甩一段export OPENAI_API_KEY=xxx，那是 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 LTS，18 也能用，但低于 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 Terminal

Windows 自带的终端交互体验确实一般，尤其是历史记录和复制粘贴。建议去微软商店装一个 Windows Terminal，免费，装完设置里把默认终端应用改成 Windows Terminal，默认配置文件可以根据自己习惯选 PowerShell 7 或者系统自带的 Windows PowerShell。

这里有个小建议：如果你平时用 PowerShell 5，后续执行 npm 脚本时偶尔会遇到执行策略拦截。两个终端对脚本的处理策略略有不同，Windows Terminal 本身只是界面，真正影响行为的是底层用的哪个 Shell。我个人的组合是 Windows Terminal + PowerShell 7（pwsh），体验最顺。

装好之后，在终端里跑一个简单命令测试：

echo "hello"

确保终端能正常输出，再继续往下走。

2.3 PATH 与 PowerShell 执行策略：最多坑的两个点

很多人在安装完成之后，一敲codex就报“不是内部或外部命令”。原因就是 npm 的全局安装目录不在系统 PATH 里。

先执行下面这条命令，查看 npm 全局安装目录：

npm prefix -g

Windows 上通常返回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 的安装同样走 npm：

npm install -g @anthropic-ai/claude-code

装完验证：

claude --version

能输出版本号，就行了。

顺便说一句，如果你之前装过，又遇到版本更新想升级，直接更新全局包即可：

npm update -g @anthropic-ai/claude-code

4.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 "读一下当前目录的代码，给我写一份 README"

Claude 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，按Ctrl+Z就能撤销，不需要在两个窗口之间来回切换。我自己目前主要用这个方案。

如果你想让工作流更顺，可以在项目根目录建一个.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% 的异常情况。

7.2 几个能省时间的经验

第一个经验：环境变量别总是手动敲。把常用的 Key 和接口地址写进项目下的.env文件，用脚本统一加载。这样换项目的时候不会互相污染，也能避免反复设置环境变量。

第二个经验：Windows 下工程目录尽量用纯英文，路径中避免空格。虽然 Codex 和 Claude Code 对中文路径的兼容性在逐步改善，但沙箱环境下调用系统工具偶尔还是会出问题，没必要在这个环节浪费排查时间。

第三个经验：AI 动手前先git init，这是最实在的保护。哪怕只是在临时目录里跑实验，也先初始化一个 git 仓库，让 AI 的每一步改动都有据可查。我遇到过它自己把配置文件改坏的场景，没有 git 的话就只能手动回了。

第四个经验：遇到报错先看工具自己的日志。Codex 和 Claude Code 都会在用户目录下保留日志文件，报错信息看不懂的时候，直接打开日志看完整的堆栈，通常比在网上搜更直接。

我自己这两套工具现在都是常驻的，一个负责快速响应、一个负责干长链路活，互补着用效率很高。最后再分享一个小小的体会：AI 编程工具再好，前提是你自己对项目有清晰的判断力——它改的每一行代码都要能看懂，都值得追问一个为什么。工具负责加速，方向仍然在你的手里。