Claude Code安装及API配置保姆级教程（Windows 版本）

前言

最近想在本地用Claude Code辅助写代码，但直接连官方接口总是遇到网络问题。试了几种方案后，通过配置中转接口解决了。把过程记下来，方便自己后续查阅，也给有同样需求的朋友参考。

正文

1. 安装Node.js

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

方法一：官网下载（推荐）
  1. 访问Node.js官网下载LTS版本
  2. 双击安装包按向导完成安装
方法二：包管理器安装
# Chocolateychocoinstallnodejs# Scoopscoopinstallnodejs
验证安装

出现版本号即成功：

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

⚠️TIP：建议使用PowerShell；遇到权限问题可尝试管理员身份运行。我第一次验证时没开管理员权限，报错后重新打开就好了。

2. 安装Claude Code

npminstall-g@anthropic-ai/claude-code

验证安装：

claude--version

3. 配置API连接

获取API KEY

我这里用的是88api的中转接口，省去了直连的麻烦。推荐大家可以试试，或者大家也可以用自己的。
步骤如下：

1.注册登录后，点击 “API 令牌”

2.点击添加令牌

3. 创建令牌

名称随便写，没有含义，直接点击提交即可。

  1. 获取 API KEY

获得 API Key 后请妥善保管，API Key 是你的身份凭证，等同于账号密码，切勿公开或分享给他人。

  1. 点击“知道了”，可以看到我们刚才创建的，在这里也同样可以点击 复制 按钮去获取 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. 在.claude里新建settings.json
  4. 粘贴配置内容保存
方法二：环境变量

不想用配置文件可通过环境变量配置：

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要彻底重启才生效。我之前只重启终端没重启VS Code，配置没生效，后来重启IDE才好。

VSCode插件配置（可选）

用VSCode的Claude插件需额外配置config.json：
路径：C:\Users<你的用户名>.claude\config.json
内容：

{"primaryApiKey":"any"}

创建步骤：

  1. 进入C:\Users<你的用户名>.claude\目录
  2. 新建config.json（若.claude不存在先创建）
  3. 粘贴内容保存

⚠️ WARNING：这是插件专用的config.json，和命令行的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. 粘贴内容保存
  4. 重启Claude Code

调试技巧：

  1. 检查网络连接
  2. 重启终端/IDE
  3. 确认API配置正确

总结

这次整理了Windows下Claude Code的安装和API配置步骤，从Node.js安装到解决连接问题，整体流程还算顺畅。需要注意配置文件的路径和环境变量的生效问题，遇到问题时仔细检查每一步。希望这些内容能帮到需要的朋友。