前言

想体验Claude Code却被环境配置和账号问题劝退?国内用户跟着做总踩坑。作为刚折腾通的过来人,我整理了这篇从0到1的完整实操指南,包含Node.js安装、API对接、模型切换全流程,亲测Windows环境下能跑通,小白也能跟着做。

正文

一、安装Node.js环境

Claude Code运行依赖Node.js,最低要求Node.js ≥18(建议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

使用 API 中转可以解决账号环境问题,这里用88api中转服务(网址:https://api.88api.shop);或者大家可以用自己熟悉的服务,步骤类似。具体步骤:
1.访问88api(https://api.88api.shop),注册登录后,点击 “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 显示当前会话费用和时长

总结

至此,Claude Code的安装、API配置和基础使用就完成了。核心步骤是Node.js环境准备、API Key获取,以及通过CC Switch简化模型管理。整个过程按步骤操作,基本能避开水坑。如果遇到问题,欢迎在评论区交流,我会尽量回复。

Logo

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

更多推荐