前言
最近想试试Claude Code，结果找了一圈教程不是缺步骤就是环境不匹配，光配置API就折腾了大半天。其实很多人跟我一样，不是技术出身，就想找篇能直接照着做的完整指南。
这篇文章把从Node.js安装到API对接的每一步都写清楚了，用了中转接口解决直连问题，亲测能跑通，希望能帮你少踩点坑。
正文
一、准备工作：安装Node.js环境
Claude Code需要Node.js支持，最低要求是Node.js 18以上（建议用LTS版本，更稳定）。
方法一：官网下载安装（推荐）
- 访问Node.js官网，下载LTS版本安装包
- 双击安装包，按向导提示完成安装（一路默认下一步即可）
方法二：通过包管理器安装
如果你习惯用命令行，可以通过Chocolatey或Scoop安装：
# Chocolatey用户chocoinstallnodejs# Scoop用户scoopinstallnodejs验证安装是否成功
打开终端（建议用PowerShell），输入以下命令，能显示版本号就说明安装成功了：
node--version# 示例输出：v20.11.0npm--version# 示例输出：10.2.4⚠️ 小提示：如果遇到权限问题，试试以管理员身份运行终端。
二、安装Claude Code
环境准备好后，用npm全局安装Claude Code：
npminstall-g@anthropic-ai/claude-code安装完成后验证一下：
claude--version如果能显示版本信息，就说明安装成功了。
三、配置API连接（核心步骤）
获取API Key
要让Claude Code正常工作，需要配置API连接配置大模型。我最近在用88api中转接口（网址：https://api.88api.shop），相较于官方更划算，推荐大家可以试试。
具体获取步骤：
1.注册登录后，点击 “API 令牌”
2.点击添加令牌
3. 创建令牌
名称随便写，没有含义，直接点击提交即可。
- 获取 API KEY
获得 API Key 后请妥善保管，API Key 是你的身份凭证，等同于账号密码，切勿公开或分享给他人。
- 点击“知道了”，可以看到我们刚才创建的，在这里也同样可以点击 复制 按钮去获取 API Key。
方法一：通过配置文件设置（推荐）
在用户目录下创建配置文件，一劳永逸：
配置文件路径（注意替换<你的用户名>为实际用户名）：
C:\Users\<你的用户名>\.claude\settings.json配置内容（把你的API密钥替换成刚复制的Key）：
{"env":{"ANTHROPIC_AUTH_TOKEN":"你的API密钥","ANTHROPIC_BASE_URL":"https://api.88api.shop"}}创建步骤：
- 打开文件资源管理器，进入
C:\Users\<你的用户名>\目录 - 新建文件夹
.claude（如果已经有就跳过） - 在
.claude文件夹里新建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能显示出设置的值就说明配置对了。
⚠️ 重要提示：配置完一定要重启终端！如果用VS Code或Cursor的集成终端，需要彻底重启整个IDE，否则配置可能不生效。
VSCode插件配置（可选）
如果你用VSCode的Claude插件，还需要额外配置一个文件：
配置文件路径：
C:\Users\<你的用户名>\.claude\config.json配置内容：
{"primaryApiKey":"any"}创建步骤和前面类似：在.claude文件夹里新建config.json，粘贴内容保存即可。注意这是插件专用配置，和命令行工具的settings.json是两个文件。
四、开始使用Claude Code
配置完成后，在终端输入：
claude就能启动Claude Code了。想了解更多命令可以输入claude --help查看。
五、常见问题排查
问题：启动后提示“Unable to connect to Anthropic services”
原因：首次启动时引导流程未完成。
解决方法：在用户根目录创建.claude.json文件跳过引导：
文件路径：
C:\Users\<你的用户名>\.claude.json文件内容：
{"hasCompletedOnboarding":true}创建步骤：
- 进入
C:\Users\<你的用户名>\目录 - 新建
.claude.json文件（注意是在用户根目录，不是.claude文件夹里） - 粘贴内容保存，重启Claude Code
如果还不行：检查网络连接、重启IDE、确认API Key和Base URL配置是否正确。
总结
其实Claude Code配置不算复杂，关键是环境和API这两步别出错。这篇教程从Node.js安装到API对接，再到常见问题解决，都是我实际操作过的步骤，国内环境下用中转接口确实能省不少事。如果按步骤走还是遇到问题，欢迎在评论区交流，咱们一起看看怎么解决。
