小白也能照着做：Claude Code从0到1安装配置教程（一篇搞定环境问题）

前言

这篇文章就把我亲测有效的完整流程整理出来：从Node.js环境搭建到Claude Code安装，再到用88api中转实现国内直连（不用翻墙，也不用注册海外账户），每个步骤都标了具体路径和命令。

如果你也想少踩坑快速上手，跟着做应该能省不少事。

正文

一、准备工作：安装Node.js

Claude Code运行依赖Node.js环境，官方要求最低版本≥18（建议用LTS版，稳定性更好）。

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

1. 访问Node.js官网，下载Windows LTS版本安装包
2. 双击安装包，按向导提示完成安装（默认选项即可，无需额外配置）

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

如果你用Chocolatey或Scoop包管理器，可直接在终端执行：

# Chocolatey安装命令chocoinstallnodejs# Scoop安装命令scoopinstallnodejs

验证安装是否成功

安装完成后，打开PowerShell（建议用管理员模式，避免权限问题），输入以下命令检查版本：

node--version# 输出Node.js版本，如v20.10.0npm--version# 输出npm版本，如10.2.3

⚠️ 提示：如果命令执行失败，检查是否已将Node.js添加到系统环境变量，或重启终端后重试。

二、安装Claude Code

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

npminstall-g@anthropic-ai/claude-code

安装完成后验证是否成功：

claude--version# 输出类似 @anthropic-ai/claude-code/1.0.0 win32-x64 node-v20.10.0

三、配置API连接（核心步骤）

前提：获取API Key

调用Claude模型需要API密钥，我这次用的是88api中转服务（官网：https://api.88api.shop），主要图它国内直连不用翻墙，且一个Key能管理多个模型调用。

推荐大家可以试试，或者大家也可以用自己的。

获取步骤如下（以88API 为例）：
1.注册并登录后，点击侧边栏“API令牌”。

2. 点击“添加令牌”

3. 选择分组
   1. 根据需要调用的模型选择分组
      a. claude 模型建议使用 calude code 分组、
      b. gpt 模型建议使用 codex分组
   2. 可通过平台的模型广场查看不同模型支持的分组
   3. 若在使用中出现上游分组饱和，请切换分组使用
      

4.点击提交

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

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

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

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

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

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

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

⚠️ 重要提示：配置完成后需重启终端（或彻底重启VS Code/Cursor等IDE），否则配置可能不生效。

VSCode插件配置（可选）

如果使用VSCode的Claude插件，需额外创建插件配置文件：

配置文件路径：

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

配置内容：

{"primaryApiKey":"any"}

创建步骤：

1. 进入C:\Users\<你的用户名>\.claude\目录
2. 新建config.json文件，粘贴上述内容并保存

四、开始使用Claude Code

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

claude

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

claude--help

五、常见问题排查

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

症状：启动Claude Code后无法连接服务，提示连接失败。

解决方案：
这通常是首次启动引导未完成导致，需手动创建跳过引导的配置文件：

配置文件路径：

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

配置内容：

{"hasCompletedOnboarding":true}

创建步骤：

1. 进入C:\Users\<你的用户名>\目录（注意是用户根目录，不是.claude文件夹）
2. 新建.claude.json文件，粘贴上述内容并保存
3. 重启Claude Code

调试技巧：
如果仍无法连接，检查：

• 网络是否正常（可尝试访问https://api.88api.shop测试）
• API Key是否正确配置（对比配置文件或环境变量）
• 终端/IDE是否已重启（配置变更需重启生效）

总结

其实Claude Code的安装配置本身不复杂，国内用户主要卡在API调用环节。用88api中转能省去海外账号和翻墙的麻烦，按本文步骤走，从Node.js环境到API对接基本能一次跑通。

如果遇到其他报错，先检查配置文件路径和内容是否正确（很多问题都是路径写错或Key没填对导致）。有问题欢迎在评论区交流，我会尽量回复——毕竟技术工具，能实际用起来才是最重要的。