Claude Code - Windows 安装配置

#前置要求

• Windows 系统与管理员或 sudo 权限
• 稳定的互联网连接
• 千模岛 API 账户与 Claude Code 专用分组令牌

#步骤 1：安装 Node.js

#方法一：使用官方安装包（推荐）

1. 访问 https://nodejs.org
2. 下载 LTS 版本的 Windows Installer（.msi）。
3. 运行安装程序并按默认设置完成安装。
4. 安装程序会自动把 Node.js 加入 PATH。

#方法二：使用包管理器

Winget（Windows 11 或 Windows 10 自带）：

winget install OpenJS.NodeJS.LTS

Chocolatey：

choco install nodejs-lts

Scoop：

scoop install nodejs-lts

#验证安装

node --version
npm --version

#步骤 2：安装 Claude Code CLI

# 全局安装
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

#步骤 3：配置 API 端点

创建配置目录：

mkdir $env:USERPROFILE\.claude
cd $env:USERPROFILE\.claude

创建 settings.json：

配置文件位置：%USERPROFILE%\.claude\settings.json

{
  "env": {
    "ANTHROPIC_API_KEY": "粘贴为Claude Code专用分组令牌key",
    "ANTHROPIC_BASE_URL": "https://www.qianmodao.com"
  },
  "model": "自行选择一个该Claude Code分组支持的model（在模型广场查看）"
}

#步骤 4：设置 API 密钥

#方法 1：环境变量（推荐）

# 当前 PowerShell 会话
$env:ANTHROPIC_API_KEY = "你的千模岛_API令牌"

# 永久写入当前用户环境变量
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "你的千模岛_API令牌", "User")

#方法 2：配置文件

也可以直接使用前面的 %USERPROFILE%\.claude\settings.json。请妥善保管 API 密钥，不要将配置文件提交到版本控制系统。

#步骤 5：验证配置

claude "你好，请介绍一下你自己"

如果配置正确，Claude Code 会正常响应。

#VSCode 集成（可选）

如果你使用 VSCode，可以安装 Claude Code 扩展：

1. 打开 VSCode。
2. 按 Ctrl+Shift+X打开扩展面板。
3. 搜索 “Claude Code” 并安装。

安装扩展后，继续使用 %USERPROFILE%\.claude\settings.json，无需单独填写 claude.apiBaseUrl 或 claude.apiKey。

#常用命令

# 启动交互式聊天
claude

# 非交互式输出
claude --print "请审查 src/ 目录并列出主要问题"

# 查看帮助
claude --help

#快捷键（VSCode）

• Ctrl+Shift+C：打开 Claude 面板
• Ctrl+Shift+A：分析当前文件
• Ctrl+Shift+G：生成代码

#故障排除

#问题：命令未找到

npm config get prefix
$env:PATH

#问题：API 连接失败

验证 ANTHROPIC_API_KEY 和 %USERPROFILE%\.claude\settings.json， 并确认端点为 https://www.qianmodao.com（不带 /v1）。

#问题：权限错误

请以管理员身份运行 PowerShell 后再次安装。

#下一步

• macOS 安装指南
• Linux 安装指南
• CodeX 配置

获取 API 密钥：访问 千模岛 API 控制台获取你的 API 令牌。