小白也能照着做：Claude Code Windows安装与88api配置全流程

前言

这篇文章整理了我自己实操通过的Claude Code安装配置流程，从Node.js环境准备到API对接，再到常见报错解决，每一步都尽量写清楚。特别是用了API中转方案，省去了翻墙和海外账号的麻烦，国内环境也能稳定运行，希望能帮你少踩点坑。

正文

一、准备Node.js环境

Claude Code运行依赖Node.js环境，建议安装LTS版本（≥18），确保兼容性。

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

方法二：包管理器安装（适合熟悉命令行的用户）

如果已安装Chocolatey或Scoop，可以直接用命令安装：

# Chocolatey
choco install nodejs

# Scoop
scoop install nodejs

验证安装

打开PowerShell（建议管理员模式），输入以下命令检查版本：

node –version # 输出v18.x.x或更高
npm –version # 输出对应的npm版本

⚠️ 提示：如果提示"命令不存在"，可能是环境变量未生效，重启终端或检查安装路径是否添加到系统PATH。

二、安装Claude Code

Node.js环境就绪后，用npm全局安装Claude Code：

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

安装完成后验证：

claude –version # 输出类似1.0.0的版本号

三、配置API连接

这一步是关键，需要获取API密钥并配置连接信息。

前提：获取API Key

我这次使用88api作为接口中转（官网：https://api.88api.shop），主要是为了省去海外账号注册和翻墙的麻烦，国内可直连，且支持多模型统一管理，切换模型只需修改配置，大家可以参考这种方式。

获取API Key的步骤： 1.注册并登录后，点击侧边栏“API令牌”。 2. 点击“添加令牌”

若在使用中出现上游分组饱和，请切换分组使用

4.点击提交 5. 点击复制按钮复制API令牌，也就是API KEY

方法一：配置文件（推荐，持久生效）

在用户目录下创建配置文件，步骤如下：

配置文件路径（替换<你的用户名>为实际系统用户名）：

C:\\Users\\<你的用户名>\\.claude\\settings.json

配置内容（替换"你的API密钥"为实际复制的Key）：

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

创建步骤：

方法二：环境变量（临时或永久）

如果不想用配置文件，也可以通过环境变量配置：

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 # 应输出https://api.88api.shop
$env:ANTHROPIC_AUTH_TOKEN # 应输出你的API密钥

⚠️ 注意：配置完成后需重启终端，若在VS Code等IDE中使用，需重启整个IDE才能使配置生效。

VSCode插件配置（可选）

如果使用VSCode的Claude插件，还需额外创建config.json：

配置文件路径：

C:\\Users\\<你的用户名>\\.claude\\config.json

配置内容：

{
"primaryApiKey": "any"
}

创建步骤：

⚠️ 注意：这是VSCode插件专用配置，与命令行工具的settings.json是两个文件，不要混淆。

四、开始使用Claude Code

配置完成后，在终端输入以下命令启动：

claude

首次启动会进入交互界面，可输入代码问题或指令进行测试。如需查看支持的命令，输入：

claude —help

五、常见问题排查

问题：启动后提示"Unable to connect to Anthropic services"

症状：启动Claude Code后显示无法连接服务。

解决方案：这通常是首次启动引导未完成导致，需创建.claude.json文件跳过引导：

配置文件路径：

C:\\Users\\<你的用户名>\\.claude.json

配置内容：

{
"hasCompletedOnboarding": true
}

创建步骤：

调试技巧：

• 检查网络连接是否正常
• 确认API Key和Base URL配置正确
• 重启终端或IDE后重试

总结

整个流程走下来，其实核心就三步：装Node.js、装Claude Code、配API。最容易卡壳的地方是API配置和首次启动的引导问题，按文中步骤操作基本能解决。

如果你也被海外环境或账号问题困扰，API中转方案确实能省不少事。如果遇到其他报错，欢迎在评论区交流，我会尽量帮忙解答。希望这篇教程能让你顺利用上Claude Code的本地代码辅助功能！