前言

Claude Code 是 Anthropic 推出的 AI 编程助手，可以直接在终端中理解整个代码库、编写代码、调试、运行测试。本文将带你完成 Windows 下的安装配置，并结合 VS Code 搭建高效的 AI 辅助编程环境。

系统要求

• Windows 10/11 64位
• Node.js 18+（推荐 22.x）
• Git for Windows
• Anthropic API Key（需要付费，按量计费）

第一步：安装 Node.js 和 Git

安装 Node.js

1. 访问 nodejs.org 下载 Windows Installer
2. 安装时勾选 "Automatically install the necessary tools"
3. 验证安装：

node --version
npm --version

安装 Git

1. 访问 git-scm.com 下载
2. 安装时选择 "Use Git from the command line and also from 3rd-party software"
3. 其他选项保持默认即可
4. 验证安装：

git --version

第二步：获取 Anthropic API Key

1. 访问 console.anthropic.com 注册账号
2. 进入 API Keys 页面，创建新 Key
3. 充值预付费（建议先充 $20 试试）

⚠️ 重要：API Key 只显示一次，请立即保存到安全位置。

第三步：安装 Claude Code

打开 PowerShell 或命令提示符：

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

安装完成后验证：

claude --version

第四步：配置 API Key

设置环境变量（PowerShell）：

# 临时设置（当前会话有效）
set ANTHROPIC_API_KEY=sk-ant-xxx你的key

# 永久设置（推荐）
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-xxx你的key", "User")

# 验证
echo $env:ANTHROPIC_API_KEY

也可以通过配置文件设置（更推荐）：

claude config set ANTHROPIC_API_KEY sk-ant-xxx你的key

第五步：开始使用

# 进入你的项目目录
cd C:\Users\你的用户名\Projects\my-project

# 启动 Claude Code
claude

首次运行会要求授权，之后你就可以在终端中与 Claude 对话，让它帮你：

• 理解和解释代码
• 编写新功能
• 修复 Bug
• 运行和编写测试
• 重构代码

进阶技巧

与 VS Code 配合使用

安装 Claude Code VS Code 扩展（在扩展市场搜索 "Claude Code"），可以在编辑器内直接使用。

Claude Code 常用命令

# 启动（在项目目录中）
claude

# 直接提问题
claude "解释这个项目的架构"

# 用特定模型
claude --model claude-sonnet-4-20250514

# 查看帮助
claude --help

项目级配置（.claude.yaml）

在项目根目录创建 .claude.yaml 文件：

# .claude.yaml
model: claude-sonnet-4-20250514
context:
  include:
    - "src/**/*.ts"
    - "README.md"
  exclude:
    - "node_modules/**"
    - "dist/**"

国内用户注意事项

• Anthropic API 在国内可能无法直连，需要配置代理
• 设置代理环境变量：set HTTPS_PROXY=http://127.0.0.1:7890
• Claude Code 按 token 计费，复杂度跟整个项目上下文有关，建议先从小项目开始尝试
• 费用参考：一个中等规模项目的一次对话大约 $0.50 ~ $5