Cherry Studio 编码搭档里的 Claude Code 模型模式，通用 vs 详细角色映射
为什么需要两种模式
Claude Code 在执行编程任务时，内部会根据任务性质自动选择不同的 Claude 模型角色：
- Fable / 叙述模型：生成回复内容（如对话、代码注释）
- Opus：最复杂的推理任务（架构设计、难题）
- Sonnet：日常均衡任务（大多数代码生成）
- Haiku：轻量快速任务（格式化、小改动）
- Subagent：后台子任务（压缩、标题生成）
如果所有角色都用同一个模型，能跑但不是最优——给 Opus 和 Sonnet 都用最贵的旗舰模型，成本偏高；给 Sonnet 和 Haiku 都用便宜模型，Opus 的复杂推理可能不够用。
Cherry Studio 编码搭档提供两种模式让你按需配置。
通用模式（简单场景）
选一个主力模型，所有请求都用同一个模型。配置简单，适合：
- 刚上手 Claude Code，还不确定角色分工
- 团队统一配置，所有人用同一套
- 不关心成本，只求简单
在编码搭档里点 Claude Code → 模型 → 选「通用」→ 从 Cherry Studio 已配置的服务商里选一个模型。
详细模式（精细控制）
在「模型角色映射」里为每个角色单独指定模型：
| 角色 | 说明 | 常见搭配 |
|---|---|---|
| Fable | 回复叙述 | Sonnet（主力）或 Haiku（轻量） |
| Opus | 复杂推理 | Opus 旗舰模型 |
| Sonnet | 日常任务 | Sonnet 主力模型 |
| Haiku | 轻量快速 | Haiku 轻量模型 |
| Subagent | 后台子任务 | Haiku 或更便宜的模型 |
表格里的「实际请求模型」就是每个角色最终调用的模型。可以为空（留空的角色跟随主模型），也可以开启「1M」上下文（Opus 等支持的模型）。
只有确实需要为后台子任务、压缩或标题等角色指定不同模型时，才用详细模式。改完先用一个小任务确认每个角色都能正常请求，再投入正式使用。
工作目录和终端
配置完模型后，选一个工作目录——这决定 Claude Code 启动时所在的文件夹。启动后它会在这个目录的上下文里理解项目结构、读取文件、修改代码。建议直接选当前项目目录。
终端只能从 Cherry Studio 系统检测到的列表里选——不支持自定义可执行文件路径。如果系统终端不在列表里，先在登录终端里跑通 claude-code 命令，再重启 Cherry Studio 刷新检测。
启动后第一步
点「启动」后，在 Claude Code 终端里先执行一个只读检查命令：
- 查看项目结构：
ls或tree - 查看当前状态：
git status - 读一个文件确认模型权限正常：让 Claude Code "看一下 README.md 讲了什么"
确认账号、模型和目录都正确后，再允许它做文件修改或跑命令。这是 Cherry Studio 官方文档建议的安全工作流。
编码搭档 + Agent 的配合
Agent 智能体 可以在终端执行里调用编码搭档安装的 CLI——比如让 Agent 跑 claude-code 来处理一个具体的编程任务，把结果整合回主工作流。Agent 负责整体编排，编码搭档里的 CLI 专注编程细节。