Claude Code Windows 安装指南
专为 Windows 用户设计的 Claude Code 详细安装教程。
第一步:安装 Node.js
Claude Code 需要 Node.js 运行环境,请参考详细的安装指南:
👉 Node.js 安装指南 - Windows 部分 - 包含官网下载和 Chocolatey 两种方法
ℹ️
安装完成后请返回此页面继续后续步骤。
第二步:安装 Claude Code
打开 PowerShell 或命令提示符:
# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code
安装完成后验证:
# 检查 Claude Code 版本
claude --version
⚠️
如果遇到权限错误,请以管理员身份运行 PowerShell 再执行安装命令。
第三步:配置环境变量
方法一:使用 PowerShell 设置
临时设置(当前会话)
$env:ANTHROPIC_BASE_URL = "https://cc.aihezu.dev/api"
$env:ANTHROPIC_AUTH_TOKEN = "你的API密钥"
永久设置(推荐)
# 设置用户级环境变量(推荐)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://cc.aihezu.dev/api", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API密钥", [System.EnvironmentVariableTarget]::User)
# 或设置系统级环境变量(需要管理员权限)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://cc.aihezu.dev/api", [System.EnvironmentVariableTarget]::Machine)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API密钥", [System.EnvironmentVariableTarget]::Machine)
方法二:使用图形界面设置
- 按
Win + R
键,输入sysdm.cpl
,按回车 - 在系统属性窗口中,点击 "高级" 选项卡
- 点击 "环境变量" 按钮
- 在 "用户变量" 区域点击 "新建"
- 分别添加以下变量:
- 变量名:
ANTHROPIC_BASE_URL
,变量值:https://cc.aihezu.dev/api
- 变量名:
ANTHROPIC_AUTH_TOKEN
,变量值:你的API密钥
- 变量名:
🔐
重要:设置环境变量后需要重新启动命令提示符或 PowerShell 才能生效。
第四步:验证安装
检查环境变量
重新打开 PowerShell:
# 检查环境变量是否设置正确
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN
测试 Claude Code
# 测试基本功能
claude "Hello, Claude!"
成功的话,你会看到 Claude 的回复。
⚙️ 第五步:VS Code 集成
详细的 VS Code 集成配置请参考:
👉 VS Code 集成指南 - 完整的编辑器集成教程
高级配置
创建配置文件
# 创建 Claude 配置目录
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude"
# 创建配置文件
@"
{
"editor": "vscode",
"theme": "auto",
"autoSave": true,
"maxTokens": 4096,
"suggestions": {
"enabled": true,
"maxSuggestions": 5
}
}
"@ | Out-File -FilePath "$env:USERPROFILE\.claude\config.json" -Encoding UTF8
设置代理(如需要)
# 设置 HTTP 代理
claude config set proxy.http http://proxy.example.com:8080
# 设置 HTTPS 代理
claude config set proxy.https https://proxy.example.com:8080
故障排除
遇到安装或使用问题?查看详细的解决方案:
👉 故障排除指南 - 全面的问题诊断和解决方案
🗑️ 卸载指南
如需卸载 Claude Code,请参考:
👉 卸载指南 - 完整的卸载和清理说明
第一个项目
创建测试项目
# 创建新目录
mkdir "$env:USERPROFILE\my-first-claude-project"
cd "$env:USERPROFILE\my-first-claude-project"
# 初始化项目
claude init
# 开始对话
claude "帮我创建一个 Python Hello World 程序"
在 VS Code 中使用
详细的 VS Code 使用请参考 VS Code 集成指南
获取支持
遇到问题?我们提供专业技术支持:
🎉
恭喜! 你已在 Windows 上成功安装 Claude Code,现在可以开始 AI 辅助编程了!
相关文档
- 快速开始 - 学习基本使用流程
- VS Code 集成 - 编辑器集成配置
- 故障排除 - 解决常见问题
- 卸载指南 - 完整卸载说明
- 选择套餐 - 了解服务套餐