从0到1搞定Claude Code：Windows环境配置+88api直连教程（少踩坑版）

前言作为踩过不少坑的过来人我整理了这篇Claude Code从安装到调用的完整流程尤其适合国内用户不用海外账户不用复杂网络配置直接用88api中转就能跑通。如果你也想少折腾环境专注于工具使用跟着这篇一步步操作就行。正文一、安装Node.js环境Claude Code运行依赖Node.js最低要求Node.js ≥18建议安装LTS版本稳定性更好。方法一官网下载推荐访问Node.js官网下载Windows系统的LTS版本安装包双击安装包按向导提示完成安装默认选项即可无需额外配置方法二包管理器安装适合熟悉命令行的用户如果已安装Chocolatey或Scoop可直接用命令安装# Chocolatey用户chocoinstallnodejs# Scoop用户scoopinstallnodejs验证安装是否成功打开PowerShell建议管理员身份运行避免权限问题输入以下命令检查版本node--version# 输出v18.x.x或更高版本npm--version# 输出对应npm版本⚠️ 注意如果提示命令不存在可能是安装路径未添加到系统环境变量建议重新运行安装包并勾选Add to PATH选项。二、安装Claude CodeNode.js环境就绪后通过npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code安装完成后验证是否成功claude--version# 输出类似1.0.0的版本号三、配置API连接核心步骤1. 获取API Key调用Claude Code需要API密钥我这次使用的是88api作为中转接口官网https://api.88api.shop主要是为了避免海外账户注册和网络问题国内可直连有额度大家可以试试。或者大家用自己的也可以。这里以88api为例获取Key的步骤注册并登录后点击侧边栏“API令牌”。点击“添加令牌”选择分组根据需要调用的模型选择分组a. claude 模型建议使用 calude code 分组、b. gpt 模型建议使用 codex分组可通过平台的模型广场查看不同模型支持的分组若在使用中出现上游分组饱和请切换分组使用点击提交5. 点击复制按钮复制API令牌也就是API KEY2. 配置方式二选一推荐配置文件方法一配置文件永久生效推荐在用户目录下创建配置文件步骤如下配置文件路径C:\\Users\\你的用户名\\.claude\\settings.json将你的用户名替换为实际系统用户名配置内容{env:{ANTHROPIC_AUTH_TOKEN:你的API密钥,// 替换为刚复制的88api令牌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密钥# 替换为实际密钥永久设置用户级重启后生效[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插件需额外创建插件配置文件配置文件路径C:\\Users\\你的用户名\\.claude\\config.json配置内容{primaryApiKey:any}创建步骤在.claude文件夹内新建config.json粘贴上述内容并保存注意与命令行工具的settings.json区分开。四、开始使用Claude Code配置完成后在终端输入以下命令启动claude首次启动会进入交互界面可直接输入问题或代码需求。如需查看命令帮助输入claude--help五、常见问题排查问题启动后提示Unable to connect to Anthropic services症状启动Claude Code后无法连接服务提示连接失败。解决方案创建.claude.json文件跳过引导流程文件路径C:\\Users\\你的用户名\\.claude.json用户根目录非.claude文件夹内文件内容{hasCompletedOnboarding:true}创建步骤在用户根目录新建文件粘贴上述内容保存重启Claude Code即可。调试技巧若仍无法连接检查网络、重启IDE、确认API Key和Base URL配置是否正确。总结这篇教程从Node.js安装到API配置再到常见问题解决覆盖了Claude Code在Windows系统的完整部署流程。核心是通过88api中转解决国内直连问题避免了海外账户和网络的麻烦。只要按步骤操作基本能一次跑通。如果遇到其他问题欢迎在评论区交流我会尽量解答。工具用起来才是王道赶紧试试吧