前言最近想体验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 CodeNode.js环境就绪后通过npm全局安装Claude Codenpminstall-ganthropic-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密钥,// 替换为刚复制的KeyANTHROPIC_BASE_URL:https://api.88api.shop// 固定API地址}}创建步骤打开文件资源管理器进入C:\Users\你的用户名\目录新建文件夹.claude注意文件夹名前有小数点在.claude文件夹内新建settings.json文件粘贴上述配置内容替换你的API密钥为实际Key保存文件方法二环境变量临时/永久如果不想用配置文件也可以通过环境变量配置PowerShell临时设置当前会话有效$env:ANTHROPIC_BASE_URLhttps://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的功能了。如果遇到其他问题欢迎在评论区交流我会尽量回复。
