欢迎光临
我们一直在努力

Claude Code Windows安装+API配置一篇搞定(超详细)

前言

作为踩过坑的开发者,我整理了这篇从0到1的实操文,用88api中转解决国内直连问题,省去翻墙和海外注册麻烦,一步步带你完成安装配置,亲测有效。

正文

一、安装Node.js环境

Claude Code运行依赖Node.js,最低要求Node.js ≥18(建议安装LTS版本,稳定性更好)。

方法一:官网下载(推荐新手)
  • 访问Node.js官网,点击下载LTS版本(通常是首页显眼位置的"Recommended For Most Users")
  • 双击下载的安装包,按向导默认安装即可(一路"Next",建议勾选"Add to PATH",自动配置环境变量)
  • 方法二:包管理器安装(适合熟悉命令行用户)

    如果已安装Chocolatey或Scoop,可直接用命令安装:

    # Chocolatey用户
    choco install nodejs

    # Scoop用户
    scoop install nodejs

    验证安装是否成功

    打开PowerShell(建议管理员模式,避免权限问题),输入以下命令检查版本:

    node –version # 输出v18.x.x或更高版本
    npm –version # 输出对应npm版本

    ⚠️ 注意:如果提示"node不是内部或外部命令",可能是环境变量未配置,建议重新安装Node.js并勾选"Add to PATH",或手动将Node.js安装路径(默认C:\\Program Files\\nodejs)添加到系统环境变量Path中。

    二、安装Claude Code

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

    npm install -g @anthropic-ai/claude-code

    安装完成后,验证是否成功:

    claude –version # 输出类似 @anthropic-ai/claude-code/x.x.x 的版本信息

    三、配置API连接(核心步骤)

    前提:获取API Key

    调用Claude,gpt等模型都需要API密钥,我这次用88api作为中转(官网:https://api.88api.shop),主要是省去翻墙和海外账号注册,国内直连方便,还能统一管理多个模型API。

    大家用自己的也可以,这里以88api为例: 获取Key的步骤:

  • 注册并登录后,点击侧边栏“API令牌”。 在这里插入图片描述

  • 点击“添加令牌” 在这里插入图片描述

  • 选择分组

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

  • 方法一:配置文件(推荐,永久生效)

    在用户目录下创建配置文件,步骤如下: 配置文件路径(需替换<你的用户名>为实际系统用户名):

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

    配置内容(替换"你的API密钥"为实际复制的API Key):

    {
    "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "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密钥"

    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的集成终端中使用,需彻底重启IDE(仅重启终端可能不生效)。

    VSCode插件配置(可选)

    如果使用VSCode的Claude插件,需额外创建插件专用配置文件: 配置文件路径:

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

    配置内容:

    {
    "primaryApiKey": "any"
    }

    创建步骤:

  • 进入C:\\Users\\<你的用户名>\\.claude\\目录(如果.claude文件夹不存在,先按方法一创建)
  • 新建config.json文件,粘贴上述内容并保存
  • ⚠️ 注意:这是VSCode插件专用的config.json,与Claude Code命令行工具的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
  • 调试技巧: 如果仍无法连接,检查:

    • 网络是否正常(可尝试访问https://api.88api.shop测试连通性)
    • API Key是否正确(重新复制粘贴,注意不要有空格或换行)
    • 配置文件路径是否正确(用户目录下的.claude\\settings.json)

    总结

    至此,Claude Code在Windows上的安装和API配置就完成了。核心步骤:安装Node.js ≥18、用npm装Claude Code、通过配置文件或环境变量设置API密钥和中转地址,最后处理可能的连接问题。整个过程不复杂,关键是注意路径和配置的准确性。如果遇到其他问题,欢迎在评论区留言,一起交流解决~

    赞(0)
    未经允许不得转载:171主机测评 » Claude Code Windows安装+API配置一篇搞定(超详细)
    分享到: 更多 (0)

    评论 抢沙发

    • 昵称 (必填)
    • 邮箱 (必填)
    • 网址