🖥️ Windows 平台

（一）安装Node.js环境

Windows安装方法：

方法一：官网下载（推荐）

1. 打开浏览器访问：https://nodejs.org/zh-cn/download
2. 点击 "LTS" 版本进行下载（版本号要大于18，推荐长期支持版本）
3. 下载完成后双击 .msi 文件
4. 按照安装向导完成安装，保持默认设置即可

方法二：包管理器安装

💡 提示

Winget、Chocolatey、Scoop选一个使用，具体选哪个看你环境。

使用 Winget

Windows 11 或 Windows 10 最新版：

winget install OpenJS.NodeJS.LTS

或者使用 Chocolatey

如使用Chocolatey需要先安装 Chocolatey

choco install nodejs-lts

或者使用 Scoop

scoop install nodejs-lts

验证安装

打开命令提示符或 PowerShell，执行：

node --version
npm --version

如果显示版本号（如 v18.x.x 或更高），说明安装成功。

---

（二）安装 Claude Code

方法一：NPM 安装

1. 打开命令提示符(CMD) 或PowerShell，运行：

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

2. 验证安装

claude --version

3. 配置环境变量

如果是PowerShell：

[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxx", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.aicy.pro", "User")

如果是CMD：

setx ANTHROPIC_AUTH_TOKEN "sk-xxx"
setx ANTHROPIC_BASE_URL "https://api.aicy.pro"

💡 提示

请注意将 sk-xxx 替换为你自己的专属key！ 设置好后，重启终端以让环境变量生效。

4. 启动Claude

在终端，进入（cd 目录）到项目目录或在任意目录，输入命令 claude 即可启动使用。

方法二：Native Install

1. 打开命令提示符(CMD) 或PowerShell，运行：

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

2. 验证安装

claude --version

3. 配置环境变量

如果是PowerShell：

[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxx", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.aicy.pro", "User")

如果是CMD：

setx ANTHROPIC_AUTH_TOKEN "sk-xxx"
setx ANTHROPIC_BASE_URL "https://api.aicy.pro"

💡 提示

请注意将 sk-xxx 替换为你自己的专属key！ 设置好后，重启终端以让环境变量生效。

4. 启动Claude

在终端，进入（cd 目录）到项目目录或在任意目录，输入命令 claude 即可启动使用。

---

（三）配置 Claude Code变量环境

通过文件设置（推荐）

编辑文件 ~/.claude/settings.json 文件添加以下内容(如果没有settings.json文件，请自行创建，不需要时可随意删除，不影响claude使用)：

windows下路径为: ​C:/Users/你的用户名/.claude​

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_BASE_URL": "https://api.aicy.pro",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

---

（四）开始使用 Claude Code

现在你可以开始使用 Claude Code 了！

启动 Claude Code：

claude

在特定项目中使用先cd进入你的项目目录：

cd C:\path\to\your\project

启动 Claude Code：

claude

---

Windows 安装常见问题解决

安装时提示 "permission denied" 错误

这通常是权限问题，尝试以下解决方法：

• 以管理员身份运行 PowerShell
• 或者配置 npm 使用用户目录：npm config set prefix %APPDATA%\npm

PowerShell 执行策略错误

如果遇到执行策略限制，运行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser