mac安装claude code

步骤 1：终端执行安装命令
打开 MacBook「终端」（启动台 - 其他 - 终端），输入官方安装命令（搭配国内镜像加速）：

bash 运行

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
运行项目并下载源码
bash

步骤 2：验证安装结果
执行完安装命令后，输入验证命令，显示版本号即安装成功：

bash 运行

claude --version
运行项目并下载源码

步骤 3：环境诊断（可选）
输入诊断命令检测依赖是否缺失，确保后续使用无报错：

bash 运行

claude doctor
运行项目并下载源码

关键说明
MacBook 若遇权限不足报错，在命令前添加sudo即可（如sudo npm install -g @anthropic-ai/claude-code），输入电脑开机密码后继续执行。

二、国内模型快速切换：cc-switch 工具使用
国内开发场景中需频繁切换 Claude 对接的模型，推荐使用cc-switch（Claude Code & Codex 供应商切换器，项目地址：https://github.com/farion1231/cc-switch/），该工具基于 Tauri 2.0 开发，体积仅～5MB，支持一键切换百炼、GLM、夸娥云等国内模型，无需手动修改配置文件。

1. cc-switch 安装（MacBook 端）
从项目 Releases 页面下载CC-Switch-macOS.zip，解压后直接打开应用：

首次打开若出现「未知开发者」警告，关闭弹窗后前往「系统设置 - 隐私与安全性」，点击「仍要打开」即可正常使用。
2. 核心模型配置与切换
cc-switch 内置百炼 Coding Plan、GLM Coding Plan、摩尔线程 - 夸娥云（KUAE Cloud）等预设供应商，仅需填写 API Key 即可一键配置，步骤如下：

点击界面「添加供应商」，在下拉列表中选择目标模型（如「GLM Coding Plan」「百炼 Coding Plan」）；
在弹出的配置框中，粘贴模型平台获取的API Key（无需手动填写接口地址，工具已预设）；
点击「保存」，该模型将出现在供应商列表中；
选择目标模型，点击右侧单选按钮，工具自动将配置覆盖到 Claude Code 主配置文件，重启终端即可生效。
3. 切换核心规则
配置自动保存：切换操作会自动将模型配置写入 Claude Code 主配置目录~/.claude/settings.json，无手动修改文件成本；
本地隐私保障：所有 API Key 和配置信息均存储在本地~/.cc-switch/config.json，不经过云端传输；
一键切回官方：如需使用 Claude 官方登录，在供应商列表中选择「Claude 官方登录」，重启终端后输入/login即可完成官方账号登录。
三、推荐模型与替代方案
经过实际测试，目前 Claude Code 对接的国内模型中，GLM Coding Plan 效果最优，百炼 Coding Plan 次之，二者均完美兼容 Claude Code 的所有功能，以下是详细说明及替代方案：

1. 首选：GLM Coding Plan（智谱 AI）
核心优势：基于 GLM-4.7 模型开发，Code Arena 开源编码模型榜单第一梯队，代码补全、重构、bug 修复能力极强，响应速度快（时延 < 200ms）；
配置关键：API Key 从智谱 AI 开放平台（open.bigmodel.cn/）获取，需同时复制api_key和secret_key，cc-switch 中仅需填写api_key即可；
专属接口：cc-switch 已预设 GLM 官方兼容接口https://open.bigmodel.cn/api/anthropic，无需手动修改。
2. 次选：百炼 Coding Plan（阿里云）
核心优势：基于 Qwen Code v0.5.0 模型，适配轻量编码任务（如接口文档生成、简单脚本编写），稳定性高，资源充足无排队；
适用场景：日常开发轻量任务，替代 GLM Coding Plan 完成基础编码工作，性价比高。
3. GLM Coding Plan 资源紧张替代方案：摩尔线程 - 夸娥云（KUAE Cloud）
当 GLM Coding Plan 出现资源排队、调用受限问题时，摩尔线程 - 夸娥云 是最优替代，该平台基于国产算力开发，兼容 Claude Code 协议，步骤如下：

前往摩尔线程夸娥云官网注册账号，进入「控制台 - API 密钥管理」生成专属 API Key；
在 cc-switch 中点击「添加供应商 - 自定义供应商」，填写名称「夸娥云（KUAE Cloud）」，粘贴 API Key 并选择 Claude Code 适配类型；
点击切换，重启终端后 Claude Code 将自动对接夸娥云模型，功能与 GLM Coding Plan 完全兼容。