Claude Code 国内最新落地实战：Windows 下保姆级安装指南（2025避坑版）

字数: (2963)

阅读: (15)

0

前言：

最近技术圈最火的是什么？无疑是 Anthropic 推出的 Claude Code。
即使你已经习惯了 Cursor 或 Windsurf，Claude Code 依然会让你眼前一亮：它是一个直接运行在终端里的 Agent。它不只是“给建议”，而是能直接读取你的整个项目、运行终端命令、创建文件，甚至自己跑测试修 Bug。
但作为国内的 Windows 用户，想尝鲜并不容易：“连接超时”、“API 鉴权失败”、“PowerShell 脚本不执行”……这些坑我都替大家踩了一遍。今天，就给大家带来一份真正能跑通的保姆级教程。

一、准备工作：磨刀不误砍柴工在开始敲命令之前，我们需要确认三个核心要素。缺了任何一个，后面的步骤都会报错。

1. 核心依赖：Node.jsClaude Code 是基于 Node.js 开发的工具。

检查方法：打开 CMD 或 PowerShell，输入 node -v。
要求：版本必须在 Node.js 18 或更高版本。
没有安装？ 去 Node.js 官网下载 LTS（长期支持）版本，一路“Next”安装即可。

2. 灵魂核心：Anthropic API KeyClaude Code 也是要烧钱的（虽然它很强）。你需要一个有效的 Anthropic API Key。

前往获取 Anthropic Claude Code API Key 。
充值一定金额（建议先充值 5-10 美元体验）。
注意：由于 Claude Code 会进行大量的上下文读取，Token 消耗速度比网页版聊天要快，请留意余额。

3. 创建API key令牌：（重中之重）这是国内用户最容易卡关的地方。

你需要创建一个支持专用的“Claude-Code”的令牌。
关键点：记住要选Code专用 分组。

二、安装步骤：从 0 到 1

第一步：全局安装 Claude Code打开你的 PowerShell（推荐以管理员身份运行，避免权限问题），输入以下命令：

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

如果下载速度巨慢，或者卡在进度条不动，说明 npm 源有问题。可以尝试暂时切换回官方源，或者使用“梯”加速终端。

第二步：配置终端代理（国内用户必看！）这一步是成功的关键。绝大多数报错都是因为这一步没做。

在运行 Claude 之前，我们需要告诉 PowerShell 走代理通道。

1.命令快速启动法： 在 PowerShell 中执行（目录请在你的本地创建例如："my-ai-bot" 请根据实际情况修改）：

# 1. 进入项目目录
cd my-ai-bot

# 2. 先设置环境变量 (语法与 CMD 不同)
$env:ANTHROPIC_AUTH_TOKEN="sk-oJePxxxxxxxxxxxxxxxxxxx"
$env:ANTHROPIC_BASE_URL="https://sg.uiuiapi.com"
$env:ANTHROPIC_MODEL="claude-sonnet-4-5-20250929"

# 3. 最后启动 Claude
Claude

小贴士： 这种设置只在当前窗口有效。如果你关闭了终端，下次还需要重新输入。如果想永久生效，需要去“环境变量”里设置，但不建议本地设置。我们可以在电脑文件夹找到claude的文件夹按需设置，这样不会影响其他国内软件。

1.找到claude的文件夹里的settings.json文件，打开去编辑。（如果没有可以手动创建settings.json文件）

2.编辑settings.json文件

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "ANTHROPIC_BASE_URL": "https://sg.uiuiapi.com",
    "ANTHROPIC_MODEL": "claude-sonnet-4-5-20250929"
  },
  "permissions": {
    "allow": [
      "Bash",
      "Bash(npm run build)",
      "Bash(npm run test:*)",
      " Read(~/.zshrc)",
      "Edit(docs/**) "
    ],
    "deny": []
  }
}