国内使用 Claude Code：从 0 到 1 的完整指南

从今天起，我会开启一个全新系列—— Claude Code 零基础到高手系列，专门写给非开发背景的纯新手。 

很多新手刚接触 AI 编程工具就卡壳：国内直接用Claude Code总提示连接失败，要么不会配置API，要么换节点、换密钥时反复修改配置，越弄越乱。

今天第一篇，不仅会给大家带来最省心的国内使用方案 —— CC Switch + Claude Code，还会详细拆解5个核心问题，帮你彻底搞懂底层逻辑，新手也能10分钟搞定，顺利开启Claude Code的使用之旅。

什么是 Claude Code？

Claude Code 是 Anthropic 官方推出的 AI 编程专用 CLI 工具（命令行工具），本质是 Claude 大模型的编程专属版本，专为开发者设计，核心功能围绕编程全流程展开。

简单说，它就像一个“AI 编程助手”，能帮你搞定编程中的大部分繁琐工作：

看懂完整项目代码
一键生成各类编程语言代码（Python、Java、JavaScript等）
排查代码bug
重构旧代码
梳理项目架构
解读技术文档
优化代码性能

它的优势的是适配多种编程语言，对新手友好，无需复杂配置（基础配置完成后，输入简单指令就能使用），且能精准理解编程需求，生成的代码可直接复用，堪称“编程小白的救星、老开发者的效率神器”。

但需要注意的是，Claude Code 本身是免费安装使用的，核心消耗来自调用大模型的token（按量付费，灵活可控），且国内无法直接连接，需搭配配置工具使用。

什么是CC Switch？

CC Switch 是一款免费开源的跨平台桌面工具，核心功能是“管理AI编程工具的API配置、一键切换大模型供应商”，专门解决国内用户使用 Claude Code、Codex 等工具时的配置难题。

它就像一个“配置管家”，无需你手动修改环境变量、编辑配置文件，也不用重启终端，通过可视化操作，就能完成API密钥管理、大模型节点切换、配置备份与迁移等操作。 

CC Switch 目前已更新至 v3.13.0 版本，可以访问 Github 查看最新版本：

https://github.com/farion1231/cc-switch/releases

CC Switch 支持 Claude Code 与 Codex 的供应商管理，从 Electron 迁移到Tauri 2.0 后，应用体积大幅减少、启动速度提升，还能自动导入现有配置、备份旧配置，新手操作更安心，支持 Windows、macOS、Linux 全平台使用。

Claude Code 的安装与配置

懂核心概念后，我们进入实操环节，全程可视化操作，复制命令即可，不用懂复杂原理，分 4 步完成安装与配置，确保国内稳定使用 Claude Code。 

第一步：安装 Claude Code

Claude Code 是官方 CLI工具（命令行工具），我们后续所有操作都要基于它，安装步骤分 Windows、macOS、Linux 三种系统，按需选择，全程复制命令即可。

1、前置准备：安装Node.js

Claude Code 依赖 Node.js（v18+版本，推荐LTS稳定版），先安装它才能顺利安装 Claude Code。 

- Windows：

直接去 Node.js 官网下载 .msi 安装包，双击安装即可；

也可以用命令快速安装，以管理员身份打开PowerShell，输入：

winget install OpenJS.NodeJS.LTS

回车等待完成即可。 

- macOS：

打开终端，输入命令：

brew install node

回车安装（如果没有brew，先安装brew再执行）。 

- Linux（Ubuntu/Debian）：

终端输入：

sudo apt install nodejs npm

回车完成安装。 

安装完成后，验证是否成功，只需要在终端（或PowerShell）输入

node -v
npm -v

能显示版本号，就说明安装成功了。 

2、安装 Claude Code 

验证 Node.js 安装成功后，继续在终端输入以下命令，一键安装Claude Code： 

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

等待1-2分钟（取决于网络速度），安装完成后，输入

claude --version

能显示版本号，就说明Claude Code安装成功了。 

⚠️ 避坑提醒：如果安装失败，大概率是 Node.js 版本过低，升级到 v18+ 版本再重试；Windows 用户一定要用管理员身份打开 PowerShell ，否则会提示权限不足。 

第二步：安装CC Switch

CC Switch 支持 Windows、macOS、Linux 全平台，按需选择安装方式，推荐下载最新版本，稳定性更好，安装步骤如下： 

- Windows： 

打开 GitHub Releases 页面（地址：https://github.com/farion1231/cc-switch/releases），下载CC-Switch-v3.13.0-Windows.msi，双击安装即可。

- macOS： 

打开GitHub Releases页面，下载CC-Switch-v3.13.0-macOS.dmg，双击将其移动至应用程序即可。

- Linux： 

打开GitHub Releases页面，下载对应版本的*.deb安装包，然后终端输入

sudo dpkg -i 下载的安装包名称.deb

回车完成安装。

第三步：核心配置（ CC Switch + Claude Code ，国内直连关键） 

这一步是核心，配置完成后，就能国内稳定使用 Claude Code 了。

1、选择大模型

打开 CC Switch ，点击 CC Switch 主窗口右上角的“+”按钮，进入添加供应商页面； 

然后根据需要，选择你感兴趣的模型。

这里以性价比非常高的 MiniMax 为例，点击 MiniMax，然后向下滑动，只需要填写 API Key。

2、获取 API Key

接下来，可以通过下面的链接申请 MiniMax 的 API（这是我的邀请链接，通过该链接进入可以 9 折优惠）。

https://platform.minimaxi.com/subscribe/token-plan?code=2mkeSi4n5F&source=link

如果不需要从我的邀请链接进入，也可以直接从 CC Switch 中找到官网。

进入后，注册账号，登陆后，点击接口密钥，创建 API Key。

3、激活 API Key

创建 API Key 后，复制，然后粘贴至 CC Switch 对应输入框，点击右下角的 添加 按钮，即可完成配置。此时，鼠标悬浮只对应的模型，显示使用中，即配置成功。

第四步：验证使用

配置完成后，我们来验证一下，看看 Claude Code 是否能正常使用，步骤非常简单：

1、打开终端（ Windows 用 PowerShell ，macOS/Linux 用终端）； 

2、输入命令：

claude

进入 Claude Code 界面，第一次可能会询问文件夹读写权限或者询问是否信任，或者会进行新手告知等信息，根据内容选择即可：

然后当出现 Claude Code 图标后，即配置成功。

此时，你可以当聊天工具跟其聊天，或者直接给它一个简单的任务，如“写一个Python快速排序函数”，如果能正常响应，那就没有问题了。

⚠️ 补充说明：如果想切换其他节点或模型，只需在CC Switch中选择对应的供应商，点击“启用”按钮，即可一键切换，不用重新配置，非常方便。

使用 CC Switch 如何选择大模型？

CC Switch本身不提供大模型，而是通过“管理供应商”的方式，让你一键切换不同平台的大模型，选择时主要看3个维度：

1、兼容性：

优先选择兼容Anthropic协议的大模型（比如 Claude 官方模型、DeepSeek、智谱 GLM、通义千问 Code 等），这类模型能直接适配 Claude Code，无需额外修改配置，CC Switch可直接识别。

2、稳定性：

国内用户优先选择“国内中转服务+兼容模型”，这类模型无需翻墙，国内直连，响应速度快，服务可用性可达99.99%，适合新手长期使用。 

3、需求匹配：

根据自身需求选择：新手练手可选择免费体验额度的模型（新用户注册通常有免费token）；专业编程、复杂项目开发，可选择 Claude 官方模型或 DeepSeek 等专注编程的模型；追求性价比可选择国内中转平台的模型，综合成本比官方低30%左右。 

第三方大模型和 Claude 官方模型的区别？

这很多新手会疑惑，同样能通过 CC Switch 使用，第三方大模型和 Claude 官方模型到底有啥不一样，这里用通俗的语言拆解核心区别：

1、核心区别：来源与纯度

Claude 官方模型是 Anthropic 直接提供的原生模型，无任何第三方中转，功能最完整、更新最快，能优先体验新功能（比如最新的代码优化、多语言适配）；第三方大模型多为“兼容 Anthropic 协议”的模型，或中转平台提供的官方模型镜像，功能基本一致，但更新可能滞后于官方。

2、连接方式：

Claude 官方模型需要海外节点，国内无法直接连接，且需要海外账号和国外信用卡充值；第三方大模型（国内中转）国内直连，支持微信、支付宝充值，无需海外账号，对国内用户更友好。 

3、性价比：

Claude 官方模型按官方定价计费，无额外优惠，且受汇率影响，成本较高；第三方中转平台的模型通常有汇率优惠和充值赠额，综合成本比官方低，适合新手练手和日常使用。

4、稳定性：

Claude 官方模型受海外网络影响，国内连接易卡顿、超时；第三方中转平台采用多可用区架构和 CDN 加速，国内连接更稳定，故障自愈快，适合长期使用。

很多人会把 Claude Code 当成一个新工具。 就像当年学 Excel、Photoshop、Figma 一样。 但如果你认真观察这一次变化，就会发现，它的性质其实完全不同。

过去的软件，本质上是在提升效率。而现在的 AI，更像是在扩展能力边界。

以前，一个人能做什么，很大程度上取决于他掌握了什么技能。会编程的人可以做产品，不会编程的人就只能停留在想法阶段。会设计的人可以表达创意，不会设计的人就只能依赖别人实现。

但现在，这条边界正在被快速抹平。一个人是否能够做出产品，越来越不取决于他会不会写代码，而取决于他是否具备另一种更底层的能力：把一个模糊的想法，持续推进到可以运行的现实。

这是一种执行能力，也是一种系统能力。它不属于工程师，也不属于设计师，而属于一种新的角色：Builder。而 Claude Code，只是这个时代给 Builder 提供的第一代工具。 

就像 20 年前的互联网，让信息传播的成本接近于零；10 年前的移动互联网，让产品发布的门槛大幅降低；今天的 AI，则正在把「做产品」这件事，从一项专业能力，变成一种通用能力。 

而我们现在做的，只是从最简单的一步开始。