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

第一部分:安装 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

  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 等)

第六部分:开始使用

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

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 被禁

解决方案:更换 API key
相关推荐
计算机编程-吉哥17 分钟前
YOLO26 vs YOLO11 vs YOLOv8:深度学习咖啡果实成熟度分割系统【计算机毕业设计选题推荐】
人工智能·python·深度学习·yolo·django·毕业设计
冬奇Lab28 分钟前
一年前没启动 AI 提效的团队,今年在付什么钱?
人工智能
NeoGressAI外贸数字化1 小时前
IOR新规9月18日生效:Form 5106六项资料自查清单
人工智能
根目录下的猫2 小时前
RK3588适配的轻量级AI模型推荐
人工智能·后端·python·目标检测
weixin_6682 小时前
Cursor 插件使用说明:Linear 与 Figma
人工智能·cursor
wshzd2 小时前
LLM之Agent(六十八)|PI(七)构建测试与开发流程
人工智能
H0311169852 小时前
App竞品数据平台功能梳理:月狐数据、七麦数据、点点数据
人工智能
YOLO数据集集合3 小时前
高铁轨道紧固件损坏检测数据集 | 高铁巡检 紧固件缺陷 轨道安全9093期
人工智能·目标检测·计算机视觉·目标跟踪·轨道·铁轨紧固件·铁轨
冬奇Lab3 小时前
一天一个开源项目(第223篇):TeamAI-CLI —— 腾讯开源的团队级 AI Agent 中间层,让每个人的 AI 能力变成团队共享能力
人工智能·开源·资讯
ShineWinsu3 小时前
对于Coze—AI:SDK的解析
人工智能·python·ai·sdk·项目·coze·字节跳动