Claude Code安装配置总踩坑?Windows下从0到1完整教程(附API直连方案)
2026/5/25 17:23:20 网站建设 项目流程

前言

最近想体验Claude Code,但翻了不少教程,要么步骤零散,要么默认海外环境,国内配置总在API连接环节卡壳。
其实核心就两步:搭好基础环境,配好API接口。这篇文章把从Node.js安装到API对接的每一步都拆解开,尽量写得细一点,让你跟着做就能跑通,少走弯路。

正文

一、安装Node.js环境

Claude Code运行依赖Node.js,最低要求Node.js 18以上,建议直接安装LTS版本,兼容性更好。

方法一:官网下载(推荐)
  1. 访问Node.js官网,下载LTS版本安装包
  2. 双击安装包,按向导完成安装(一路默认下一步即可,无需特殊配置)
方法二:包管理器安装

如果习惯用包管理器,可以通过以下命令安装:

# Chocolateychocoinstallnodejs# Scoopscoopinstallnodejs
验证安装

安装完成后,打开PowerShell(建议用管理员模式),输入以下命令检查版本:

node--version# 输出v18.x.x及以上版本npm--version# 输出对应的npm版本

⚠️ 注意:如果提示"命令不存在",可能是环境变量未生效,重启终端或电脑即可。

二、安装Claude Code

Node.js环境就绪后,通过npm全局安装Claude Code:

npminstall-g@anthropic-ai/claude-code

安装完成后验证:

claude--version# 输出类似1.0.0的版本号,说明安装成功

三、配置API连接(关键步骤)

前提:获取API Key

调用Claude需要API接口,我这次用了88api(官网:https://api.88api.shop)作为中转,主要是省去海外账号和翻墙的麻烦,国内直连比较方便,一个Key还能管理多个模型,切换也简单。 推荐大家可以试试,大家也可以用自己的。

下面以88API为例:
获取Key的步骤:

  1. 注册并登录后,点击侧边栏“API令牌”。

  2. 点击“添加令牌”

  3. 选择分组

    1. 根据需要调用的模型选择分组
      a. claude 模型建议使用 calude code 分组、
      b. gpt 模型建议使用 codex分组
    2. 可通过平台的模型广场查看不同模型支持的分组
    3. 若在使用中出现上游分组饱和,请切换分组使用
  4. 点击提交
    5. 点击复制按钮复制API令牌,也就是API KEY

方法一:配置文件(推荐)

通过配置文件永久保存API信息,无需每次设置环境变量。

配置文件路径

C:\Users\<你的用户名>\.claude\settings.json

配置内容

{"env":{"ANTHROPIC_AUTH_TOKEN":"你的API密钥",// 替换为刚复制的Key"ANTHROPIC_BASE_URL":"https://api.88api.shop"// 固定API地址}}

创建步骤

  1. 打开文件资源管理器,进入C:\Users\<你的用户名>\目录
  2. 新建文件夹.claude(注意文件夹名前有小数点)
  3. .claude文件夹内新建settings.json文件
  4. 粘贴上述配置内容,替换"你的API密钥"为实际Key,保存文件
方法二:环境变量(临时/永久)

如果不想用配置文件,也可以通过环境变量配置:

PowerShell临时设置(当前会话有效)

$env:ANTHROPIC_BASE_URL="https://api.88api.shop"$env:ANTHROPIC_AUTH_TOKEN="你的API密钥"# 替换为实际Key

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 Key

⚠️ 重要提示:配置完成后需重启终端(或IDE,如VS Code需完全关闭再打开),否则配置可能不生效。

VSCode插件配置(可选)

如果使用VSCode的Claude插件,需额外创建config.json

配置文件路径

C:\Users\<你的用户名>\.claude\config.json

配置内容

{"primaryApiKey":"any"}

创建步骤

  1. 进入C:\Users\<你的用户名>\.claude\目录
  2. 新建config.json文件,粘贴上述内容并保存

四、启动Claude Code

配置完成后,在PowerShell中输入:

claude

即可启动Claude Code。如需查看命令帮助,输入:

claude--help

五、常见问题排查

问题:启动后提示"Unable to connect to Anthropic services"

原因:首次启动可能因引导流程未完成导致连接失败。

解决方案:在用户根目录创建.claude.json文件跳过引导:

文件路径

C:\Users\<你的用户名>\.claude.json

文件内容

{"hasCompletedOnboarding":true}

创建步骤

  1. 进入C:\Users\<你的用户名>\目录
  2. 新建.claude.json文件(注意在用户根目录,不是.claude文件夹内)
  3. 粘贴上述内容保存,重启Claude Code

调试技巧

  • 检查网络连接是否正常
  • 确认API Key和Base URL配置正确
  • 重启终端或IDE后重试

总结

整个流程其实不复杂:装Node.js→装Claude Code→配API→启动。核心坑点在API配置和环境变量生效,按步骤检查路径和文件内容基本能解决。如果启动成功,就可以开始体验Claude Code的功能了。如果遇到其他问题,欢迎在评论区交流,我会尽量回复。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询