使用智能体
Codeg 不附带自己的模型。它是一个为智能体而生的工作区——它连接到你已经在运行的编程智能体 CLI，例如 Claude Code、Codex 和 Gemini，并给它们每一个都提供同一套界面：同一个 composer、同样的文件和 diff、同样的 git 和终端。你选择由哪个智能体处理一段对话，而它周围的一切都保持不变。
本页涵盖要点——启用一个智能体、确认它已准备好运行，以及开启一个会话。相邻的两个页面讲得更深入：支持的智能体是完整名单，而认证与模型介绍登录和选择模型。
智能体的工作原理
每个智能体都是一个独立的命令行程序。当你开启一个会话时，Codeg 会把该程序作为后台进程启动，并通过 Agent Client Protocol（ACP）与它通信——这种共通的语言让一个工作区能够驱动许多不同的智能体。这正是无论你选择哪一个，体验都保持一致的原因。
Codeg 如今支持十一个智能体，通过三种方式交付——而且它会为你安装和更新它们：
- 大多数通过 npx（一个 npm 包）运行，因此它们需要你的机器上装有 Node.js。
- OpenCode 是一个原生二进制文件，由 Codeg 为你的平台下载。
- Hermes 通过 uv（一个 Python 工具运行器）运行。
对于每个智能体，有两件事是分开跟踪的：它是否已启用（允许出现在 Codeg 中），以及它是否已安装（实际存在于你的机器上）。二者相互独立——你可以在安装某个智能体之前先启用它，等时机到来时 Codeg 会帮你安装它。
启用一个智能体
智能体在设置 → 智能体中管理（标题为 Agent SDK Management）。左侧的智能体列表包含每一个受支持的智能体；选择一个即可在右侧查看它的详情。所有智能体默认都已启用，因此通常无需开启任何东西——但每个智能体标题栏中的启用开关可以让你隐藏那些你不使用的。
只有已启用的智能体才会出现在 composer 的智能体选择器中。把那些你永远不会碰的禁用掉，可以让列表保持简短；如果你把所有的都禁用了，composer 只会提示你打开智能体设置并重新启用一个。
确认它已就绪——预检
打开设置 → 智能体，Codeg 会对每个智能体运行一次预检检查——一份快速的健康报告，让你在依赖它之前就知道它确实能运行。你会看到一行版本状态（最新版本与本地已安装版本的对比，或未安装），随后是一份简短的核对清单，每一项都标记为 PASS、WARN 或 FAIL。
它检查什么，取决于智能体是如何交付的：
- npx 智能体——检查 Node.js 和 npm 是否已安装且版本足够新（每个智能体都设定了一个最低 Node 版本）。
- OpenCode——检查你的平台是否受支持、二进制文件是否已下载，以及它的插件是否已安装。
- Hermes——检查 uv 运行时是否可用。
每一项未通过的检查旁边都配有一个修复按钮——安装 Node.js、安装 uv、安装插件等等——版本行还会按需提供安装、升级或卸载。在 Codeg 之外改动了什么？刷新检查会重新运行预检。
预检检查的是底层环境，而非登录
预检确认的是运行时、版本和安装情况——而不是你是否已登录。让一个智能体完成认证（用它自己的订阅、一个 API 密钥或一个自定义端点）是一个单独的步骤。→ 认证与模型
配置一个智能体
大多数智能体一经安装就能工作，但每个智能体的详情面板都有许多可供你调整的地方——而且有两种方式来做：用可视化控件处理日常设置，或用智能体的原始配置文件处理任何 UI 未暴露的内容。
- 可视化设置。 面板将常见选项以普通表单控件的形式呈现——登录、模型选择、自定义端点、推理强度，以及每个智能体自己的各种开关——因此你很少需要手动编辑任何东西。登录和选择模型在认证与模型中介绍。
- 环境变量。 在智能体启动时传递给它的
KEY=value键值对。 - 配置管理。 直接从 Codeg 编辑智能体自己的原生配置文件（它的 Native JSON Config），用于处理可视化控件触及不到的设置。
- 拖动可重新排序。 智能体列表的顺序同时也是一种偏好设置——当没有指定其他智能体时，第一个已启用的智能体就是 Codeg 会选用的那个（详见下文）。
在会话打开期间更改某项设置，该会话会继续以它旧的配置运行——Codeg 不会在任务中途打断你。取而代之的是，一个横条会出现在对话顶部，提示它仍在使用先前的配置；点击重新连接以应用，会话就会带着新设置重新加载，同时保留其完整历史。无需关闭再重新打开任何东西。
开启一个会话
开启一个新对话，composer 会显示一个智能体选择器——一排药丸形按钮，每个已启用的智能体一个。点击其中一个，Codeg 就会连接到它；接着，在 composer 中选择一个模型和一个模式。这两个列表都来自智能体本身，而非 Codeg，因此可供选择的内容取决于你正在运行哪个智能体。你对智能体的选择会在你发送第一条消息后锁定——一段对话会一直由开启它的那个智能体来处理。
默认用哪个智能体？ Codeg 按以下顺序选择：
- 文件夹的默认智能体，如果你设置过的话（文件夹菜单 → 设为默认智能体）。
- 否则，就是你在设置 → 智能体中排序里的第一个智能体。
因此，按文件夹设置的默认值总是优先，而列表顺序是后备方案。→ 工作区 介绍了如何设置文件夹的默认值。
当你第一次在会话中使用某个智能体时，你会看到 正在连接…，此时 Codeg 正在启动 CLI 并完成握手。如果它无法连接——智能体被禁用、未安装、在你的平台上不受支持，或响应缓慢——Codeg 会弹出一个提醒（状态栏中的铃铛），说明出了什么问题，并指引你前往设置 → 智能体去修复它。
连接状态
在你工作时，底部的状态栏会显示活动的智能体及其状态——正在连接…、已连接、正在响应… 或 已断开——当智能体忙碌时，它的图标会跳动。
你没有在看的会话可能会在闲置几分钟后断开连接以释放资源，但你正在活跃使用的标签页会保持连接，而当你回到某个会话时，Codeg 会自动重新连接。