CCSwitch配置Claude Code教程：Windows/macOS/Linux完整使用指南

SEO关键词：Claude Code教程、CCSwitch配置教程、Claude Code国内使用、CCSwitch连接Claude、Claude API配置、Claude Opus 4配置、Claude Code安装教程

大家好 这里是「代码简单说」`,欢迎大家关注同名公众号,不定时更新更多实用有趣的教程 也欢迎大家在评论区一起讨论交流!~

前段时间有不少开发者问我，Claude Code虽然非常强大，但是配置起来总会遇到各种问题，例如模型无法连接、API配置错误、环境变量设置失败等。

经过实际测试，我发现使用 CCSwitch 管理 Claude Code 配置是目前比较方便的一种方案。

本文详细介绍从安装 CCSwitch、获取 API Key、配置模型，到最终成功启动 Claude Code 的完整流程。

---

目录

• 前言

• 什么是CCSwitch

• 安装CCSwitch

  • Windows安装
  • macOS安装
  • Linux安装

• 获取API Key

• CCSwitch配置Claude Code

• 配置模型名称

• 启动Claude Code

• 手动配置Claude Code

• 常见问题

• 总结

---

什么是CCSwitch

CCSwitch 是一个用于管理 Claude Code 配置的图形化工具。

相比手动修改各种配置文件，它具有以下优势：

功能	说明
图形化管理	无需频繁编辑JSON
多模型切换	快速切换不同Claude模型
多配置管理	支持多个API配置
一键启动	简化Claude Code使用流程

对于经常使用 Claude Code 的开发者来说，可以显著降低配置成本。

---

安装CCSwitch

安装包下载

下载地址：

软件	下载地址
CCSwitch	https://pan.quark.cn/s/1345770b19d5

下载完成后直接安装即可。

获取API Key

安装完成后，需要先申请 Claude API Key。

注册地址：

https://api.aisz.mom/sign-up?aff=5kRW

注册并登录后进入控制台。

---

第一步：生成令牌

点击首页：

创建API密钥

或者左侧菜单：

API密钥

进入管理页面。

---

点击：

创建API密钥

---

第二步：选择分组

根据自己的需求选择对应分组。

不同分组支持的模型可能不同。

选择完成后点击：

保存更改

---

第三步：复制API Key

系统会生成类似：

sk-xxxxxxxxxxxxxxxxxxxxxxxx

复制保存。

注意：

API Key相当于账号密码，请勿公开或分享给他人。

---

CCSwitch配置Claude Code

打开已经安装好的 CCSwitch。

启动：

CC-Switch

点击右上角：

+

选择：

自定义配置

然后填写刚刚获取的 API Key。

示意流程：

CCSwitch
    ↓
+
    ↓
自定义配置
    ↓
填写API Key
    ↓
保存

---

配置模型名称

添加配置后，需要指定模型名称。

将默认模型替换成自己需要使用的模型。

例如：

claude-opus-4-8

配置完成后点击：

添加

即可保存。

---

模型查询

模型广场：

https://api.aisz.mom/pricing

在这里可以查看：

• Claude Opus
• Claude Sonnet
• Claude Haiku
• 其它兼容模型

注意：

模型必须在你当前API Key所属分组中可用，否则调用会失败。

---

官方推荐方法

完成配置后：

点击：

CC切换

选择对应模型即可。

随后直接启动 Claude Code。

---

编辑Claude配置文件

为了避免首次启动时出现认证问题，需要配置 .claude.json。

---

Windows路径

C:\Users\用户名\.claude.json

---

macOS/Linux路径

~/.claude.json

---

内容如下：

{
  "hasCompletedOnboarding": true
}

---

启动Claude Code

配置完成后进入项目目录。

执行：

claude

即可启动 Claude Code。

---

手动配置Claude Code

如果不想使用 CCSwitch，也可以直接修改配置文件。

---

Step1：编辑settings.json

Windows

C:\Users\用户名\.claude\settings.json

macOS/Linux

~/.claude/settings.json

配置内容：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aisz.mom",
    "ANTHROPIC_AUTH_TOKEN": "API_KEY",
    "ANTHROPIC_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-opus-4-8"
  }
}

其中：

API_KEY

替换为自己的真实 Key。

---

参数说明

参数	作用
ANTHROPIC_BASE_URL	API地址
ANTHROPIC_AUTH_TOKEN	API密钥
ANTHROPIC_MODEL	默认模型
ANTHROPIC_DEFAULT_SONNET_MODEL	Sonnet模型
ANTHROPIC_DEFAULT_OPUS_MODEL	Opus模型
ANTHROPIC_DEFAULT_HAIKU_MODEL	Haiku模型

---

注意：环境变量 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL 的优先级高于配置文件。

---

Step2：编辑.claude.json

Windows：

C:\Users\用户名\.claude.json

macOS/Linux：

~/.claude.json

内容：

{
  "hasCompletedOnboarding": true
}

---

常见问题

提示API认证失败

检查：

ANTHROPIC_AUTH_TOKEN

是否填写正确。

---

模型不存在

检查：

claude-opus-4-8

是否属于当前 Key 对应分组。

---

启动claude报错

先执行：

claude --version

确认 Claude Code 已正确安装。

---

配置不生效

优先检查：

echo $ANTHROPIC_AUTH_TOKEN

如果环境变量存在，会覆盖配置文件。

---

总结

通过 CCSwitch 配置 Claude Code 的流程并不复杂：

安装CCSwitch
    ↓
获取API Key
    ↓
添加自定义配置
    ↓
填写模型名称
    ↓
配置.claude.json
    ↓
启动Claude Code

相比手动维护多个配置文件，CCSwitch 的图形化界面更加方便，尤其适合经常切换模型或管理多个 API Key 的开发者。

如果你平时主要使用 Claude Code 进行代码生成、项目重构、Bug排查和自动化开发，建议优先采用 CCSwitch 进行统一管理，可以减少大量重复配置工作。

我的博客即将同步至腾讯云开发者社区，邀请大家一同入驻：https://cloud.tencent.com/developer/support-plan?invite_code=s5zo8maeo4in