For the complete documentation index, see llms.txt. This page is also available as Markdown.

编码搭档

【编码搭档】用于安装、配置和启动常见编程命令行工具。Cherry Studio 会识别自己的托管安装,也会检测系统登录环境中已经可用的 CLI;系统工具仍由原来的包管理器维护。

编码搭档页面中的安装状态、版本检查和 Code CLI 提供方
先确认工具已经安装且版本可用,再配置模型连接和项目目录。

页面能做什么

  • 检查工具是否安装以及是否有可用更新;

  • 安装或更新 Cherry Studio 托管的工具副本;

  • 检测系统 PATH 中已有的工具;

  • 为需要模型服务的 CLI 选择服务商和模型;

  • 为使用自身账号登录的 CLI 保留原生登录方式;

  • 选择工作目录和系统检测到的终端后启动。

页面当前包含 Claude Code、OpenAI Codex、Gemini CLI、OpenCode、Qwen Code、Kimi Code、Qoder CLI 和 GitHub Copilot CLI 等工具。实际可见项会随产品更新变化,以页面列表为准。

使用流程

1

1. 打开左侧导航【编码搭档】

选择需要的工具,先看状态是未安装、由 Cherry Studio 托管,还是来自系统。

2

2. 完成安装或登录

未安装时点击【安装】。由工具自身提供账号登录的 CLI,按照页面提示完成原生登录,不需要从 Cherry Studio 选择服务商。

3

3. 配置模型连接

需要 Cherry Studio 模型服务的工具,选择兼容的服务商和模型。页面会按 CLI 所需的接口类型筛选,不兼容的服务商不会列出。

4

4. 选择目录和终端

工作目录决定 CLI 启动位置。终端只能从系统检测到的列表中选择;自定义终端可执行文件路径不再提供。

5

5. 启动并验证

点击【启动】,在终端中运行一个只读检查。确认账号、模型和目录正确后再执行文件修改或命令。

Claude Code 的模型模式

配置 Claude Code 时,【模型】提供两种模式:

  • 【通用】:所有请求使用同一个模型,配置简单;

  • 【详细】:在【模型角色映射】中分别设置 Fable、Opus、Sonnet、Haiku 和 Subagent。表格里的【实际请求模型】就是每个角色最终使用的模型;需要时还可为对应角色开启【1M】上下文。

只有确实需要为后台子任务、压缩或标题等角色指定不同模型时,才使用【详细】。留空的角色会跟随主模型。修改后先用一个小任务确认每个角色都能正常请求。

使用场景:在项目目录启动编码工具

选择
建议起点
适用场景
注意事项

安装来源

已有系统版本就先使用系统版本

团队已经统一管理 CLI

更新和卸载仍由原包管理器负责

模型连接

先选一个已经在 Cherry Studio 验证可用的连接

需要模型服务的 CLI

自带账号登录的工具按原生流程登录

工作目录

只选择当前项目目录

修改代码、运行检查

启动后先确认终端所在路径

第一次命令

只读查看项目状态

验证账号、模型和目录

确认无误后再允许写文件

完成标准

页面能识别安装来源;终端在正确目录打开;最小只读命令成功;工具显示的账号或模型与预期一致。

安装来源要分清

来源
Cherry Studio 会做什么
你应该如何维护

Cherry Studio 托管

安装、更新和卸载对应托管副本

在【编码搭档】或【环境依赖】中管理

系统 PATH

检测并直接使用,不覆盖

用原包管理器更新或卸载

应用内置

直接使用,不提供系统级卸载

随 Cherry Studio 更新

为什么找不到已经安装的终端或 CLI?

Cherry Studio 从登录环境和标准位置检测工具。确认命令在登录终端中可运行,然后重启应用刷新环境。便携式或非标准路径目前需要从该终端手动启动。

最后更新于

这有帮助吗?