Agent、模型与用量 — Noea Code 文档

Agent 负责读取项目和执行任务，模型负责理解与生成内容。本篇介绍如何管理 Agent、连接模型供应商、选择配置，以及查看用量。可用的模型、登录方式和功能取决于所选 Agent。

管理本机 Agent

打开“设置 → 智能体”。当前提供 Codex、Claude Code、OpenCode 和 CodeBuddy Code，各自显示版本、状态和主操作。

点击某一行可打开该 Agent 的详情面板，进行安装、登录、检查、更新或卸载。各 Agent 分别准备；关闭面板不会中断已经开始的准备过程。

“就绪”表示 Agent 已通过验证。显示“已安装”或“检测到凭据”时，还需等待验证结果；失败时按详情面板的提示处理。首次准备步骤见安装与准备。

支持多个模型供应商的 Agent 会在详情面板中显示供应商列表。选择供应商后，按提示使用账号或 API Key（API 密钥）连接。

同一个供应商在不同 Agent 中分别连接和管理。登录与凭据保存由 Agent 负责，Noea 不另行保存登录密钥；Agent 仍可能在本机保存认证数据。

OpenCode 还提供“添加自定义端点”。填写名称、Base URL、协议和至少一个模型，保存后继续在登录窗口配置凭据。协议可选 Chat Completions 或 Responses，应与你的服务接口一致。

列表读取失败与尚未连接不是同一件事。需要确认现状时，使用“刷新”，查看读取时间和连接结果。

在输入框下方的配置菜单中，选择 Agent、模型和推理强度。推理强度用于调整模型处理问题时的推理投入。模型按供应商分组；推理强度、计划模式、快速模式等选项以 Agent 实际支持的内容为准。

新对话通常沿用最近一次成功连接的普通对话所选 Agent。第一条消息前可以切换 Agent，连接后则不能更换；需要换 Agent 时新建对话。

部分模型列表需要连接后才能获得，界面会提示“连接后可选”。当前 Agent 不接受某个选项时，该选择不会生效，并会在对话中说明。

权限使用输入框中的独立入口设置。请按当前任务选择 Agent 提供的权限选项。

打开“设置 → 当前项目 → 操作”，分别为“实现”“解释”和“整理源文档”指定 Agent、模型和推理强度。

这些配置只用于相应项目操作，不会更改所有普通对话的设置。对话实现后自动启动的解释跟随该对话的 Agent；接受整理后的解释使用项目的解释配置。

所选 Agent 不可用时，应用会使用可用的替代项并显示提示。运行前可以在这里确认当前实际选择。

输入框下方的小圆环显示上下文占用。点击后，可以查看上下文、账户额度或余额，以及当前对话的 token 与费用信息。Token 是模型处理文本等内容时使用的计量单位，不等同于字数。

上下文占用表示本次对话使用了多少模型可处理的内容空间；账户额度表示供应商或 Agent 对使用量的限制。两者含义不同。

进入“设置 → 用量”，或在用量面板中选择“查看全部用量”，可以按今天、近 7 天、近 30 天或全部查看。展开某个 Agent 后，可查看模型和 token 明细。

读数会显示更新时间。刷新失败时保留旧值；超过重置时间后，应刷新再判断。某个 Agent 不支持读取额度时，界面会明确说明不可用。

连接问题见故障排查，扩展配置见添加 MCP 与 Skill。