Claude Code 实战教程：2025最新安装指南（附CC Switch神器）

原生安装：告别 Node.js

原生安装依然是官方最推荐的安装方法，并且这样安装还有多个优势：
1.一个自包含的可执行文件，跟其他工具互不干扰
2.无 Node.js 依赖，启动速度更快
3.改进的自动更新程序稳定性更高
对于已经安装 Node.js 使用 npm 方式装过 Claude Code 的用户可以用下面这行命令实现一键迁移：claude install
官网安装教程：https://code.claude.com/docs/en/overview#macos%2Flinux
如果您是初次接触 Claude Code，请根据您的操作系统选择以下对应的安装方式：
macOS用户安装步骤一：下载 Claude Codecurl -fsSL https://claude.ai/install.sh | bash

如果这条命令出现了报错，那就是你的梯子没有设置好，中国地区受限。
魔法网络🪜设置了全局模式也没办法绕开，需要开启 TUN 模式才能解决问题

如果没有 梯子的话，可以考虑下载国人精心准备的国内镜像安装脚本：curl -fsSL https://raw.githubusercontent.com/cfrs2005/claude-init/main/install.sh | bash

步骤二：配置环境根据提示语设置环境：echo ‘export PATH=“$HOME/.local/bin:$PATH”’ >> ~/.zshrc && source ~/.zshrc
步骤三：验证Claude Code命令行直接输入：Claude，返回以下界面，即是安装成功了。

上面有报错，不用管，因为没有连上官方的模型，所以报错，下面会说到解决办法。
**

Windows用户安装

**官方的原生安装方式，打开 PowerShell 终端运行以下安装命令即可：irm https://claude.ai/install.ps1 | iex
但是一样会遇到上面说的地区受限问题。而且看有些推文说，Native原生方法的安装的 TUI 界面有问题。那就不纠结是否原生安装了，直接用 Node.js 的安装环境。
在 Windows 上安装 Claude Code 你需要准备以下两个环境：git 环境。Git For Windows 下载地址：https://git-scm.com/install/windowsNode.js 环境，nodejs.org 下载最新 LTS 版本，最好是最新版本。下载地址：https://nodejs.org/zh-cn打开 PowerShell 或者 Git Bash，输入以下命令：npm install -g @anthropic-ai/claude-code

等 1-2 分钟，安装完成。验证安装： 新开一个 PowerShell，输入：claude --version

看到输出版本号：2.0.62 (Claude Code)，证明已经装好了

由于 Windows 用户使用 Node.js 安装，不需要配置像上面的 macOS 用户一样，设置环境变量。

安装CC Switch

什么是CC SwitchCC Switch

是一款开源的 API 供应商切换工具，最核心的功能就是可以通过可视化无缝、丝滑的切换不同厂商，比如官方与三方供应商、不同三方供应商之间如 Kimi、智谱等；支持供应商自定义配置，只需填一个 API key 即可，其他全不用管；

目前已经支持 3 个主流 CLI 工具：Claude Code、Codex、Gemini CLI；最开始是仅支持 Claude Code、后面增加了 Codex、最近刚上线了 Gemini CLI，相信后面如果继续有新的流行 CLI 工具时，作者应该会很快更新；
同时支持 Mac、Windows、Linux 3 个常见系统；项目地址：https://github.com/farion1231/cc-switch
除了最核心的 API 切换功能，还有几个比较实用方便的功能，其实就是 Claude Code 的所有能力集成在一起：

1. Claude Skills
2. MCP 管理
3. Prompt 提示词管理
   能直接同步你在终端安装的对应内容，更方便进行可视化管理；
   
   
   CC Switch的优点这个开源项目一经推出广受好评，因为实在是切中了之前在用这类编码 CLI 终端工具的痛点，尤其是 Claude Code，很少人能直接稳定用官方的，每次都需要在不同国产厂商之间切换；之前需要先要 vim ~/.zshrc 进入环境变量；然后再每次修改：export ANTHROPIC_BASE_URL=xxxxx
   export ANTHROPIC_AUTH_TOKEN=xxx
   export ANTHROPIC_MODEL=xxxx
   再保存退出，哪怕不换厂商，只是切换个模型，都是从头这样来一遍，实在太麻烦了；现在 CC Switch 上线后，完全不需要再通过终端进行手动环境变量更改，只需配一个 API key，然后点启动按钮就丝滑完成切换了，真的是做到了，小产品解决大痛点。

CC Switch的使用步骤1：GitHub 下载软件下载地址：https://github.com/farion1231/cc-switch/releases

下载软件后直接安装即可。

步骤2：
配置Claude-sonnet-4-5的 API Key下面的例子都以第三方UniVibe的API，这边以 Claude Code 为例，只需点击右上角"+"添加供应商即可进入配置页面，工具已经内置了常见的主流供应商，比如 DeepSeek、Kimi、智谱、MiniMax 等；

推荐注册地址：https://www.univibe.cc/console/auth?type=register&invite=J6K4JU
免费白嫖6000积分，相当于40刀，其他的也是可以的

这样就配置好了，在 Claude Code 就使用 UniVibe为默认供应商，非常方便。

步骤3：验证环境根据上面的 Windows、macOS 安装的教程，我们一开始不是遇到报错了吗，就是没有配置模型，现在 CC Switch 已经配置好了模型之后，我们再回到 PowerShell 或者终端验证


如果你是在任何一个文件夹，而不是真正的编码文件的时候，你会收到下面的提醒：Claude Code 可以读取、写入、执行此目录中包含的文件。这可能会带来安全风险，因此只能使用来自受信任的文件。

如果是在一个工程项目中打开 Claude Code，这就类似于用一个 IDE 工具打开一个项目的道理。会出现以下提醒：

下次讲解用CC Switch将VScode与claude code结合起来使用，非常简单方便

最后大家有什么好用且可以白嫖的第三方API欢迎讨论，比如博主用的UniVibe，就有六千积分可以白嫖
https://www.univibe.cc/console/auth?type=register&invite=J6K4JU

免责声明:本文仅供技术交流学习使用,请遵守相关法律法规。文中提到的工具和方法仅作为技术探讨,不构成任何使用建议。！