国内安装Claude Code CLI完整教程：四步搞定

在国内网络环境下，很多开发者想体验Anthropic推出的Claude Code CLI，却卡在了安装和配置环节。由于Anthropic对国内用户的访问限制，直接安装后无法正常使用。本文基于B站UP主的实操教程，整理出一套完整的安装方案，通过CC Switch工具和API中转站，四步实现Claude Code CLI的正常运行。

整体思路：Claude Code安装四步走策略

整个安装过程可以拆解为四个步骤：

下载软件：准备Node.js、Git、CC Switch三个必备工具
安装软件：按正确顺序依次安装
配置环境：设置CC Switch和API中转站
启动验证：确认Claude Code能正常调用大模型

其中最关键的环节在于第三步的环境配置——这也是大多数人踩坑的地方。下面逐步展开。

第一步：下载Claude Code CLI必备的三个软件

Node.js —— 运行环境

Node.js是Claude Code CLI的编程运行环境，没有它Claude Code根本无法启动。Node.js是一个基于Chrome V8引擎构建的JavaScript运行时环境，它让JavaScript代码可以脱离浏览器在服务器端或本地计算机上运行。Claude Code CLI本质上是一个用JavaScript/TypeScript编写的命令行应用程序，因此必须依赖Node.js来解析和执行其代码。

前往Node.js官网下载对应操作系统的安装包即可。建议选择LTS（长期支持）版本，稳定性更好。LTS版本通常每两年发布一次大版本，提供长达30个月的维护支持，适合生产环境使用；而Current版本则包含最新特性但稳定性稍逊。安装Node.js时会自带npm（Node Package Manager），这是Node.js的包管理工具，类似于Python的pip或Java的Maven，后续安装Claude Code CLI就需要通过npm来完成。

Git —— 版本管理工具

Claude Code的核心应用场景是编程，官方建议搭配Git使用。Git是由Linux之父Linus Torvalds于2005年开发的分布式版本控制系统，目前是全球最主流的代码版本管理工具。它的核心功能是追踪文件的每一次修改，允许开发者在不同版本之间自由切换、创建分支进行并行开发、以及在出现问题时快速回滚到之前的稳定状态。

Claude Code作为AI编程助手，在修改代码时会频繁地创建、编辑和删除文件，搭配Git使用可以确保每次AI修改都有据可查——如果AI生成的代码出现问题，开发者可以通过git diff查看具体改动，或通过git revert撤销整批修改。这也是Anthropic官方强烈建议在Git仓库中使用Claude Code的原因。从Git官网下载Windows版本的安装包即可。

CC Switch —— 突破访问限制的关键工具

CC Switch是整个方案的核心。由于Anthropic不允许国内用户直接调用Claude大模型，安装CC Switch后可以将Claude Code Agent调用的模型接口路由到国内可用的API中转站上。

CC Switch的工作原理本质上是一种API请求代理或重定向机制。Claude Code CLI在运行时会向Anthropic官方的API端点（api.anthropic.com）发送HTTP请求来调用Claude大模型，CC Switch通过修改环境变量或拦截网络请求的方式，将这些请求重定向到用户指定的第三方API端点。这种做法在技术上类似于反向代理（Reverse Proxy），中转站服务器接收到请求后，再代替用户向Anthropic的服务器发起真正的API调用，然后将响应结果原路返回。

CC Switch配置示意

这里有一个重要建议：尽量选择Claude模型的中转站，而非替换为其他大模型。原因很简单——Claude Code的Agent是专门为Claude大模型设计和优化的，两者配合使用效果最佳。

具体来说，Claude Code并非简单的聊天机器人，而是一个基于Agent（智能体）架构的AI编程工具。Agent模式意味着AI不仅能回答问题，还能自主规划任务、调用工具（如读写文件、执行终端命令、搜索代码库）、观察执行结果并据此调整下一步行动。这个循环过程被称为ReAct（Reasoning + Acting）范式。Claude Code的Agent内部包含精心设计的系统提示词（System Prompt）和工具定义（Tool Definitions），这些都是针对Claude模型的响应特性和能力边界量身定制的。例如，Claude模型对XML标签格式的工具调用有特别好的理解能力，而其他模型可能对这种格式的解析效果不同。虽然理论上也可以接入DeepSeek等国产模型，但由于底层提示词工程的适配差异，实际体验可能会打折扣。

第二步：按顺序安装Node.js、Git和Claude Code

安装顺序很重要，务必按以下步骤执行：

安装Node.js和Git

这两个软件的安装都非常简单，打开安装包后一路默认Next即可。Git安装时可以根据需要修改安装路径，其他选项保持默认。

Node.js安装过程

安装完成后，打开终端验证是否安装成功：

node -v    # 应显示Node.js版本号
npm -v     # 应显示npm版本号
git --version  # 应显示Git版本号

三个命令都能正确返回版本号，说明基础环境安装成功。

通过npm命令安装Claude Code CLI

Claude Code CLI本身通过npm命令安装，在终端中输入：

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

这里的-g参数表示全局安装（global），意味着安装后可以在任何目录下直接使用claude命令，而不仅限于某个特定项目目录。npm会从官方注册表（registry.npmjs.org）下载Claude Code CLI软件包及其所有依赖项，自动完成安装。

安装速度很快。安装完成后输入claude命令启动，正常情况下可以进入欢迎界面，但会提示无法使用——这是因为还没有配置可用的API接口。

Claude Code提示无法使用

安装CC Switch

打开CC Switch安装包，同样一路默认Next完成安装。

第三步：CC Switch环境配置（核心环节）

这是整个流程中最关键的一步，需要完成三件事：配置CC Switch、注册API中转站、填入API密钥。

配置CC Switch自定义接口

打开CC Switch后，需要进行以下操作：

删除官方默认接口：官方的调用接口在国内无法使用，先将其移除
添加自定义接口：选择"自定义配置"，添加一个新的API供应商
填写供应商信息：包括供应商名称、官网链接（可选）、请求链地址（必填）
粘贴JSON配置：将对应的JSON配置文件内容复制到CC Switch的配置对话框中，点击保存

CC Switch自定义配置界面

这里的JSON配置文件定义了API请求的具体格式，包括请求头（Headers）、认证方式、模型名称映射等关键信息。不同的中转站可能需要不同的配置格式，务必按照所选中转站提供的文档进行填写。

注册API中转站并获取密钥

教程中使用的是"Token商店"这个中转站服务。注册账号后，进入个人页面：

点击进入API Key管理页面
新建一个API Key，建议命名为容易识别的名称（如"Claude Code CLI Key"）
复制生成的API Key

API Key是访问中转站服务的身份凭证，类似于密码，务必妥善保管，不要泄露给他人或上传到公开的代码仓库中。

填入API Key并保存配置

将复制的API Key粘贴到CC Switch中对应的输入框，其他配置保持不变，点击保存。此时可以先测试一下模型配置是否成功。

注意：API中转站通常是付费服务，按Token用量计费。Token是大语言模型处理文本的基本单位，并非简单地等同于一个字或一个词。对于英文文本，一个Token大约对应4个字符或0.75个单词；对于中文文本，一个汉字通常会被编码为1-2个Token。API调用的费用由输入Token（发送给模型的内容）和输出Token（模型生成的回答）两部分组成，输出Token的单价通常是输入Token的3-5倍。

特别需要注意的是，Claude Code在实际使用中的Token消耗量远超普通对话场景，因为每次交互都会携带大量的上下文信息，包括系统提示词、文件内容、工具调用结果等。一次复杂的代码修改任务可能消耗数万甚至数十万Token，因此使用前务必了解中转站的具体定价，必要时设置用量上限以控制成本。

第四步：启动Claude Code CLI并验证

所有配置完成后，在终端中再次输入claude命令启动Claude Code CLI。这次应该能够正常进入工作界面，不再出现之前的限制提示。

输入一个简单的问题测试大模型调用是否正常。如果能看到模型开始思考并输出结果，说明整个配置流程已经成功完成。教程中验证时使用的是Claude Opus 4模型，支持思考模式（Extended Thinking），响应正常。

Extended Thinking（扩展思考）是Anthropic为Claude模型推出的一项高级推理功能。启用该模式后，模型在生成最终回答之前会先进行一段内部的"思考链"（Chain of Thought）推理过程，这段思考过程对用户可见，类似于人类在解决复杂问题时的草稿纸推演。在编程场景中，Extended Thinking特别有价值——模型会先分析代码结构、梳理依赖关系、考虑边界情况，然后再给出修改方案。不过需要注意的是，Extended Thinking会消耗更多的Token，意味着通过中转站使用时费用也会相应增加。

Claude Code安装常见问题与注意事项

关于模型选择

虽然CC Switch支持将请求路由到不同的大模型，但强烈建议使用Claude系列模型。Claude Code的提示词工程、工具调用逻辑都是针对Claude模型优化的，换用其他模型可能导致功能异常或效果下降。具体而言，Claude Code内部使用了大量的结构化提示词来引导模型正确地调用文件读写、命令执行等工具，这些提示词的格式和表述方式都是基于Claude模型的训练特性精心调优的。如果替换为其他模型，即使该模型本身能力很强，也可能因为对特定提示格式的理解差异而出现工具调用失败、输出格式错乱等问题。

关于网络环境

即使使用了中转站，部分操作（如npm安装）仍可能需要稳定的网络环境。如果npm安装速度过慢，可以考虑切换为国内镜像源：

npm config set registry https://registry.npmmirror.com

这条命令会将npm的默认下载源从国外的官方注册表切换到国内的淘宝镜像站，通常可以将下载速度提升数倍甚至数十倍。如果后续需要恢复官方源，执行npm config set registry https://registry.npmjs.org即可。

关于软件获取渠道

如果从官网下载软件有困难，可以寻找UP主提供的百度网盘备份链接。但建议尽量从官方渠道下载，确保软件安全性和版本最新。

关于费用控制

由于Claude Code的Token消耗量较大，建议在中转站后台设置每日或每月的用量上限。同时可以在Claude Code中合理使用/compact命令来压缩对话上下文，减少不必要的Token消耗。在处理大型项目时，尽量将任务拆分为小的、明确的指令，避免一次性让AI处理过多文件，这样既能提高成功率，也能有效控制成本。

总结

在国内使用Claude Code CLI的核心难点在于API访问限制，而CC Switch + API中转站的方案提供了一个可行的解决路径。整个安装过程并不复杂，关键是理解每个组件的作用：Node.js提供JavaScript运行环境，使得Claude Code CLI能够在本地执行；Git辅助代码版本管理，确保AI修改可追溯可回滚；CC Switch负责API请求路由，将原本指向Anthropic官方的请求重定向到中转站；中转站则作为中间代理，提供国内可访问的模型接口。按照正确的顺序安装和配置，就能顺利在国内环境下体验Claude Code的强大编程能力。