KKCode文档站

Appearance

Claude Code Windows 使用指南 ​

1. 安装 Node.js ​

方式一：官网安装（推荐） ​

  1. 打开 https://nodejs.org/
  2. 下载 LTS 版本安装包（建议 Node.js 18+）
  3. 双击 .msi 文件并按向导完成安装

方式二：包管理器安装 ​

powershell
# Chocolatey
choco install nodejs

# 或 Scoop
scoop install nodejs

验证安装 ​

powershell
node --version
npm --version

2. 安装 Claude Code ​

powershell
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
claude --version

3. 配置 Claude Code ​

方式一：编辑 settings.json（推荐） ​

Windows 路径通常为：C:/Users/你的用户名/.claude/settings.json

json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_BASE_URL": "https://www.kkcode.ai/api",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

方式二：环境变量配置 ​

临时生效（当前 PowerShell 会话）：

powershell
$env:ANTHROPIC_BASE_URL = "https://www.kkcode.ai/api"
$env:ANTHROPIC_AUTH_TOKEN = "你的API密钥"

永久生效（用户级）：

powershell
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://www.kkcode.ai/api", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API密钥", [System.EnvironmentVariableTarget]::User)

验证变量：

powershell
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

4. 开始使用 ​

powershell
claude

在项目目录中使用：

powershell
cd C:\path\to\your\project
claude

5. 常见问题 ​

PowerShell 执行策略限制 ​

powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

全局安装权限不足 ​

powershell
npm config set prefix "$env:APPDATA\\npm"

配置后不生效 ​

  1. 重新打开终端
  2. 再次执行 claude --version 与环境变量检查命令