编码搭档（Code CLI）
【编码搭档】用于安装、配置和启动常见编程命令行工具。Cherry Studio 会区分应用托管版本、系统 PATH 中已有版本和工具自己的账号登录，不会自动覆盖系统安装。
① 左侧选择工具并确认安装状态；② 右侧选择统一网关、工具官方账号或兼容的模型服务。
页面能做什么
- 检查工具是否安装以及是否有可用更新；
- 安装、更新或移除 Cherry Studio 托管的工具副本；
- 检测系统 PATH 中已有的工具；
- 为需要模型服务的 CLI 选择服务商、模型和参数；
- 为使用自身账号登录的 CLI 保留原生登录方式；
- 选择工作目录和系统检测到的终端后启动。
页面包含 Claude Code、OpenAI Codex、Gemini CLI、OpenCode、Qwen Code、Kimi Code、Qoder CLI、GitHub Copilot CLI、Pi 和 DeepSeek Harness 等工具。实际可见项会随产品更新变化，以页面列表为准。
通用启动流程
2. 完成安装或登录
未安装时点击【安装】。由工具自身提供账号登录的 CLI，按照页面提示完成原生登录，不需要从 Cherry Studio 选择服务商。
3. 配置模型连接
需要 Cherry Studio 模型服务的工具，可选择【统一网关】或兼容的服务商和模型。页面会按 CLI 所需的接口类型筛选，不兼容的服务商不会列出。
4. 选择目录和终端
工作目录决定 CLI 启动位置。终端只能从系统检测到的列表中选择；启动后先用只读命令确认当前路径。
5. 启动并验证
点击【启动】，确认账号或模型正确，再执行文件修改或命令。需要调整推理强度、权限或工具专属选项时，打开【配置】。
Claude Code 的模型模式
配置 Claude Code 时，【模型】提供两种模式：
- 【通用】：所有请求使用同一个模型，配置简单；
- 【详细】：在【模型角色映射】中分别设置 Fable、Opus、Sonnet、Haiku 和 Subagent。表格里的【实际请求模型】就是每个角色最终使用的模型；需要时还可为对应角色开启【1M】上下文。
只有确实需要为后台子任务、压缩或标题等角色指定不同模型时，才使用【详细】。留空的角色会跟随主模型。修改后先用一个小任务确认每个角色都能正常请求。
DeepSeek Harness
① 未安装时先完成托管安装；安装后配置兼容服务商、默认权限和智能体模式，再启动 Web UI。
DeepSeek Harness 与普通终端 CLI 的流程不同：安装并选择服务商后，由 Cherry Studio 托管运行，并可打开独立 Web UI。参数中可以选择默认智能体模式和默认权限：
| 配置 | 适合情况 | 注意事项 |
|---|---|---|
| 【标准】 | 文件、Shell、检索、技能、计划和子代理都可能使用 | 工具面最大，先使用受控权限 |
| 【PTC 代码】 | 需要通过 Code Mode 组合多步工具操作 | 更适合复杂编码任务 |
| 【极简】 | 只需要持久 Shell 和文本编辑器 | 依赖少，能力范围也更小 |
| 【只读】 | 检查项目、不写文件 | 有风险操作仍会请求确认 |
| 【工作区写入】 | 允许修改当前 DSH 工作区 | 不代表可以访问工作区外文件 |
| 【完全访问】 | 隔离、可信、可恢复的环境 | 不请求操作确认，风险最高 |
安装来源要分清
| 来源 | Cherry Studio 会做什么 | 你应该如何维护 |
|---|---|---|
| Cherry Studio 托管 | 安装、更新和卸载对应托管副本 | 在【编码搭档】或【环境依赖】中管理 |
| 系统 PATH | 检测并直接使用，不覆盖 | 用原包管理器更新或卸载 |
| 工具官方账号 | 保留工具自己的登录流程 | 在工具界面管理账号和授权 |
| 应用内置 | 直接使用，不提供系统级卸载 | 随 Cherry Studio 更新 |
使用场景：在项目目录启动编码工具
| 选择 | 建议起点 | 适用场景 | 注意事项 |
|---|---|---|---|
| 安装来源 | 已有系统版本就先使用系统版本 | 团队已经统一管理 CLI | 更新和卸载仍由原包管理器负责 |
| 模型连接 | 先选一个已经在 Cherry Studio 验证可用的连接 | 需要模型服务的 CLI | 自带账号登录的工具按原生流程登录 |
| 工作目录 | 只选择当前项目目录 | 修改代码、运行检查 | 启动后先确认终端所在路径 |
| 第一次命令 | 只读查看项目状态 | 验证账号、模型和目录 | 确认无误后再允许写文件 |
完成标准
页面能识别安装来源；终端在正确目录打开；最小只读命令成功；工具显示的账号或模型与预期一致。
为什么找不到已经安装的终端或 CLI？
Cherry Studio 从登录环境和标准位置检测工具。确认命令在登录终端中可运行，然后重启应用刷新环境。便携式或非标准路径目前需要从该终端手动启动。