Claude Code & CCSwitch Mac 安装配置详细教程

第一部分：安装 Homebrew

首先需要安装 Homebrew 包管理器：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装完成后，验证 Homebrew 是否安装成功：

brew --version

如果显示版本号则表示安装成功。

第二部分：更新 Homebrew

在安装任何软件包之前，建议先更新 Homebrew 到最新版本：

brew update

此命令会更新 Homebrew 本身及其可用的软件包列表。

第三部分：安装 Claude Code

使用 Homebrew 安装 Claude Code：

brew install --cask claude-code

第四部分：安装 CCSwitch

使用 Homebrew 安装 CCSwitch：

brew install --cask cc-switch

第五部分：配置模型 API

配置通义千问（Qwen）API

1. 访问 dashscope.console.aliyun.com/
2. 登录后选择"API-KEY管理"
3. 创建新的API-KEY
4. 复制API-KEY（格式类似sk-xxxxxxxxxxxx）

在 CCSwitch 中添加新供应商：

• 选择API类型：阿里云百炼
• 输入API-KEY
• 设置模型名称（如 qwen-max、qwen-plus 等）

配置 DeepSeek API

1. 访问 platform.deepseek.com/
2. 注册账号并登录
3. 进入 API 密钥管理页面
4. 创建新的 API 密钥
5. 复制 API 密钥

在 CCSwitch 中添加 DeepSeek 供应商：

• 输入 DeepSeek API 密钥
• 设置模型名称（如 deepseek-chat、deepseek-coder 等）

第六部分：开始使用

安装配置完成后，在终端中进入您的项目目录：

cd your-project-directory
claude

这样就可以开始使用 Claude Code 了。Claude Code 将通过 CCSwitch 连接到您配置的模型供应商。

第七部分：遇到问题

一. 启动 Claude 校验地区限制

解决办法：屏蔽 CC 启动新手引导校验。

nano ~/.claude.json

文件末尾增加：

"hasCompletedOnboarding": true

注意：后期运行过 claude 后，这个 json 文件内容巨多。前期没运行较少。

二. brew执行安装 ClaudeCode脚本，返回 http 网页代码错误

curl -fsSL https://claude.ai/install.sh | bash

bash: line 1: syntax error near unexpected token `<'

bash: line 1: `<!DOCTYPE html>...

解决办法：升级 homeBrew, 由于 homebrew版本太低找不到 ClaudeCode，返回网页代码。

三. Qwen（BaiLian）模型接入 CC报错 模型参数信息配置错误

解决办法：查看 Qwen API接口网站的官方指导文档。

四. 模型没有额度报错

解决办法：充钱&等送

五. 模型api key 被禁

解决方案：更换 API key