小白也能照着做：Claude Code Windows安装与88api配置全流程

前言这篇文章整理了我自己实操通过的Claude Code安装配置流程从Node.js环境准备到API对接再到常见报错解决每一步都尽量写清楚。特别是用了API中转方案省去了翻墙和海外账号的麻烦国内环境也能稳定运行希望能帮你少踩点坑。正文一、准备Node.js环境Claude Code运行依赖Node.js环境建议安装LTS版本≥18确保兼容性。方法一官网下载推荐访问Node.js官网下载LTS版本安装包双击安装包按向导完成安装默认选项即可会自动配置环境变量方法二包管理器安装适合熟悉命令行的用户如果已安装Chocolatey或Scoop可以直接用命令安装# Chocolateychocoinstallnodejs# Scoopscoopinstallnodejs验证安装打开PowerShell建议管理员模式输入以下命令检查版本node--version# 输出v18.x.x或更高npm--version# 输出对应的npm版本⚠️ 提示如果提示命令不存在可能是环境变量未生效重启终端或检查安装路径是否添加到系统PATH。二、安装Claude CodeNode.js环境就绪后用npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code安装完成后验证claude--version# 输出类似1.0.0的版本号三、配置API连接这一步是关键需要获取API密钥并配置连接信息。前提获取API Key我这次使用88api作为接口中转官网https://api.88api.shop主要是为了省去海外账号注册和翻墙的麻烦国内可直连且支持多模型统一管理切换模型只需修改配置大家可以参考这种方式。获取API Key的步骤1.注册并登录后点击侧边栏“API令牌”。2. 点击“添加令牌”选择分组根据需要调用的模型选择分组a. claude 模型建议使用 calude code 分组、b. gpt 模型建议使用 codex分组可通过平台的模型广场查看不同模型支持的分组若在使用中出现上游分组饱和请切换分组使用4.点击提交5. 点击复制按钮复制API令牌也就是API KEY方法一配置文件推荐持久生效在用户目录下创建配置文件步骤如下配置文件路径替换你的用户名为实际系统用户名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等IDE中使用需重启整个IDE才能使配置生效。VSCode插件配置可选如果使用VSCode的Claude插件还需额外创建config.json配置文件路径C:\Users\你的用户名\.claude\config.json配置内容{primaryApiKey:any}创建步骤进入C:\Users\你的用户名\.claude\目录新建config.json文件粘贴上述内容并保存⚠️ 注意这是VSCode插件专用配置与命令行工具的settings.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 Key和Base URL配置正确重启终端或IDE后重试总结整个流程走下来其实核心就三步装Node.js、装Claude Code、配API。最容易卡壳的地方是API配置和首次启动的引导问题按文中步骤操作基本能解决。如果你也被海外环境或账号问题困扰API中转方案确实能省不少事。如果遇到其他报错欢迎在评论区交流我会尽量帮忙解答。希望这篇教程能让你顺利用上Claude Code的本地代码辅助功能