跳转至

Claude Code MacOS 安装指引

你将完成什么

完成本教程后，你应该可以做到：

  • 在 macOS上安装 Claude Code
  • 在终端中成功运行 claude
  • 按需使用 CC Switch 管理不同 API Provider

准备步骤：检查系统环境

Claude Code 官方要求如下。[1]

  • 操作系统：macOS 10.15+
  • MacOS原生终端或 iTerm2（推荐，点击下载）
  • 网络：需要可访问 Claude 认证和 API 服务，科学上网工具（仅按照claude code时需要，后续将接入国产模型）

第一步：安装 Claude Code 原生版本

  1. 打开”启动台”，搜索”终端”

    unix-step1-1
    打开启动台，搜索终端

  2. 在终端里输入指令，稍等一会儿，Claude Code 会自动部署到你的电脑上，并完成相关配置

    curl -fsSL https://claude.ai/install.sh | bash
    如下图所示

Note

安装过程会提示网络错误，这大概率由于claude的服务器处于海外。请自行配置科学上网工具。

第二步：首次启动和登录

进入任意项目目录，例如：

# 在目标路径创建文件夹
mkdir -p ~/projects/vibecoding
# 进入项目目录
cd ~/projects/vibecoding
claude

登录页面

首次运行时，Claude Code 会提示你登录。请忽略并退出登录页面。

第三步： CC Switch 切换 API

由于地区限制，中国大陆账号无法使用 Claude Code里自带的Claude 4.6 Haiku/Sonnet/Opus 模型。

因此，我们需要一个工具来管理模型的供应商和秘钥。

CC Switch 便是来解决这个问题的工具：

  • 需要在多个 Provider 之间切换
  • 需要管理第三方代理地址或镜像
  • 同时管理 Claude Code、Codex、Gemini CLI 等多个工具
  • 希望用图形界面管理 MCP、Skills 和配置备份

CC Switch 支持通过图形界面统一管理这些 CLI 工具的 Provider 配置

macOS 安装 CC Switch

方式一：下载图形安装包

前往发布页下载最新版：

CC Switch 下载页面
Github Release 选择 DMG 安装

下载 macOS 安装包后：

  1. 将 CC Switch.app 拖到「应用程序」
  2. 首次启动若提示“未知开发者”，前往“系统设置 > 隐私与安全性”选择“仍要打开”

在 CC Switch 中配置 Claude Code

安装后，大致流程如下：

  1. 打开 CC Switch
  2. 选择顶部的 Claude Code
  3. 点击右上角 + 新增 Provider
    CC Switch 添加供应商
    CC Switch中添加供应商

  4. 以智谱GLM为例，预设供应商选择Zhipu GLM

    CC Switch 选择智谱作为供应商
    选择智谱作为供应商

  5. 填写 API Key （如还没有API Key，请点击获取API Key先去智谱官网申请编码套餐）

    Coding Plan 订阅

    大量实验表明：对于Vibe Coding场景来说，Token的消耗平均是纯对话场景10倍。因此请选择编码套餐（Coding Plan）节省你的开支。

    我们非常欢迎大家在群内寻找队友一起拼套餐，并为日后的团队大作业做准备。

    CC Switch 填写API Key
    选择智谱作为供应商并填写API Key

    如果你还没购买智谱编码套餐，请购买后在这里创建你的API Key

    CC Switch 填写API Key
    购买编码计划后，点击这里创建API Key

  6. 选择模型名称 glm-5.1

    CC Switch 填写API Key
    选择智谱最新旗舰推理模型glm-5.1

  7. 点击添加

  8. 回到供应商选择的界面，对着刚添加的Zhipu供应商点击启用

    CC Switch 填写API Key
    选择智谱最新旗舰推理模型glm-5.1

  9. 启动 claude code

点击cc switch提供的快捷按钮启动 claude code

CC Switch 填写API Key
一键启动 claude code

或者回到终端运行：

claude

Claude Code 就会按当前 Provider 配置工作。

验收安装

向claude code打个招呼，claude code回复即为安装成功

分享你安装成功的果实

请在 腾讯文档表单 分享你安装成功的截图和踩到的坑吧！

CC Switch 填写API Key
claude code回复用户即为配置成功

常见问题

4. 通过第三方 Provider 使用时报错

这类问题通常不是 Claude Code 本体安装失败，而是 Provider 配置问题。优先检查：

  • API Key 是否正确
  • 是否已经选择预设供应商，若没有需要填写Base URL 等信息
  • cc switch 是否正确选择 claude code

参考引用

[1] Anthropic. Claude Code Setup. https://docs.anthropic.com/en/docs/claude-code/setup

[2] Anthropic. Claude Code Overview. https://docs.anthropic.com/en/docs/claude-code/overview

[3] Homebrew. Installation. https://brew.sh/

[4] nvm-sh. nvm Installation and Update. https://github.com/nvm-sh/nvm?tab=readme-ov-file#installing-and-updating

[5] 菜鸟教程. CC Switch 一键切换 API. https://www.runoob.com/ai-agent/cc-switch.html

[6] farion1231. CC Switch Releases. https://github.com/farion1231/cc-switch/releases/latest