前言最近想试试Claude Code但网上教程要么太零散要么默认海外环境国内用户跟着做总卡在API配置环节。其实只要选对接口方案整个流程并不复杂。我花了半天时间整理出这篇实操指南从Node.js环境搭建到API对接再到常见报错处理一步步带你跑通尽量让小白也能少踩坑。正文一、准备工作安装Node.jsClaude Code运行依赖Node.js环境最低要求Node.js ≥18建议选LTS版本稳定性更好。方法一官网下载推荐访问Node.js官网下载LTS版本安装包双击安装包按向导提示完成安装一路默认下一步即可无需额外配置方法二包管理器安装适合熟悉命令行的用户如果电脑装了Chocolatey或Scoop可直接用命令安装# Chocolateychocoinstallnodejs# Scoopscoopinstallnodejs验证安装是否成功打开终端建议用PowerShell输入以下命令出现版本号即安装成功node--version# 输出示例v20.11.0版本号可能因下载版本不同略有差异npm--version# 输出示例10.2.4⚠️ 注意如果安装后提示命令不存在可能是环境变量未生效建议重启终端或检查安装路径是否添加到系统环境变量。权限问题可尝试以管理员身份运行终端。二、安装Claude CodeNode.js环境就绪后用npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code安装完成后验证claude--version# 输出版本号即安装成功如无输出检查Node.js是否正确安装三、配置API连接核心步骤Claude Code需要API密钥才能调用服务这里以88api中转为例我用它主要是省去海外账号注册和翻墙步骤国内直连更方便大家也可以用自己熟悉的接口服务。1. 获取API Key访问88api官网https://api.88api.shop。注册登录以后点击侧边栏的 “API 令牌”点击添加令牌创建令牌名称随意直接提交获取 API Key注意妥善保管不要公开或分享。点击知道了在令牌列表中可以点击复制按钮获取 API Key2. 配置API两种方法选一种即可方法一配置文件推荐永久生效在用户目录下创建配置文件路径和内容如下配置文件路径需替换你的用户名为实际系统用户名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_URLhttps://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的集成终端中使用需彻底重启IDE否则配置可能不生效。3. VSCode插件配置可选如果使用VSCode的Claude插件需额外创建config.json文件配置文件路径C:\Users\你的用户名\.claude\config.json配置内容{primaryApiKey:any}创建步骤进入C:\Users\你的用户名\.claude\目录如.claude文件夹不存在先按方法一创建新建config.json文件粘贴上述内容并保存四、启动Claude Code配置完成后在终端输入以下命令启动claude首次启动可能需要等待几秒成功后会进入交互界面。如需查看支持的命令可输入claude--help五、常见问题排查问题启动后提示Unable to connect to Anthropic services症状启动Claude Code后无法连接服务提示连接失败。解决方案这通常是首次启动引导未完成导致需在用户根目录创建.claude.json文件跳过引导配置文件路径C:\Users\你的用户名\.claude.json配置内容{hasCompletedOnboarding:true}创建步骤进入C:\Users\你的用户名\目录注意是用户根目录不是.claude文件夹内新建.claude.json文件粘贴上述内容并保存重启Claude Code调试技巧如果仍无法连接检查网络是否正常国内直连需确保API地址可访问API Key是否正确配置重新核对配置文件或环境变量终端/IDE是否已重启配置生效需要重启总结整个流程核心在于Node.js环境和API配置只要按步骤操作基本能一次跑通。国内用户用中转接口能省去不少麻烦关键是配置文件路径和重启终端这两个细节别忽略。如果遇到其他问题欢迎在评论区交流我会尽量回复。希望这篇教程能帮你少走弯路顺利用上Claude Code。