03 核心概念与功能
本地 Agent 切换
在本地项目中,除了使用 Mira,您还可以选择已接入的 Codex、Claude Code 等 Agent 处理代码、数据和项目文件。Mira 提供统一的对话入口,并展示 Agent 的执行过程、文件变更与授权请求。
安装和接入 Agent
从用户菜单打开「Agents」,或在设置中选择「Agents」,查看这台电脑上检测到的 Agent。页面提供全部、可用和不可用筛选,并显示安装、登录或版本状态。
- 找到需要使用的 Agent,点击「安装与接入」。
- 支持自动安装时,点击「安装并连接」;也可以按「安装指南」自行安装,或选择已安装的本机程序。
- 按提示完成 Agent 服务商的账号登录。需要终端登录时,Mira 会复制登录命令并打开终端,完成后切回 Mira。
- 点击「检查状态」,确认显示为可用。
Mira 管理的安装会从官方来源下载并校验指定版本,保存在专用目录中。页面也会区分「Mira 管理」「本机自动检测」和「手动选择」的程序来源,便于确认实际使用的是哪一份安装。
Agents 页面还可能展示 OpenCode、OpenClaw 等接入项,请按对应页面完成程序检测或连接;只有已完成接入且支持当前对话的 Agent 才会出现在会话选择器中。


配置模型、思考级别与运行权限
点击 Agent 旁的「编辑」,可以调整「新对话默认设置」和「运行权限」,完成后点击「保存并测试」。
设置 | 作用 |
|---|---|
模型 | 为新会话指定模型,也可以使用 Agent 默认设置;支持时可输入自定义模型名称。 |
思考级别 | 按 Agent 提供的选项调整推理强度。 |
运行权限 | 按 Agent 的原生模式决定执行和批准方式,适用于该 Agent 的后续运行,包括已有对话。 |
程序与登录 | 查看或选择可执行文件,检查安装与登录是否正常。 |
Codex 提供 Read Only、Auto 和 Full Access 等权限模式;Claude Code 提供 Plan、Default、Accept Edits 等模式,具体选项及说明请在下拉菜单中查看。需要使用更大权限时,先阅读确认页面中对文件、命令和网络访问的说明。
在新会话中切换 Agent
- 切换到已连接工作目录的本地项目,点击「新建会话」。
- 点击输入框左下角的「+」(添加和设置),打开「Agent」。

- 选择 Mira 或已接入的其他 Agent,检查当前模型与思考级别,再输入任务。
- 发送首条消息后,该会话使用的 Agent 固定。需要换一个 Agent 时,请新建会话。
模型与思考级别仍可在会话中调整,修改从下一条消息开始生效。为其他 Agent 设置的默认模型,也不会改变 Mira 自身的基座模型选择。

提供研究材料与查看产物
将需要处理的数据、代码和文档放入本地项目的工作目录,在任务中写明文件名、处理目标和保存位置;也可以通过当前支持的本机文件入口提供材料。
本地 Agent 对话目前不支持 Mira 知识库检索和 Wiki 引用。需要使用这些材料时,先将所需文件保存到本机,再在本地项目中提供。云端文件引用如果无法传入,也请从本机重新选择文件。
执行过程中,可以展开命令、工具调用或文件变更,查看输入、输出和执行状态。Agent 请求授权时,核对命令、路径和理由后选择「允许一次」「本次会话允许」或「拒绝」等当前提供的选项。
产物尽量保存到项目工作目录,便于在 Mira 中预览和后续处理。直接写到桌面或其他项目外位置的文件,需到对应位置查看。