欢迎光临
我们一直在努力

Claude Code安装配置总卡壳?Windows小白教程:从Node.js到API直连,亲测3步跑通

前言

最近想试试Claude Code写代码,结果跟着网上教程走,发现对于我们普通用户来说,最大的问题就是环境以及账号问题。

这篇文章就是我踩坑后整理的实操笔记,适合像我一样怕麻烦的小白,跟着做基本能一次跑通。

正文

一、准备工作:安装Node.js环境

Claude Code运行需要Node.js支持,最低要求Node.js ≥18(建议选LTS稳定版)。

方法一:官网下载(推荐新手)
  • 访问Node.js官网,下载LTS版本安装包
  • 双击安装包,按向导默认安装(一路“Next”即可,建议勾选“Add to PATH”)
  • 方法二:包管理器安装(适合熟悉命令行用户)

    如果电脑装了Chocolatey或Scoop,可直接用命令安装:

    # Chocolatey用户
    choco install nodejs

    # Scoop用户
    scoop install nodejs

    验证安装是否成功

    打开PowerShell(建议管理员模式),输入以下命令,能显示版本号即成功:

    node –version
    # 示例输出:v20.11.0(版本号可能因下载版本不同略有差异)

    npm –version
    # 示例输出:10.2.4

    ⚠️ 注意:如果提示“命令不存在”,检查安装时是否勾选“Add to PATH”,或手动将Node.js安装路径(默认C:\\Program Files\\nodejs)添加到系统环境变量。

    二、安装Claude Code

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

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

    安装完成后验证:

    claude –version
    # 能显示版本号即安装成功(如无输出,重启终端再试)

    三、配置API连接:获取并对接接口

    Claude Code需要API接口才能调用模型,我这次直接用了API中转服务(网址:https://api.88api.shop),可以直接解决账号登录问题;或者大家也可以用自己熟悉的:

    1. 获取API Key

    1.访问88api(https://api.88api.shop),注册登录后,点击 “API 令牌” 在这里插入图片描述 2.点击添加令牌 在这里插入图片描述 3. 创建令牌

    名称随便写,没有含义,直接点击提交即可。

    在这里插入图片描述

  • 获取 API KEY
  • 获得 API Key 后请妥善保管,API Key 是你的身份凭证,等同于账号密码,切勿公开或分享给他人。 在这里插入图片描述

  • 点击“知道了”,可以看到我们刚才创建的,在这里也同样可以点击 复制 按钮去获取 API Key。
  • 在这里插入图片描述

    2. 用CC Switch工具管理配置

    Claude Code默认需要官方账号登录,对国内用户不太友好。推荐用开源工具CC Switch快速管理模型配置,无需手动改文件。

    不明白没关系,直接跟着操作就行。

    具体下载版本链接:https://github.com/farion1231/cc-switch/releases

  • 一直往下拉,拉到下面这个位置下载 在这里插入图片描述
  • 根据你的操作系统,下载对应的安装包。Linux、MacOS、Windows看文件名能区分。或点击 “show all 18 assets” 往下拉找更多的版本。
  • 在这里插入图片描述

  • 在CC Switch主界面,点击「Claude code」图标,再点击「+」号添加配置
  • 在这里插入图片描述 4. 选择「自定义配置」,填写:

    • 供应商名称:随意填写
    • API KEY:粘贴前面复制的 api密钥
    • API请求地址:https://api.88api.shop/v1

    在这里插入图片描述 5. 继续点击「高级选项」,配置模型,支持多模型切换。

    在「模型」栏填写具体模型名称(比如我最近在用claude-sonnet-4-6),最后点击添加就可以了。

    这里也是之后你切换模型的地方,可以选择你想要使用的模型。 在这里插入图片描述

    💡 如果不知道模型名称,可以进入首页「模型广场」,查看所有模型,点击左下角复制即可。 然后直接在 cc Switch 里修改模型名称即可切换模型。 在这里插入图片描述

  • 最后点击启用,重启 claude code
  • 保存好以后,点击启用。启用完毕之后,需要 重启claude code,使得配置生效。 在这里插入图片描述

    ⚠️ ⚠️ 注意:若启动后因为连接问题无法使用,尝试修改API请求地址为https://api.88api.shop(去除/v1),重启后再试。(我实操时遇到过这个问题,改地址后解决)。

    五、开始使用Claude Code

    启动Claude Code

    打开终端,输入命令:

    claude

    测试是否正常工作

    输入“你好”,若能收到回复,说明配置成功: 在这里插入图片描述

    常用命令速查表
    命令功能描述
    /model 切换AI模型
    /help 显示所有可用命令
    /clear 清空当前对话
    /exit 退出Claude Code
    /resume 恢复之前的会话
    /cost 显示当前会话费用和时长

    总结

    其实Claude Code的安装配置并不复杂,关键在于Node.js环境、API接口对接和工具辅助这三个环节。本文从基础环境到实际调用,把每个步骤都拆解得比较细,新手跟着做基本能避过“版本不对”“配置错误”这些坑。如果运行中遇到其他问题,欢迎在评论区交流,我们一起解决~

    赞(0)
    未经允许不得转载:171主机测评 » Claude Code安装配置总卡壳?Windows小白教程:从Node.js到API直连,亲测3步跑通
    分享到: 更多 (0)

    评论 抢沙发

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