前言

AI代码工具更新快,很多教程要么太碎片化,要么忽略了国内环境下的配置细节。最近尝试部署Claude Code时,就踩了不少接口调用和模型切换的坑。

这篇文章把完整流程整理出来,从Node.js环境搭建到API接口配置,再到多模型切换,尽量让每个步骤都清晰可操作,帮大家少走弯路。

正文

一、安装Node.js环境

Claude Code运行依赖Node.js,最低要求v18及以上(建议LTS版本)。

方法一:官网下载(推荐)
  1. 访问Node.js官网下载LTS版本安装包
  2. 双击安装包,按向导提示完成安装(默认选项即可)
方法二:包管理器安装

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

# Chocolatey
choco install nodejs

# Scoop
scoop install nodejs
验证安装

打开PowerShell(建议管理员身份运行),输入以下命令,出现版本号即安装成功:

node --version
# 示例输出:v20.11.0

npm --version
# 示例输出:10.2.4

⚠️ 注意:若遇权限问题,尝试以管理员身份运行PowerShell。

二、安装Claude Code

通过npm全局安装Claude Code:

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

安装完成后验证版本:

claude --version
# 成功会显示当前版本号

三、配置API接口

获取API Key

调用Claude Code需要API接口支持,我这次实操中使用了88api作为中转接口(网址:https://api.88api.shop)。具体获取步骤如下:

1.点击 “API 令牌”
在这里插入图片描述
2.点击添加令牌
在这里插入图片描述
3. 创建令牌

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

在这里插入图片描述

  1. 获取 API KEY

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

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

四、使用CC Switch管理配置与模型切换

Claude Code默认需要官方账号登录,为简化配置,可使用开源工具CC Switch快速管理接口和模型。

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

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

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

在这里插入图片描述

  1. 在CC Switch主界面,点击「Claude code」图标,再点击「+」号添加配置

在这里插入图片描述
4. 选择「自定义配置」,填写:

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

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

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

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

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

  1. 最后点击启用,重启 claude code

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

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

五、开始使用Claude Code

启动Claude Code

打开终端,输入命令:

claude
测试是否正常工作

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

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

总结

本文从Node.js环境搭建到API接口配置,再到CC Switch工具使用,完整覆盖了Claude Code在Windows系统的安装与调用流程。重点解决了接口配置和模型切换的实际问题,每个步骤都经过实操验证。如果在操作中遇到其他问题,欢迎在评论区留言交流,一起完善这个配置方案。

Logo

汇聚全球AI编程工具,助力开发者即刻编程。

更多推荐