Windows 本地开发环境配置

这篇指南适合准备在 Windows 电脑上使用 Claude Code、Codex CLI，或让 Syfo 本地 Agent 复用这些命令行工具的用户。

完成后，你的电脑将具备：

• Node.js 与 npm；
• Claude Code；
• Codex CLI；
• TokenSwitch API Key；
• CC Switch 中可切换的 Claude Code / Codex 配置。

按顺序操作

每执行完一节，都先运行该节的检查命令。看到正确结果后，再继续下一节。

准备工作

你需要：

• Windows 10 或 Windows 11；
• 可以安装软件的 Windows 账号；
• PowerShell、Windows Terminal 或其他终端；
• 一个可用的 TokenSwitch 账号，或组织提供的其他兼容模型服务；
• Git for Windows。Claude Code 在 Windows 上需要 Git Bash；如果尚未安装，请先完成 Git for Windows 的默认安装。

第三方服务与密钥

TokenSwitch 和 CC Switch 是第三方服务或工具。请先确认它们符合你所在组织的安全要求。API Key 不要发到 Syfo 频道、公开群聊或代码仓库中。

1. 打开 PowerShell

1. 点击 Windows 开始菜单。
2. 搜索 PowerShell 或 Windows Terminal。
3. 打开应用。

后续命令都在 PowerShell 中执行。每次只复制一个代码块并回车。

2. 安装 Node.js 与 npm

下载 Node.js

打开 Node.js 官方下载页，选择 Windows 的 LTS 版本和 .msi 安装包。

普通 Intel / AMD Windows 电脑选择 x64；只有 Windows ARM 设备才选择 ARM64。

完成安装

1. 双击下载的 .msi 文件。
2. 按安装向导点击 Next。
3. 保持默认安装路径和默认组件。
4. 点击 Install，完成后点击 Finish。
5. 关闭 PowerShell，再打开一个新窗口。

检查安装结果

node -v
npm -v

两条命令都显示版本号，说明 Node.js 和 npm 已安装成功。

3. 可选：切换 npm 镜像源

如果你所在网络访问 npm 官方源很慢，可以切换到 npmmirror：

npm config set registry https://registry.npmmirror.com

检查当前镜像：

npm config get registry

预期输出：

https://registry.npmmirror.com/

如果官方源在你的网络中可以正常使用，可以跳过这一节。需要恢复 npm 官方源时执行：

npm config delete registry

4. 安装 Codex CLI

在 PowerShell 中执行：

npm install -g @openai/codex@latest

检查版本：

codex --version

Windows 兼容性

Codex CLI 的原生 Windows 支持仍可能遇到兼容性问题。如果你在原生 PowerShell 中无法正常运行，可以改用 WSL。已能正常进入 Codex 的用户不需要切换环境。

5. 安装 Claude Code

在 PowerShell 中执行：

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

检查版本：

claude --version

再运行诊断：

claude doctor

如果 Claude Code 没有自动找到 Git Bash，可以设置路径后重新打开 PowerShell：

[Environment]::SetEnvironmentVariable(
  "CLAUDE_CODE_GIT_BASH_PATH",
  "C:\Program Files\Git\bin\bash.exe",
  "User"
)

命令无法识别

如果 PowerShell 提示 codex 或 claude 不是内部或外部命令，先关闭当前窗口，再打开一个新的 PowerShell 后重试。

6. 注册 TokenSwitch 并创建令牌

如果你的组织使用 TokenSwitch，打开 TokenSwitch 注册并登录。

申请额度

不同组织的开通流程可能不同。通常需要把 TokenSwitch 用户名发给你所在组织的管理员，由管理员配置额度。不要把 API Key 发给管理员或其他人。

创建两个令牌

进入 令牌管理 → 添加令牌，建议分别创建：

用途	令牌分组	说明
Claude Code	cc	Claude Code 专用
Codex	codex	Codex 专用

创建后分别复制 API Key，临时保存在安全的密码管理工具中。不要写入文档、聊天消息或 Git 仓库。

7. 安装 CC Switch

打开 CC Switch 最新版发布页。

普通 Intel / AMD Windows 电脑下载文件名包含 Windows.msi 的安装包；Windows ARM 设备下载 Windows-arm64.msi。不要依赖本文中的固定版本号，以发布页显示的最新版为准。

1. 双击下载的 .msi 文件。
2. 按安装向导完成安装。
3. 从开始菜单打开 CC Switch。

8. 在 CC Switch 中添加配置

在 CC Switch 中点击 添加供应商 / Add Provider，分别为 Claude Code 和 Codex 添加配置。

工具	API Key	Base URL / 请求地址	令牌分组	模型
Claude Code	TokenSwitch 中 cc 分组的令牌	https://tokenswitch.cc	cc	选择组织已开通的 Claude 模型
Codex	TokenSwitch 中 codex 分组的令牌	https://tokenswitch.cc/v1	codex	选择组织已开通的 Codex 模型；如已开放，可选 gpt-5.6-sol

如果你的组织提供了不同的 Base URL 或分组规则，以组织管理员提供的配置为准。

配置完成后：

1. 在 CC Switch 中选中要使用的配置。
2. 点击 启用。
3. 关闭 PowerShell，再打开一个新窗口。

9. 最终验证

先检查基础工具：

node -v
npm -v
codex --version
claude --version

然后分别启动：

claude

退出 Claude Code 后，再执行：

codex

两个工具都能进入交互界面并完成一次简单问答，说明配置成功。

完成检查清单

• [ ] node -v 和 npm -v 能显示版本号。
• [ ] codex --version 能显示版本号。
• [ ] claude --version 和 claude doctor 能正常运行。
• [ ] TokenSwitch 账号已获得可用额度。
• [ ] 已分别创建 cc 与 codex 分组令牌。
• [ ] CC Switch 已安装并启用正确配置。
• [ ] Claude Code 与 Codex CLI 都能完成一次请求。

常见问题

npm 安装很慢或失败

查看当前镜像：

npm config get registry

如果网络访问 npm 官方源较慢，可重新设置 npmmirror：

npm config set registry https://registry.npmmirror.com

codex 或 claude 无法识别

先重新打开 PowerShell。如果仍然失败，查看 npm 全局安装目录：

npm config get prefix

确认输出目录已经加入 Windows 用户环境变量 PATH。

Claude Code 找不到 Git Bash

确认 Git for Windows 已安装，并检查文件是否存在：

Test-Path "C:\Program Files\Git\bin\bash.exe"

如果输出 True，按前文设置 CLAUDE_CODE_GIT_BASH_PATH 后重新打开 PowerShell。

API Key 不可用

依次检查：

• TokenSwitch 后台是否已有可用额度；
• API Key 是否复制完整；
• Claude Code 是否使用 cc 分组令牌；
• Codex 是否使用 codex 分组令牌；
• Claude Code Base URL 是否为 https://tokenswitch.cc；
• Codex Base URL 是否为 https://tokenswitch.cc/v1；
• CC Switch 中当前启用的是不是刚配置的供应商。

如果仍然失败，只向组织管理员提供错误提示和请求时间，不要发送完整 API Key。

下一步：让 Syfo Agent 使用本机工具

本地电脑完成这些配置后，可以把它连接到 Syfo，并在这台电脑上创建 Agent。Agent 能否使用 Claude Code、Codex、仓库和其他工具，取决于它所在电脑的实际安装与权限。

继续阅读：电脑与 Agent 运行环境。