前言

最近想上手Claude Code却被环境配置劝退？不少教程要么默认海外环境，要么步骤零散，照着做还总出问题。

这篇文章整理了我亲测跑通的完整流程：从Node.js安装到API对接，再到解决登录问题，每个步骤都附实操截图和命令，尽量让你少踩坑，一篇搞定Claude Code本地部署。

正文

一、准备工作：安装Node.js

Claude Code依赖Node.js环境，最低要求 Node.js ≥18（建议LTS版本），两种安装方式任选：

方法一：官网下载（推荐）

访问 Node.js官网，下载对应macOS的LTS版本，双击安装包按向导完成即可。

方法二：Homebrew安装

如果习惯命令行，直接用Homebrew安装：

brew install node

验证安装

安装完成后，打开终端输入以下命令，出现版本号即成功：

node --version
# 输出示例：v20.11.0（版本号可能因LTS更新变化）

npm --version
# 输出示例：10.2.4

二、安装Claude Code

Node.js就绪后，用npm全局安装Claude Code：

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

验证安装

安装完成后，输入以下命令检查版本：

claude --version

若终端显示版本信息，说明安装成功。

三、配置API连接：获取API Key

Claude Code需要API Key才能调用，我最近用的是 88api 作为中转接口，推荐大家可以试试，也可以用自己熟悉的接口。

获取 API Key 步骤：

1.访问88api（https://api.88api.shop），注册登录后，点击 “API 令牌”

2.点击添加令牌

3. 创建令牌

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

4. 获取 API KEY

获得 API Key 后请妥善保管，API Key 是你的身份凭证，等同于账号密码，切勿公开或分享给他人。

5. 点击“知道了”，可以看到我们刚才创建的，在这里也同样可以点击 复制 按钮去获取 API Key。
   

四、解决登录问题：用CC Switch配置模型

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

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

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

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

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

4. 选择「自定义配置」，填写：

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

5. 继续点击「高级选项」，配置模型，支持多模型切换。

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

这里也是之后你切换模型的地方，可以选择你想要使用的模型。

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

6. 最后点击启用，重启 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解决登录和模型切换问题。
如果过程中遇到其他报错，欢迎在评论区留言，我会尽量回复。工具配置虽繁琐，但跑通后确实能提升开发效率，祝大家使用顺利！