Claude Code 安装配置指南：Windows 篇
TLDR: 本文详细介绍如何在 Windows 上安装和配置 Claude Code。支持原生安装（PowerShell/CMD/WinGet）和 WSL 两种方式，原生安装更简单，WSL 提供与 Linux 一致的终端体验。全文覆盖环境准备、安装步骤、代理配置和常见问题排查。
什么是 Claude Code
Claude Code 是 Anthropic 推出的官方 CLI 工具，让你可以在终端中直接与 Claude 交互进行软件开发。它支持：
- 直接在终端中与 Claude 对话
- 读取、编写和修改代码文件
- 执行 Shell 命令
- 搜索和分析代码库
- 集成 Git 工作流
与传统的 Web 界面相比，Claude Code 更适合开发者：无需复制粘贴代码，Claude 可以直接操作你的项目文件。
系统要求
| 组件 | 要求 |
|---|---|
| 操作系统 | Windows 10 2004 或更高版本 |
| 网络 | 能访问 claude.ai（或配置 API 代理） |
| 终端 | PowerShell、CMD 或 Windows Terminal |
注意：原生安装方式不需要预装 Node.js，安装脚本会自动处理依赖。
方式一：原生安装（推荐）
原生安装支持自动更新，是官方推荐的安装方式。
PowerShell 安装
以管理员身份打开 PowerShell，执行：
irm https://claude.ai/install.ps1 | iex
验证安装
安装完成后，打开新的终端窗口，输入：
claude --version
如果显示版本号，说明安装成功。输入 claude 启动 Claude Code。
方式二：WSL 安装
适用场景：如果你需要与 macOS/Linux 完全一致的终端体验，或需要使用 Linux 特定工具，可以选择 WSL 方式。
步骤 1：启用 Windows 子系统功能
- 按
Win + S搜索「启用或关闭 Windows 功能」 - 找到「适用于 Linux 的 Windows 子系统」选项
- 勾选后点击「确定」
- 等待安装完成，按提示重启电脑
步骤 2：安装 WSL
⚠️ 注意：请使用 PowerShell 或 Windows Terminal，不要使用 CMD。
打开 PowerShell（以管理员身份），执行：
wsl --install
安装完成后系统会提示重启，按要求重启电脑。
步骤 3：安装 Ubuntu 发行版
重启后，打开 PowerShell 或 Windows Terminal：
wsl --install -d Ubuntu
安装完成后会要求创建 Linux 用户名和密码。
💡 密码输入提示：输入密码时屏幕不会显示任何字符，这是 Linux 的安全特性，正常输入后按回车即可。
步骤 4：进入 WSL 终端
两种方式打开 WSL：
方式一：在 Windows Terminal 标签栏右侧的下拉菜单中选择「Ubuntu」
方式二：在 PowerShell 中直接输入：
wsl
步骤 5：配置网络代理（可选）
⚠️ 重要：WSL 终端的网络与 Windows 系统网络是独立的，需要单独配置代理。
根据你的代理软件选择对应端口：
| 代理软件 | 默认端口 |
|---|---|
| Clash | 7890 |
| V2Ray | 10808 |
| Shadowsocks | 1080 |
将以下命令中的端口号替换为你的代理端口：
# 设置代理环境变量（以 7890 端口为例）
echo 'export http_proxy=http://127.0.0.1:7890 https_proxy=http://127.0.0.1:7890 all_proxy=socks5://127.0.0.1:7890' >> ~/.bashrc && source ~/.bashrc
验证代理是否生效：
curl -I https://www.google.com
如果 127.0.0.1 不通，尝试使用 Windows 主机 IP：
# 获取 Windows 主机 IP
export WIN_HOST=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}')
export http_proxy=http://$WIN_HOST:7890
export https_proxy=http://$WIN_HOST:7890
步骤 6：安装基础开发工具
更新包管理器并安装必要工具：
sudo apt update && sudo apt install -y git curl unzip
步骤 7：安装 Claude Code
执行官方安装脚本：
curl -fsSL https://claude.ai/install.sh | bash
💡 提示：安装脚本会自动处理依赖，无需手动安装 Node.js。安装过程可能需要几分钟，请耐心等待。
步骤 8：启动并配置 Claude Code
首次启动：
claude
首次启动会有多个初始化设置：
- 认证方式：选择登录 Anthropic 账号或使用 API Key
- 主题设置：选择深色/浅色主题
- 权限设置：选择默认权限级别
一路按回车使用默认值即可。
步骤 9：验证安装
在 Claude Code 中输入：
hi
如果 Claude 正常回复，说明安装成功！
按 Ctrl + C 两次可退出 Claude Code。
可以使用 claude doctor 命令检查安装状态和版本信息。
高级配置
配置 API Key
Claude Code 支持多种认证方式：
方式一：OAuth 登录（推荐）
首次启动时选择「Login with Anthropic」，会自动打开浏览器完成认证。
方式二：API Key
如果你有 Anthropic API Key：
PowerShell（原生安装）：
# 临时设置
$env:ANTHROPIC_API_KEY = "your-api-key-here"
# 持久化（用户级别环境变量）
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "your-api-key-here", "User")
WSL（Linux 环境）：
# 设置环境变量
export ANTHROPIC_API_KEY=your-api-key-here
# 添加到配置文件持久化
echo 'export ANTHROPIC_API_KEY=your-api-key-here' >> ~/.bashrc
source ~/.bashrc
方式三：配置第三方 API 代理
如果使用第三方 API 代理服务：
# 设置 API 基础 URL
export ANTHROPIC_BASE_URL=https://your-proxy.com/v1
# 设置 API Key
export ANTHROPIC_API_KEY=your-proxy-api-key
配置文件位置
| 安装方式 | 配置目录 |
|---|---|
| 原生安装 | %USERPROFILE%\.claude\ |
| WSL 安装 | ~/.claude/ |
主要配置文件：
settings.json：全局设置CLAUDE.md：自定义系统提示词项目目录/.claude/settings.local.json：项目级设置
自定义系统提示词
创建或编辑 CLAUDE.md：
# My Custom Instructions
- 使用中文回复
- 代码注释使用英文
- 优先使用 TypeScript
IDE 集成
VS Code 集成
Claude Code 可以与 VS Code 终端无缝配合：
- 在 VS Code 中打开项目
- 打开终端（
Ctrl +） - 运行
claude
Cursor 集成
Cursor 用户可以直接在 Cursor 终端中使用 Claude Code。
常用命令速查
基本操作
| 命令 | 说明 |
|---|---|
claude |
启动 Claude Code |
claude --help |
查看帮助信息 |
claude --version |
查看版本号 |
claude doctor |
检查安装状态 |
claude -c "your prompt" |
单次对话模式 |
会话内命令
| 命令 | 说明 |
|---|---|
/help |
查看帮助 |
/clear |
清除上下文 |
/compact |
压缩上下文 |
/cost |
查看当前会话成本 |
/model |
切换模型 |
/config |
打开配置 |
快捷键
| 快捷键 | 说明 |
|---|---|
Ctrl + C |
中断当前操作 |
Ctrl + C × 2 |
退出 Claude Code |
Ctrl + L |
清屏 |
↑ / ↓ |
浏览历史输入 |
Tab |
自动补全 |
常见问题排查
Q1: PowerShell 执行策略阻止脚本运行
问题：执行安装脚本时提示「无法加载文件，因为在此系统上禁止运行脚本」
解决方案：
# 以管理员身份运行 PowerShell，执行：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Q2: WSL 安装失败
问题：wsl --install 报错
解决方案：
- 确保 Windows 版本支持 WSL（Windows 10 2004 或更高版本）
- 在 BIOS 中启用虚拟化功能（VT-x/AMD-V）
- 手动启用 Windows 功能后重试
Q3: WSL 中网络不通
问题：WSL 中无法访问网络或代理不生效
解决方案：
- 确保 Windows 代理软件开启了「允许局域网连接」
- 检查 WSL 中的代理端口是否正确
- 尝试使用 Windows 主机 IP 而非 127.0.0.1：
# 获取 Windows 主机 IP
export WIN_HOST=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}')
export http_proxy=http://$WIN_HOST:7890
export https_proxy=http://$WIN_HOST:7890
Q4: Claude Code 启动后无响应
问题：启动后长时间无响应或报错
排查步骤：
- 检查网络连接：
curl -I https://claude.ai（WSL）或浏览器访问 - 检查 API Key 是否正确配置
- 查看详细日志：
claude --verbose - 重置配置：删除配置目录后重新启动
Q5: 如何更新 Claude Code
根据安装方式选择更新方法：
# 原生安装（自动更新，通常无需手动操作）
# 如需强制更新，重新执行安装脚本：
irm https://claude.ai/install.ps1 | iex
# WinGet 安装
winget upgrade Anthropic.ClaudeCode
WSL 环境：
# 重新执行安装脚本
curl -fsSL https://claude.ai/install.sh | bash
Q6: 如何完全卸载
原生安装：
# WinGet 安装
winget uninstall Anthropic.ClaudeCode
# 清理配置文件
Remove-Item -Recurse -Force "$env:USERPROFILE\.claude"
WSL 安装：
rm -rf ~/.claude
rm -f /usr/local/bin/claude
最佳实践
1. 选择合适的安装方式
- 日常开发：原生安装更简单，自动更新
- 需要 Linux 工具链：选择 WSL 方式
- 团队协作：统一使用 WSL 确保环境一致
2. 使用项目级配置
为每个项目创建 .claude/ 目录，存放项目特定的配置和提示词。
3. 配合 Git 使用
Claude Code 与 Git 集成良好，可以直接进行 commit、创建 PR 等操作。建议在 Git 仓库中使用。
4. 合理使用上下文
- 使用
/clear清除无关上下文 - 使用
/compact压缩长对话 - 大型项目中善用
@file引用
5. 安全注意事项
- 不要在公共环境中暴露 API Key
- 定期检查 Claude Code 的文件操作权限
- 敏感项目建议使用受限权限模式
总结
完成本指南后，你应该能够：
✅ 使用原生方式（PowerShell/CMD/WinGet）安装 Claude Code ✅ 通过 WSL 安装配置 Claude Code ✅ 配置网络代理和 API Key ✅ 解决常见的安装和使用问题
Claude Code 是一个强大的 AI 编程助手，熟练使用后可以显著提升开发效率。如有问题，可参考 官方文档 或在 GitHub Issues 提交反馈。