Claude Code安装及API配置保姆级教程(Windows 版本)

📅 2026/6/26 11:54:56
Claude Code安装及API配置保姆级教程(Windows 版本)
前言最近想在本地用Claude Code辅助写代码但直接连官方接口总是遇到网络问题。试了几种方案后通过配置中转接口解决了。把过程记下来方便自己后续查阅也给有同样需求的朋友参考。正文1. 安装Node.jsClaude Code需要Node.js环境才能运行最低要求Node.js 18建议LTS版本。方法一官网下载推荐访问Node.js官网下载LTS版本双击安装包按向导完成安装方法二包管理器安装# Chocolateychocoinstallnodejs# Scoopscoopinstallnodejs验证安装出现版本号即成功node--version# 输出示例v20.11.0npm--version# 输出示例10.2.4⚠️TIP建议使用PowerShell遇到权限问题可尝试管理员身份运行。我第一次验证时没开管理员权限报错后重新打开就好了。2. 安装Claude Codenpminstall-ganthropic-ai/claude-code验证安装claude--version3. 配置API连接获取API KEY我这里用的是88api的中转接口省去了直连的麻烦。推荐大家可以试试或者大家也可以用自己的。步骤如下1.注册登录后点击 “API 令牌”2.点击添加令牌3. 创建令牌名称随便写没有含义直接点击提交即可。获取 API KEY获得 API Key 后请妥善保管API Key 是你的身份凭证等同于账号密码切勿公开或分享给他人。点击“知道了”可以看到我们刚才创建的在这里也同样可以点击 复制 按钮去获取 API Key。方法一配置文件推荐在用户目录下创建.claude文件夹和settings.json路径C:\Users你的用户名.claude\settings.json内容{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$env:ANTHROPIC_AUTH_TOKEN⚠️ WARNING替换你的API密钥为实际密钥。配置后需重启终端IDE要彻底重启才生效。我之前只重启终端没重启VS Code配置没生效后来重启IDE才好。VSCode插件配置可选用VSCode的Claude插件需额外配置config.json路径C:\Users你的用户名.claude\config.json内容{primaryApiKey:any}创建步骤进入C:\Users你的用户名.claude\目录新建config.json若.claude不存在先创建粘贴内容保存⚠️ WARNING这是插件专用的config.json和命令行的settings.json不同。4. 开始使用claude可运行claude --help查看支持的命令。5. 常见问题排查问题Unable to connect to Anthropic services症状启动后提示无法连接服务。解决方案创建.claude.json文件跳过引导路径C:\Users你的用户名.claude.json内容{hasCompletedOnboarding:true}创建步骤进入用户根目录新建.claude.json粘贴内容保存重启Claude Code调试技巧检查网络连接重启终端/IDE确认API配置正确总结这次整理了Windows下Claude Code的安装和API配置步骤从Node.js安装到解决连接问题整体流程还算顺畅。需要注意配置文件的路径和环境变量的生效问题遇到问题时仔细检查每一步。希望这些内容能帮到需要的朋友。