通用
设置 → 通用 是一个包罗万象的界面：少量应用行为 —— 新终端打开哪个 shell、在 Windows 上窗口如何绘制、智能体事件要不要出声 —— 之后是那些用来决定 Codeg 向你的智能体提供哪些额外工具 的开关。
本界面共用两种保存方式。默认终端、渲染 和 提示音 在你更改的那一刻就生效（渲染随后会要求重启）。下方两个面板 —— 多智能体协作 和 会话内工具 —— 各自带有自己的 保存 按钮，在你按下之前，两者中的任何设置都不会生效。
默认终端
选择当你从终端栏或文件树打开一个新终端标签页时，Codeg 启动的 shell。默认 shell 下拉框是通过探测你的机器构建的，因此它列出的是你实际拥有的：
- 系统默认 —— 由你的操作系统提供的任何 shell。下拉框下方的文字会显示它当前解析出的 shell。
- 具名 shell —— 在 Windows 上是 PowerShell 7 (pwsh)、Windows PowerShell 和 Command Prompt (cmd)；未安装的 shell 仍会出现，并标注为 未安装。
- 自定义路径 —— 输入一个绝对路径（或可在
PATH上解析的名称），然后 保存。如果该路径在此主机上不存在，Codeg 会警告你，但仍允许你保存。
选择具名选项会立即保存；自定义路径则要等旁边的保存按钮。
这个 shell 所服务的终端，就是工作区中的那个。而从 0.25 起，它不只是那个终端：当一个智能体请求 Codeg 执行一整条命令行时，那条命令也走这个 shell。保持在系统默认上，则与以前完全一样。
非 POSIX 的 shell 可能读不懂智能体写的东西
智能体产出的是 POSIX 语法——&&、2>&1、$(…)。你交互时用什么 shell 是你的自由，但把这里指向一个不读 POSIX 的 shell，意味着智能体的命令行可能直接报语法错误，而不是做成任何事。会踩到这一点的是 fish、nushell 和 Windows PowerShell 5.1；PowerShell 7 和 cmd 各有自己的调用约定，已被单独处理。
渲染 （仅限 Windows 桌面）
一个复选框 —— 禁用硬件加速。如果应用出现黑屏或渲染故障（常见于某些 AMD GPU 或 Intel 集成显卡），就打开它。它会改变底层 webview 的绘制方式，因此 Codeg 会保存该选择，然后要求你 立即重启 以使其生效。
本节仅在 Windows 桌面版本 上出现 —— 在 macOS、Linux 以及任何浏览器会话中都会隐藏，因为在那些环境里它不起作用。
提示音
默认关闭。打开之后，智能体事件会播放一段短提示音，于是你可以把一个长回合丢在另一个窗口里跑，同时仍然知道它什么时候需要你。
这五个事件与聊天频道推送的完全一致 —— 同样的触发点，不同的出口；频道消息会离开这台机器，提示音不会：
| 事件 | 默认音效 |
|---|---|
| 对话完成 | 叮咚 |
| 权限请求 | 警示 |
| 智能体提问 | 清铃 |
| 代理错误 | 下行音 |
| 发送消息 | 静音 |
可选的音效共七种 —— 叮咚、清铃、短音、轻点、警示、下行音，外加静音，用来单独跳过某个事件而不影响其余 —— 每一种都有试听按钮。发送消息默认静音，因为它是由你自己的动作触发的，在五者中最没有提示价值。
有两项设置作用于全部事件：一个音量滑块，以及仅在窗口未聚焦时播放 —— 你正盯着 Codeg 时保持安静。
提示音按设备保存
这是本界面上唯一存在你所使用的那个浏览器或应用里、而不是存在 Codeg 数据库里的部分。音频输出是你所在那台机器的属性：一个连着同一台服务器的手机浏览器，没有理由因为你的桌面端配置过就开始响。它同时也意味着，提示音只会在那台设备的工作区窗口里播放。
多智能体协作
这个开关允许一个活动中的智能体将子任务交给其他智能体 —— 也就是 Codeg 的委派功能。界面上这张卡片名为多智能体协同，两个标签页：
- 通用 —— 启用委托（默认关闭；关闭时，
delegate_to_agent工具会从智能体的工具目录中隐藏）、最大委托深度（1–8，默认 1 —— 智能体生成智能体的链条可以递归多深），以及 已完成结果缓存（MB）（默认 512 —— 在主导会话运行期间，内存中保留多少已完成子智能体的输出；0= 无限制）。 - 子智能体配置 —— 按智能体设置的覆盖项（模式和配置），当一次委派调用将该智能体作为工作者生成时应用。这些标签页由实时的智能体注册表构建，因此自定义智能体也会有一个；而各项选项来自对每个智能体的实时探测 —— 你选的正是它将接受的。
按 保存 以应用。本面板是控制界面；具体的操作方法 —— 编写委派提示词、观察团队、把工作流转化为技能 —— 见 使用多智能体协作。
在这里打开的东西，仍可能在别处被收走，因此面板会明说：启用委托下方的一条警告会点名任何按智能体的 让智能体自己处理文件和命令 开关处于打开状态的智能体，因为那个开关会刻意收走委托工具。这份名单读自后端实际解析出的策略，而不是对该智能体环境变量的二次猜测——因此它与智能体真正会拿到的东西一致。
目标列表跟随你的启用开关
delegate_to_agent 只会公布你实际能启动的智能体，并在每次智能体启动时重新读取：你在设置 → 智能体中禁用的内置智能体会从它的目标列表中划掉，已启用的自定义智能体会被加进去，而被禁用的则根本不会被提供。因此关掉一个智能体，不仅是把它从 composer 选择器中隐藏，也把它从主导智能体眼前隐藏了。
会话内工具
一张卡片，五个开关，一个 保存 —— "codeg 在会话中额外提供给智能体的工具。工具在智能体启动时注入，改动只对之后启动的智能体生效。"
| 开关 | 默认 | 智能体因此获得什么 |
|---|---|---|
| 实时反馈 | 关闭 | 在它工作过程中接收你的备注与纠偏 —— 见下文 |
| 向用户提问 | 开启 | 暂停并向你抛出一个多选题，以卡片形式呈现在对话输入框上方。智能体会一直等到你作答或跳过 |
| 获取会话信息 | 开启 | 把你引用的会话 —— 形如 codeg://session/<id> 的徽章 —— 解析为它的标题、智能体、状态、工作区、Token 用量和最近的消息。只读 |
| 创建自动化 | 关闭 | 把这次对话保存为按计划运行的自动化 |
| 创建待办任务 | 关闭 | 从对话中往待办看板排一张卡片 |
前三个要么只读、要么只是发问。后两个会写入应用状态，这正是它们默认关闭的原因，也是它们除了在智能体启动时之外、还会在工具被调用的那一刻再检查一次的原因：关掉开关能挡住已经在运行的会话继续使用它。
获取会话信息会向智能体讲清一个会话徽章的含义：提及一个会话，就是你在刻意指向它，因此智能体无需被要求就会去查阅，你提及几个会话它就查几次。这与把 @智能体 提及当作委派指令是同一个思路。→ 接续另一段会话未竟的工作
实时反馈是怎么送到运行中的智能体那里的
一共有两条通道，你走哪一条取决于智能体：
- 直接推进当前回合。 如果智能体的适配器支持即时插入 —— 适配器 0.65.0 及以上的 Claude Code —— 你的备注会被插进已经在跑的那一轮，智能体立刻就能看到。composer 的 + 菜单会显示为插入到当前回合，对话框里也会这么说。
- 由智能体主动来取。 其余的智能体拿到的是一个工具，需要它自己主动调用。这类智能体通常只有在你提到时才会去查，所以请在提示词里加上类似"定期检查我的实时反馈"的话。
推不进去的备注不会丢 —— 它会改为排队，随下一轮一起发送，Codeg 会告诉你发生了这件事。附件始终走队列；只有文本才能被插进正在运行的回合。
值得了解
- 两种保存方式。 终端、渲染和提示音在更改时即生效；委派和会话内工具两个面板各自需要自己的 保存 —— 而渲染还额外需要一次重启。
- 工具开关在智能体下一次启动时生效。 每一个开关都会"为此开关打开之后启动的智能体"添加或移除一个工具 —— 此刻正处于连接状态的智能体不会在中途获得或失去该能力。但这并不要求是一个全新的对话：任何对话都会在它的智能体下一次启动时采用该改动，包括一个连接已结束、你之后又回到的既有对话。新建一个对话只是最稳妥的方式。（那两个创建类开关是例外，它们在被调用时会再检查一次。）
- 这些是 codeg-mcp 工具。 委派和全部五个会话内工具都由
codeg-mcp伴随进程提供；这里的开关决定哪些出现在每个智能体的目录中。不过并非每一个伴随工具都由这里管辖——正在执行待办的智能体还会拿到task_progress和task_complete，它们由任务引擎注入，而不是由本界面上的任何东西注入。 - 完全不接受 MCP 的智能体一个也拿不到。 一个把 MCP 支持 开关关掉的自定义智能体，连接时根本不会挂载伴随进程，因此本界面上的任何东西都到不了它那里。
- 渲染仅限 Windows。 在其他所有环境中，本节干脆不存在。