这篇文档记录了一步步完成Claude Code的模型配置，以及辅助工具CC Switch的使用，全程图文结合，新手也能轻松跟着操作。

---

一、获取API密钥

以火山方舟Coding Plan为例

要使用Claude Code，首先需要获取对应平台的API密钥，这里以火山引擎方舟Coding Plan服务为例：

1. 登录火山引擎方舟控制台，在产品列表中找到并开通Coding Plan服务
   

2026-4，目前开通Coding套餐比直接烧Token划算。方舟Coding Plan中，大多数模型都不适合重度编程，lite初级套餐做文案创作还行，不适合代码创作。

2. 进入Coding Plan服务管理页面，在「API密钥管理」 tab 下点击「创建密钥」
   
3. 从页面中复制API密钥，后续配置需要使用

其他平台（如MiniMax、GLM、百炼Coding Plan等）的获取流程大体类似，一般都是在对应平台的控制台中找到API密钥管理页面，创建并复制密钥即可，获取后可以直接跳转到「二、Claude Code手动配置模型」章节进行配置。

---

二、Claude Code 手动配置模型

如果你想自定义模型，可以用手动配置的方式，有两种方法可选：

方法1：修改配置文件

找到Claude Code的配置文件（一般在用户目录下的.claude文件夹里的settings.json），在里面添加以下配置项：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ark.cn-beijing.volces.com/api/coding",
    "ANTHROPIC_AUTH_TOKEN": "这里粘贴刚才提到的API-KEY",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "doubao-seed-2.0-lite",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "doubao-seed-2.0-pro",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "doubao-seed-2.0-code",
    "ANTHROPIC_MODEL": "kimi-k2.5",
    "ANTHROPIC_REASONING_MODEL": "glm-4.7",
    "API_TIMEOUT_MS": "600000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
}

以上是用方舟Coding Plan举例，保存文件后重启Claude Code就生效了。默认生效模型为ANTHROPIC_MODEL对应的字段。

方法2：命令行切换

如果你只是临时想用某个模型，可以直接在启动Claude Code的时候指定：

claude --model kimi-k2.5

或者在Claude Code运行过程中用命令切换：

/model kimi-k2.5

---

三、CC Switch 手动配置模型

如何获取CC Switch安装包

在配置CC Switch之前，你需要先获取CC Switch安装包，可通过以下方式获取：

1. Github渠道下载：前往CC Switch发布页面下载最新版本的安装包【cc-switch v3.12.3】；
2. 直接问AI如何下载；
3. 在Trae中提需求，帮我下载CC Switch（xxx平台）软件【亲测可行】；
4. 下载完成后直接运行exe文件即可打开使用，无需额外安装步骤。

CC Switch是Claude Code的辅助工具，可以可视化管理模型配置，操作非常简单：

1. 打开CC Switch，点击主界面的配置入口：
   

2. 点击编辑按钮进入编辑模式：
   

3. 在配置模型页面添加你想用的模型，保存即可：
   
   这里能够对配置进行可视化修改。

---

四、测试模型是否配置成功

配置完成后，我们可以简单测试一下模型是否能用：

1. 打开Claude Code
2. 输入一个简单的问题，比如写一个hello world的Python代码
3. 如果能正常返回结果，说明模型配置成功了
4. 可以多试几个不同复杂度的问题，确认不同模型的切换都正常

---

五、CC Switch 配置Skills

CC Switch还可以管理Claude Code的技能（Skills），相当于给Claude Code装插件，让它功能更强：

1. 打开CC Switch，点击Skills入口：
   

2. 进入Skills管理页面，这里可以安装、删除、管理所有技能：
   

---

六、CC Switch添加技能的三种方式

以图形化的方式搜索、安装技能更为直观。CC Switch有三种方法可以给Claude Code添加技能，推荐优先用「发现技能」的方式：

方式1：导入已有技能（适合已有技能包的情况）

如果别人给了你现成的技能包，或者你之前备份过，可以直接导入；我将之前下载过的技能导入：ui-ux-pro-max（UI设计专用）、using-superpowers（技能使用指南）

方式2：从zip安装

你也可以从网上下载技能的zip压缩包，然后本地安装。

技能包一般可以在GitHub或者官方技能市场下载，安装的时候注意看一下代码内容，确认安全再装。

方式3：发现技能（推荐）

这是最安全方便的方式，直接从官方技能库安装，推荐新手先装这几个常用的：

• ui-ux-pro-max
• using-superpowers
• writing-plans
• executing-plans
• brainstorming
• subagent-driven-development

安装过程很简单，找到想要的技能，点安装就行：

---

七、常用技能介绍

上面推荐的6个技能都是日常开发非常实用的，下面给你介绍每个技能是做什么的，什么时候用：

技能名称	作用	使用场景
ui-ux-pro-max	UI/UX设计专用智能	做网站、APP、小程序等界面设计、前端开发、UI优化的时候调用，支持React、Vue、Tailwind等多种技术栈和玻璃态、极简风等设计风格
using-superpowers	技能使用指南	刚开始使用技能、不知道如何调用技能、想了解技能功能的时候调用，会教你正确使用各类技能
writing-plans	自动生成任务执行计划	遇到复杂任务、多步骤需求的时候，先调用这个技能生成详细的执行步骤，避免做一步想一步
executing-plans	自动执行写好的计划	已经有了明确的执行计划的时候，调用这个技能可以一步步帮你完成，还会自动检查每一步的结果
brainstorming	头脑风暴工具	需要创意、想方案、设计功能的时候调用，会帮你发散思路，提供很多不同的想法
subagent-driven-development	子代理开发	大型项目可以拆成多个独立任务，每个任务交给不同的子代理并行处理，提高开发效率

---

八、注意事项

避免安装重复技能

安装技能的时候注意不要装重复的，重复的技能不仅会占用空间，还可能导致冲突，出现莫名其妙的问题。

怎么检测重复技能？

1. 打开CC Switch的Skills管理页面，所有已安装的技能都会列在这里
2. 看技能的名称和描述，如果有两个技能名称一样，或者功能几乎一样，就是重复的
3. 保留版本最新、下载量最高的那个，删掉另一个就可以了
4. 每次安装新技能之前，先搜一下有没有已经装过同名的，再决定要不要装