代理面板中的 Gemini CLI
你的 Google 登录通过 Gemini CLI 驱动 termide 的代理,周围是 termide 的权限卡片、审查模型和编辑器
Gemini CLI 使用你的 Google 账号或 Gemini API 密钥运行。你可以在 termide 的某个终端面板里运行 gemini,但它只是待在 termide 旁边,而不是融入其中:它的修改绕过打开的编辑器直接写入磁盘,确认提示是它自己的,会话也不属于 termide。
termide 的代理面板可以改为在 Gemini CLI 上运行。模型、额度以及 Gemini CLI 自己的工作方式仍归 Google;权限卡片、会话列表以及跟随每次修改的编辑器则归 termide。本指南介绍如何配置,以及与在终端中使用 Gemini CLI 相比有哪些不同。
准备工作
- Node.js,并且
npx在PATH中。Gemini CLI 自己就支持 Agent Client Protocol,无需适配器:termide 通过npx以--acp运行@google/gemini-cli的最新版本。npm 缓存中的副本启动时不访问注册表;termide 每次运行时在后台检查一次新版本,新版本从下一个面板起生效。 - 已登录 Gemini CLI。 termide 本身不执行登录。如果你已经在用 Gemini CLI,就无需再做什么;否则单独运行一次
npx @google/gemini-cli,选择登录方式:Google 账号、Gemini API 密钥(GEMINI_API_KEY)或 Vertex AI。
添加连接
按 Alt+P 打开设置,进入 AI。最上面是 连接。选择 + 添加连接,在新连接的页面上把 提供方 设为 Gemini CLI。页面会去掉 Gemini CLI 用不到的字段——基础 URL、API 密钥、后备上下文窗口——在你命名之前,连接名为 gemini-cli。

页面上的其余项:
- 模型:termide 会短暂启动 Gemini CLI,列出它提供的模型;加载期间字段中显示旋转指示。Gemini 自己的 Auto 为每个请求挑选模型;自动(由提供方决定) 把选择留给 Gemini CLI 的设置。这里选的只是预选模型:在面板中随时可以切换。
- 默认使用:勾选后,新的代理面板都会在 Gemini CLI 上启动。
这里没有 上下文窗口上限:Gemini CLI 没有对应的设置,它按自己的规则压缩对话。
在 config.toml 中写法相同:
[ai]
connection = "gemini" # 新会话使用的连接
[ai.connections.gemini]
provider = "gemini_cli" # 其他都不是必需的
# model = "" # 留空:使用 Gemini CLI 自己的默认模型
第一个请求
按 Alt+A 打开代理面板。横幅显示连接和模型;Gemini CLI 在后台启动期间,状态栏的 模型 标签会旋转,此时发送的请求会等待它就绪。之后面板的工作方式与其他连接相同:回答、推理和 Gemini 的步骤以块的形式出现——读取、带文件名的修改、带命令行的命令——打开了该文件的编辑器会跟随每次修改,运行计时一直走到 Gemini CLI 完成为止。
模型 标签可以随时列出并切换 Gemini CLI 的模型,运行期间也可以。Gemini CLI 自己的 / 命令会加入面板的 / 列表,按原样发送给它。在它工作时输入的消息会在状态条中等待,作为下一个请求发送:Gemini CLI 不接受回合中途的消息。
Gemini 的工具,termide 的决定
与 Codex 一样,Gemini CLI 保留 自己的系统提示词和自己的工具:它像在终端中一样读取、修改和运行命令,它自己的配置——~/.gemini/settings.json、它的 MCP 服务器和扩展、它的 GEMINI.md 上下文文件——依然有效。termide 增加的是:
- 权限模式。 termide 让 Gemini CLI 进入与面板模式对应的确认模式,并由 termide 决定 Gemini 请求确认的操作。
- termide 的 MCP 服务器。 它们的工具与 Gemini CLI 自己的工具一起提供给它,并像 Gemini 自己的调用一样接受检查。Gemini CLI 只在会话启动时读取一次工具列表,因此之后才连上的服务器要到下一个会话才可用。
- Gemini CLI 没有对应物的工具:用于搜索以往会话和 git 历史的
recall、在描述中列出你的技能的skill,以及question和suggest_command。
Gemini CLI 读取 GEMINI.md,而不是 AGENTS.md。如果你的项目把说明放在 AGENTS.md 中(termide 的其他连接都这样期望),可以在 ~/.gemini/settings.json 中让 Gemini CLI 一并读取:
{ "context": { "fileName": ["AGENTS.md", "GEMINI.md"] } }
对话循环仍由 Gemini CLI 负责:它自己压缩上下文,运行也无法在步骤之间暂停。
权限与 auto 模式
权限 标签(或 Shift+Tab)设置模式,termide 把它映射到 Gemini CLI 的确认模式上:
| termide | Gemini CLI |
|---|---|
ask、configured、auto |
default:修改和命令前都询问 |
plan |
若 Gemini 的设置中开启了计划模式,则为 plan;否则为 default,修改由 termide 拒绝 |
edit |
autoEdit:修改直接通过,命令需询问 |
all |
yolo:什么都不问 |
Gemini CLI 请求确认的一切都要经过 termide 的检查:你的规则、你在本会话中给出的答复,以及模式。它们未能决定的操作会以卡片形式出现在输入框上方:允许一次、本会话允许、在本项目中始终允许或处处允许、拒绝、拒绝并告诉代理原因,或停止运行。

auto 适用于你信任其方向、但不想一张张回答卡片的运行。本该弹出卡片的操作会交给审查模型——一次独立的模型调用,判断这一步是否服务于你的请求。在 Gemini CLI 连接上,审查 通过你的登录、在会话所用的模型上运行,无需 API 密钥:termide 保持 Gemini CLI 运行,每次审查都在一个简短的独立会话中进行,不带工具,也不带代理的对话,因此代理永远不会评判自己。Gemini CLI 在那里也保留自己的系统提示词,因此审查比在模型连接上慢,并且计入你的额度。通常选一个小模型;在连接页面的 auto 模式审查模型 或 [ai.auto_reviewer] 中指定:
[ai.auto_reviewer]
connection = "gemini" # 留空:会话自己的连接
model = "flash-lite" # 该连接的某个模型,按 id、名称或其中一部分匹配
额度用完时
Gemini CLI 遇到额度错误时会先自己重试。放弃之后,它的 ACP 模式只报告 “Rate limit exceeded. Try again later.”——不带 API 给出的重置时间——因此卡片无法倒数:
- 立即重试,
- 持续重试直到成功,每次尝试之间等待更久,
- 停止(Esc)。

对于无人值守的 /goal 或 /loop,把 遇到限额或中断时([ai] 下的 on_limit)设为 wait,运行会自行重试;ask_else_wait 会显示卡片,无人回应时则持续重试。这期间关闭 termide 也不会丢失任何东西:重新打开的会话会把卡片带回来。
如果不想等,可以准备第二个连接。卡片显示期间,状态栏的 连接 标签仍可点击:把会话切换过去,然后回答 立即重试。对话会一并带过去,另一个模型从 Gemini 停下的地方接着做。按密钥计费的 Gemini API 本身就可以作为这样的连接:
[ai.connections.gemini]
provider = "gemini_cli"
[ai.connections.gemini-api]
provider = "openai_compatible"
base_url = "https://generativelanguage.googleapis.com/v1beta/openai"
model = "gemini-3.5-flash"
api_key_env = "GEMINI_API_KEY"
委派任务
Gemini CLI 不运行 termide 的委派任务:它有自己的分工方式,其页面上的 子代理 显示 (无)。委派任务也不能在 Gemini CLI 上运行:这需要模型连接或 Claude Code。
会话与开销
会话日志记录 Gemini CLI 自己的会话,因此重新打开的面板会继续该会话,Gemini 了解完整的对话。从其他连接切换到 Gemini CLI 的会话,会先收到此前对话的记录。Gemini CLI 不能分叉会话,因此 /goal 的判定请求和 /handoff 的简报请求会作为一个回合发给它,面板及其日志不显示这个回合,但 Gemini 自己的会话会保留它。
会话信息(F3 或 /usage)按花费者——对话、auto 审查等——和按模型细分 token 用量。Gemini 单独统计推理,因此 推理 一行会显示输出中有多少用于思考。
须知
- termide 不提供沙箱。 termide 的权限是一种控制手段,而不是隔离:你允许的操作以你的权限运行,范围以 Gemini CLI 自己的沙箱为限(如果你开启了它)。
- Claude Code 和 Codex 的接入方式相同:
provider = "claude_code"或"codex"。参见 代理面板中的 Claude Code 和 代理面板中的 Codex。 - 任何 OpenAI 或 Anthropic 兼容的 API 都可以作为备用连接,额度用完时把会话切换过去:OpenAI、OpenRouter 或 Anthropic 这样的托管 API,或你自己的服务器,使用 termide 自己的代理。llama.cpp 和 omlx 是后者的两个例子。
- 详细说明 见 代理指南。