第一部分:安装 Homebrew
首先需要安装 Homebrew 包管理器:
bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安装完成后,验证 Homebrew 是否安装成功:
css
brew --version
如果显示版本号则表示安装成功。
第二部分:更新 Homebrew
在安装任何软件包之前,建议先更新 Homebrew 到最新版本:
sql
brew update
此命令会更新 Homebrew 本身及其可用的软件包列表。
第三部分:安装 Claude Code
使用 Homebrew 安装 Claude Code:
css
brew install --cask claude-code
第四部分:安装 CCSwitch
使用 Homebrew 安装 CCSwitch:
arduino
brew install --cask cc-switch
第五部分:配置模型 API
配置通义千问(Qwen)API
- 访问 dashscope.console.aliyun.com/
- 登录后选择"API-KEY管理"
- 创建新的API-KEY
- 复制API-KEY(格式类似sk-xxxxxxxxxxxx)
在 CCSwitch 中添加新供应商:
- 选择API类型:阿里云百炼
- 输入API-KEY
- 设置模型名称(如 qwen-max、qwen-plus 等)
配置 DeepSeek API
- 访问 platform.deepseek.com/
- 注册账号并登录
- 进入 API 密钥管理页面
- 创建新的 API 密钥
- 复制 API 密钥
在 CCSwitch 中添加 DeepSeek 供应商:
- 输入 DeepSeek API 密钥
- 设置模型名称(如 deepseek-chat、deepseek-coder 等)
第六部分:开始使用
安装配置完成后,在终端中进入您的项目目录:
bash
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 被禁
