前言
最近想体验Claude Code,但翻了不少教程,要么步骤零散,要么默认海外环境,国内配置总在API连接环节卡壳。
其实核心就两步:搭好基础环境,配好API接口。这篇文章把从Node.js安装到API对接的每一步都拆解开,尽量写得细一点,让你跟着做就能跑通,少走弯路。
正文
一、安装Node.js环境
Claude Code运行依赖Node.js,最低要求Node.js 18以上,建议直接安装LTS版本,兼容性更好。
方法一:官网下载(推荐)
- 访问Node.js官网,下载LTS版本安装包
- 双击安装包,按向导完成安装(一路默认下一步即可,无需特殊配置)
方法二:包管理器安装
如果习惯用包管理器,可以通过以下命令安装:
# Chocolateychocoinstallnodejs# Scoopscoopinstallnodejs验证安装
安装完成后,打开PowerShell(建议用管理员模式),输入以下命令检查版本:
node--version# 输出v18.x.x及以上版本npm--version# 输出对应的npm版本⚠️ 注意:如果提示"命令不存在",可能是环境变量未生效,重启终端或电脑即可。
二、安装Claude Code
Node.js环境就绪后,通过npm全局安装Claude Code:
npminstall-g@anthropic-ai/claude-code安装完成后验证:
claude--version# 输出类似1.0.0的版本号,说明安装成功三、配置API连接(关键步骤)
前提:获取API Key
调用Claude需要API接口,我这次用了88api(官网:https://api.88api.shop)作为中转,主要是省去海外账号和翻墙的麻烦,国内直连比较方便,一个Key还能管理多个模型,切换也简单。 推荐大家可以试试,大家也可以用自己的。
下面以88API为例:
获取Key的步骤:
注册并登录后,点击侧边栏“API令牌”。
点击“添加令牌”
选择分组
- 根据需要调用的模型选择分组
a. claude 模型建议使用 calude code 分组、
b. gpt 模型建议使用 codex分组 - 可通过平台的模型广场查看不同模型支持的分组
- 若在使用中出现上游分组饱和,请切换分组使用
- 根据需要调用的模型选择分组
点击提交
5. 点击复制按钮复制API令牌,也就是API KEY
方法一:配置文件(推荐)
通过配置文件永久保存API信息,无需每次设置环境变量。
配置文件路径:
C:\Users\<你的用户名>\.claude\settings.json配置内容:
{"env":{"ANTHROPIC_AUTH_TOKEN":"你的API密钥",// 替换为刚复制的Key"ANTHROPIC_BASE_URL":"https://api.88api.shop"// 固定API地址}}创建步骤:
- 打开文件资源管理器,进入
C:\Users\<你的用户名>\目录 - 新建文件夹
.claude(注意文件夹名前有小数点) - 在
.claude文件夹内新建settings.json文件 - 粘贴上述配置内容,替换"你的API密钥"为实际Key,保存文件
方法二:环境变量(临时/永久)
如果不想用配置文件,也可以通过环境变量配置:
PowerShell临时设置(当前会话有效):
$env:ANTHROPIC_BASE_URL="https://api.88api.shop"$env:ANTHROPIC_AUTH_TOKEN="你的API密钥"# 替换为实际KeyPowerShell永久设置(用户级,重启生效):
[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 Key⚠️ 重要提示:配置完成后需重启终端(或IDE,如VS Code需完全关闭再打开),否则配置可能不生效。
VSCode插件配置(可选)
如果使用VSCode的Claude插件,需额外创建config.json:
配置文件路径:
C:\Users\<你的用户名>\.claude\config.json配置内容:
{"primaryApiKey":"any"}创建步骤:
- 进入
C:\Users\<你的用户名>\.claude\目录 - 新建
config.json文件,粘贴上述内容并保存
四、启动Claude Code
配置完成后,在PowerShell中输入:
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
调试技巧:
- 检查网络连接是否正常
- 确认API Key和Base URL配置正确
- 重启终端或IDE后重试
总结
整个流程其实不复杂:装Node.js→装Claude Code→配API→启动。核心坑点在API配置和环境变量生效,按步骤检查路径和文件内容基本能解决。如果启动成功,就可以开始体验Claude Code的功能了。如果遇到其他问题,欢迎在评论区交流,我会尽量回复。