前言

最近想试试Claude Code，但网上教程要么太碎，要么默认海外环境，国内配置总是卡壳？其实只要找对方法，从安装到跑通并不难。这篇是我亲测可行的完整步骤，包括Node.js环境搭建、Claude Code安装，以及国内API中转的配置（不用翻墙和海外账号），帮你少踩坑，快速上手。

正文

1. 安装Node.js

Claude Code需要Node.js环境运行，最低要求Node.js >=18（建议LTS版本）。

方法一：官网下载（推荐）

1. 访问Node.js官网下载LTS版本
2. 双击安装包按向导完成安装

方法二：包管理器安装

# Chocolatey
choco install nodejs

# Scoop
scoop install nodejs

验证安装

出现版本号即成功：

node --version
# 输出示例：v20.11.0

npm --version
# 输出示例：10.2.4

⚠️TIP：建议使用PowerShell；如遇权限问题可尝试以管理员身份运行。

2. 安装Claude Code

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

验证安装：

claude --version

3. 配置API连接

获取API KEY

我这次用88api中转（官网：https://api.88api.shop），推荐大家可以试试，或者大家可以用自己的。以下是获取步骤：

1. 注册登录以后，点击侧边栏的 “API 令牌”

2. 点击"添加令牌"

3. 创建令牌，名称随意，直接提交

4. 获取 API Key，注意妥善保管，不要公开或分享。

5. 点击"知道了"，在令牌列表中可以点击"复制"按钮获取 API Key

方法一：配置文件（推荐）

在用户目录创建.claude文件夹和settings.json：
路径：C:\Users\<你的用户名>\.claude\settings.json
内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_BASE_URL": "https://api.88api.shop"
  }
}

创建步骤：

1. 进入C:\Users\<你的用户名>\目录
2. 新建.claude文件夹（如已存在跳过）
3. 在文件夹内新建settings.json并粘贴配置内容

方法二：环境变量

PowerShell临时设置（当前会话）

$env:ANTHROPIC_BASE_URL = "https://api.88api.shop"
$env:ANTHROPIC_AUTH_TOKEN = "你的API密钥"

PowerShell永久设置（用户级）

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.88api.shop", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API密钥", [System.EnvironmentVariableTarget]::User)

验证环境变量

$env:ANTHROPIC_BASE_URL
$env:ANTHROPIC_AUTH_TOKEN

⚠️WARNING：替换"你的API密钥"为实际密钥；配置后需重启终端或IDE生效（集成终端需重启整个IDE）。

VSCode插件配置（可选）

若使用VSCode Claude插件，需创建config.json：
路径：C:\Users\<你的用户名>\.claude\config.json
内容：

{
  "primaryApiKey": "any"
}

创建步骤：

1. 进入.claude目录
2. 新建config.json并粘贴内容

⚠️WARNING：此文件为VSCode插件专用，与命令行配置文件settings.json不同。

4. 开始使用

claude

运行claude --help查看支持命令。

5. 常见问题排查

问题：Unable to connect to Anthropic services

症状：启动后提示无法连接服务
解决方案：创建.claude.json跳过引导：
路径：C:\Users\<你的用户名>\.claude.json
内容：

{
  "hasCompletedOnboarding": true
}

创建步骤：

1. 进入用户根目录
2. 新建.claude.json并粘贴内容
3. 重启Claude Code

调试技巧：检查网络、重启终端/IDE、确认API配置正确。

总结

这篇教程覆盖了Claude Code从安装到配置的全流程，重点解决了国内环境下的API对接问题，以及常见的连接报错。只要跟着步骤走，基本能顺利跑通。如果遇到其他问题，欢迎在评论区留言交流，我会尽量帮忙解答。希望这篇教程能帮你快速上手Claude Code！