Claude Code Windows 环境配置

详细指导如何在 Windows 系统上配置 Claude Code 开发环境,包括 Node.js 安装、环境变量配置等。

Windows 系统要求

  • Windows 10 或更高版本
  • 管理员权限(用于安装软件)
  • 至少 2GB 可用磁盘空间

安装 Node.js

方法一:官方安装包(推荐)

第一步:下载 Node.js

访问 Node.js 官网 下载 LTS 版本的 Windows 安装包(.msi 文件)

第二步:运行安装程序

  1. 双击下载的 .msi 文件
  2. 点击 "Next" 继续安装
  3. 接受许可协议
  4. 选择安装路径(建议使用默认路径)
  5. 确保勾选 "Add to PATH" 选项
  6. 点击 "Install" 开始安装

第三步:验证安装

打开命令提示符(cmd)或 PowerShell,运行:

cmd
node --version
npm --version

方法二:使用 Chocolatey

PowerShell (管理员)
# 安装 Chocolatey(如果未安装)
Set-ExecutionPolicy Bypass -Scope Process -Force
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072
iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))

# 安装 Node.js
choco install nodejs

方法三:使用 Winget

cmd
winget install OpenJS.NodeJS

环境变量配置

临时配置(当前会话有效)

set ANTHROPIC_BASE_URL=https://i7dc.com/api
set ANTHROPIC_AUTH_TOKEN=你的key
cd your-project-folder
claude

永久配置(推荐)

方法一:通过系统属性配置

  1. 右键点击"此电脑" → "属性"
  2. 点击"高级系统设置"
  3. 在"系统属性"窗口中点击"环境变量"
  4. 在"用户变量"或"系统变量"中点击"新建"
  5. 添加以下变量:
    • 变量名:ANTHROPIC_BASE_URL,变量值:https://i7dc.com/api
    • 变量名:ANTHROPIC_AUTH_TOKEN,变量值:你的key
  6. 点击"确定"保存

方法二:使用 PowerShell 配置

PowerShell (管理员)
# 为当前用户设置环境变量
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://i7dc.com/api", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的key", "User")

# 验证设置
[Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL", "User")
[Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "User")

Windows Terminal 配置(推荐)

为了更好的使用体验,建议安装 Windows Terminal:

PowerShell
# 通过 Microsoft Store 安装
winget install Microsoft.WindowsTerminal

# 或者通过包管理器安装
choco install microsoft-windows-terminal

配置 Windows Terminal 启动 Profile

  1. 打开 Windows Terminal
  2. Ctrl + , 打开设置
  3. 在左侧菜单选择"配置文件" → "添加新配置文件"
  4. 配置如下:
    • 名称:Claude Code
    • 命令行:powershell.exe
    • 启动目录:你的项目目录
    • 在高级设置中添加环境变量

常见问题解决

问题 1:node 命令无法识别

解决方案:

cmd
# 检查 PATH 环境变量
echo %PATH%

# 手动添加 Node.js 到 PATH(临时)
set PATH=%PATH%;C:\Program Files\nodejs

问题 2:npm 安装速度慢

解决方案:

cmd
# 使用国内镜像源
npm config set registry https://registry.npmmirror.com

问题 3:PowerShell 执行策略限制

解决方案:

PowerShell (管理员)
# 临时允许执行脚本
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

# 永久设置(需要管理员权限)
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine

问题 4:防火墙阻止连接

解决方案:

  1. 打开 Windows 防火墙设置
  2. 点击"允许应用或功能通过 Windows 防火墙"
  3. 找到 Node.js 并勾选"专用"和"公用"网络

验证配置

配置完成后,重启命令提示符或 PowerShell,运行以下命令验证:

cmd
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_AUTH_TOKEN%
claude --version

如果输出正确的环境变量值和版本信息,说明配置成功!

下一步

环境配置完成后,你可以:

  1. 在任意项目目录下运行 claude 开始使用
  2. 选择你喜欢的主题
  3. 确认安全须知并信任工作目录
  4. 开始与 AI 编程搭档协作!🚀
与AI一起带来无限的创新,无尽的机遇
关于
功能特性
使用文档
定价方案
联系我们
条款和政策
使用条款
隐私条款
特定商取引法