前言对于想试试Claude Code的非专业人员其实最想要的就是一篇能直接跟着做、每步都有明确指引的实操文。所以今天把自己从头跑通的过程整理出来从Node.js环境搭建到API对接再到常见报错解决全部按实际操作步骤记录。特别用了88api作为中转省去翻墙和海外账户的麻烦国内网络就能直连对新手很友好。正文一、准备工作安装Node.js环境Claude Code运行依赖Node.js官方要求最低版本≥18建议LTS版稳定性更好。方法一官网下载安装推荐新手访问Node.js官网下载Windows LTS版本页面通常会自动推荐适合你系统的版本双击安装包按向导默认安装即可建议勾选Add to PATH省去手动配置环境变量的步骤方法二包管理器安装适合熟悉命令行的用户如果电脑装了Chocolatey或Scoop可以直接用命令安装# Chocolatey用户chocoinstallnodejs# Scoop用户scoopinstallnodejs验证安装是否成功打开PowerShell建议用管理员模式避免权限问题输入以下命令检查版本node--version# 输出v18.x.x或更高版本npm--version# 输出对应的npm版本⚠️ 小提示如果命令提示node不是内部或外部命令大概率是PATH没配置对重新运行安装包勾选Add to PATH或手动配置环境变量。二、安装Claude CodeNode.js环境就绪后用npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code安装完成后验证是否成功claude--version# 输出类似1.0.0的版本号说明安装成功三、配置API连接核心步骤1. 获取API Key以88api为例使用Claude Code需要API Key这里用88apihttps://api.88api.shop作为中转接口国内直连无需海外账户大家可以试试。下面是详细步骤1.注册并登录后点击侧边栏“API令牌”。2. 点击“添加令牌”选择分组根据需要调用的模型选择分组a. claude 模型建议使用 calude code 分组、b. gpt 模型建议使用 codex分组可通过平台的模型广场查看不同模型支持的分组若在使用中出现上游分组饱和请切换分组使用4.点击提交5. 点击复制按钮复制API令牌也就是API KEY为什么用中转接口主要是省掉海外账户注册和翻墙的麻烦国内网络直接调用而且一个Key能管理多个模型切换方便。2. 配置方式二选一推荐配置文件方法一通过配置文件持久化配置推荐在用户目录下创建配置文件一劳永逸配置文件路径C:\Users\你的用户名\.claude\settings.json注意替换你的用户名为实际系统用户名配置内容{env:{ANTHROPIC_AUTH_TOKEN:你的API密钥,// 粘贴刚复制的API KeyANTHROPIC_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)⚠️ 重要提示配置后需要重启终端如果用VSCode/Cursor等IDE的集成终端需重启整个IDE否则配置可能不生效。3. VSCode插件配置可选如果使用VSCode的Claude插件需额外创建插件专用配置文件配置文件路径C:\Users\你的用户名\.claude\config.json配置内容{primaryApiKey:any}创建步骤在.claude文件夹内新建config.json粘贴上述内容保存即可。四、启动并使用Claude Code配置完成后在PowerShell中输入以下命令启动claude首次启动可能需要等待几秒成功连接后会进入交互界面。想了解更多命令可输入claude --help查看帮助文档。五、常见问题排查问题启动后提示Unable to connect to Anthropic services原因首次启动引导流程未完成。解决方法在用户根目录创建.claude.json文件跳过引导文件路径C:\Users\你的用户名\.claude.json注意是用户根目录不是.claude文件夹内文件内容{hasCompletedOnboarding:true}保存后重启Claude Code即可。如果仍无法连接检查网络、重启终端/IDE或重新核对API Key和Base URL是否配置正确。总结整个流程走下来其实核心就三步搭Node.js环境、装Claude Code、配API连接。最关键的是API配置部分用中转接口确实省了不少事国内网络直接跑通。如果跟着步骤走还是遇到问题建议重点检查配置文件路径是否正确用户名别写错、API Key是否复制完整或者重启终端试试。有其他问题欢迎在评论区交流一起避坑~