前言最近想试试Claude Code的代码辅助能力作为非专业开发的普通用户最头疼的就是环境配置——步骤零散、版本不对、API调用失败折腾半天还跑不起来。所以我整理了这篇从0到1的实操指南包括Node.js环境准备、Claude Code安装、API连接配置用了国内中转方案省掉翻墙和海外账户麻烦以及常见报错的解决方法。全程基于Windows系统每一步都附了具体命令和路径跟着做基本能一次跑通。正文一、准备工作安装Node.jsClaude Code依赖Node.js环境运行最低要求Node.js ≥18建议选LTS稳定版。方法一官网下载推荐新手访问Node.js官网下载Windows LTS版本安装包通常是.msi格式双击安装包按向导默认安装即可建议勾选Add to PATH自动配置环境变量方法二包管理器安装适合熟悉命令行用户如果已安装Chocolatey或Scoop包管理器可直接用命令安装# Chocolatey用户chocoinstallnodejs# Scoop用户scoopinstallnodejs验证安装是否成功打开PowerShell建议管理员模式避免权限问题输入以下命令检查版本node--version# 输出v18.x.x或更高版本npm--version# 输出对应的npm版本⚠️ 提示如果命令提示node不是内部或外部命令可能是PATH配置问题建议重新安装Node.js并确保勾选Add to PATH。二、安装Claude CodeNode.js环境就绪后用npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code安装完成后验证是否成功claude--version# 输出类似1.0.0的版本号三、配置API连接核心步骤前提获取API KeyClaude Code需要API密钥才能调用服务。我这次用的是88api中转服务官网https://api.88api.shop主要图它国内直连不用翻墙且一个Key能管理多个模型Claude、GPT、Gemini等本地配置更方便。推荐大家可以试试或者大家也可以用自己的。下面以88API 为例注册并登录后点击侧边栏“API令牌”。点击“添加令牌”选择分组根据需要调用的模型选择分组a. claude 模型建议使用 calude code 分组、b. gpt 模型建议使用 codex分组可通过平台的模型广场查看不同模型支持的分组若在使用中出现上游分组饱和请切换分组使用点击提交5. 点击复制按钮复制API令牌也就是API KEY方法一配置文件推荐持久生效通过配置文件保存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否则配置可能不生效。VSCode插件配置可选如果使用VSCode的Claude插件需额外创建插件专用配置文件配置文件路径C:\Users\你的用户名\.claude\config.json配置内容{primaryApiKey:any}创建步骤进入C:\Users\你的用户名\.claude\目录如无.claude文件夹先创建新建config.json文件粘贴上述内容并保存四、开始使用Claude Code配置完成后在PowerShell中输入以下命令启动claude首次启动会进入交互界面可直接输入问题或代码需求。如需查看支持的命令输入claude--help五、常见问题排查问题启动后提示Unable to connect to Anthropic services症状启动Claude Code后提示无法连接服务。原因通常是首次启动引导流程未完成。解决方案在用户根目录创建.claude.json文件跳过引导配置文件路径C:\Users\你的用户名\.claude.json配置内容{hasCompletedOnboarding:true}创建步骤进入C:\Users\你的用户名\目录新建.claude.json文件注意是用户根目录不是.claude文件夹内粘贴上述内容保存重启Claude Code即可调试技巧若仍无法连接检查网络、重启IDE、确认API Key和Base URL配置是否正确。总结这篇教程从Node.js环境搭建到API配置再到常见问题解决覆盖了Windows系统下Claude Code的完整使用流程。核心是通过API中转服务解决国内环境调用问题避免了海外账户和翻墙的麻烦。如果按步骤操作仍遇到问题建议优先检查API Key是否正确、配置文件路径是否有误或重启终端/IDE。技术配置难免踩坑欢迎在评论区交流你的遇到的问题一起完善这个教程~
