参考
指南讲的是怎么做 —— 如何运行智能体、接入频道、生成文档。而本节讲的是是什么：逐屏带你了解 Codeg 的设置、应用的构建方式、它如何对待你的数据，以及如何从源码构建它。当你盯着某个具体的开关、想确切知道它的作用时，就来查阅这里。
Codeg 的一些设置界面足够复杂，因而在指南中拥有各自的操作教程 —— MCP、技能、智能体。其余的则是你设置一次便可忘记的配置。下面的地图涵盖了全部界面，让你总能找到某个界面在何处有文档说明，然后直接跳转过去。
设置全貌
Codeg 将每一项偏好都汇集到同一个设置窗口中（其侧边栏标题为偏好设置）。以下是完整的全貌，按应用列出的顺序排列，并标明每个界面的文档所在位置：
| 设置界面 | 控制内容 | 文档位置 |
|---|---|---|
| 外观 | 主题模式与配色、窗口缩放、字体、桌面宠物 | 外观 |
| 常规 | 默认终端、命令输出颜色、渲染、关闭按钮行为、桌面通知与提示音 | 常规 |
| 协作 | 智能体之间的委派，以及每个智能体拿到的会话内工具 | 协作 |
| MCP | Model Context Protocol 服务器 —— 添加、扫描、按智能体启用 | 指南 → MCP 服务器 |
| Skills | 编写和编辑你自己的智能体技能 | 指南 → 技能 |
| 技能包 | 精选合集 —— Experts、Science、Office | 指南 → 技能 |
| 智能体 | 智能体 CLI —— 连接、配置、运行预检，以及注册你自己的 | 指南 → 使用智能体 |
| 模型供应商 | 智能体使用的 API 提供商凭据 | 指南 → 认证与模型 |
| 快捷消息 | 供 composer 使用的可复用消息片段 | 快捷消息 |
| 浏览器操作 | 内置浏览器 —— 链接在哪里打开、站点规则、智能体在页面上能看到和做什么 | 浏览器操作 |
| 电脑操作 | 让智能体查看并操作你共享的桌面窗口 —— 驱动、macOS 权限、永不共享名单、如何停止 | 电脑操作 |
| 快捷键 | 键盘快捷键 | 快捷键 |
| 版本控制 | Git 可执行文件、GitHub、GitLab 及其他 Git 账户 | 版本控制 |
| 消息渠道 | 用于通知和远程控制的 IM 机器人 | 指南 → 聊天频道 |
| Web 服务 | 将 Codeg 暴露给浏览器 —— 端口、令牌、二维码 （仅桌面应用） | Web 服务 |
| 运行日志 | 诊断日志 —— 级别、实时查看器、文件 | 运行日志 |
| 系统 | 更新、开机自启、网络代理、语言、备份与恢复 | 系统 |
打开设置后，你会首先看到外观。无论你运行桌面应用还是通过浏览器访问 Codeg，每个界面都在 —— 只有一个例外，它在浏览器会话里会从导航中去掉：Web 服务，因为正是这个界面开启了浏览器访问。另有两个界面虽然也在，但内容更少。浏览器操作只保留在浏览器里仍然决定着某些事的那几行 —— 站点规则（用于阻止）、终端里起的服务要怎么处理，以及终端的链接菜单。电脑操作作用于服务器所在机器自己的桌面，而且只有当那台服务器以 CODEG_COMPUTER_USE=1 启动时才可用。
六个界面在指南中有完整的操作教程
MCP、Skills、技能包、智能体、模型供应商和消息渠道是你要使用的功能，而不仅仅是你调整的设置 —— 因此它们被写成了任务型指南。其余十一个界面在这里以参考形式介绍。
应用一动，这张地图就跟着动
0.33.0 新增了电脑操作，把浏览器改名为浏览器操作与它并列，并重新编排了列表：协作现在紧跟在常规之后，快捷消息则排到了这两个「操作」界面之前。协作和浏览器这两个界面本身也是新近才有的，都是在 0.31.2 从常规里拆出来的。本文档里浏览器那一页的地址在改名后保持不变，所以旧链接依然能落到它上面。
架构与安全
Codeg 是如何构建的，以及它如何处理你所交付的内容。
- 架构 —— 一个 Rust 核心，四个二进制文件：
codeg桌面应用、独立的codeg-server、驱动委派与会话内工具的codeg-mcp伴生程序，以及支撑电脑操作的codeg-computer-helper。各部分如何组合在一起，以及它们如何通过 ACP 驱动外部智能体 CLI。 - 隐私与安全 —— 哪些内容留在你的机器上、网络何时才真正被使用，以及智能体凭据和 Web 服务令牌如何被处理。
贡献
- 开发 —— 环境要求、每个二进制文件的构建命令，以及从源码构建 Codeg 的开发流程。
这里的一切描述的都是你实际运行的应用 —— 桌面应用或服务器。至于项目本身 —— Codeg 背后的人、社区以及许可证 —— 请参见关于。