Agent Calling (Gemini CLI 增强扩展)

在 Gemini CLI 中调用其他代理和语言模型。

English | 简体中文

• [x] Claude code
• [ ] Codex

核心架构原理

Agent Calling 通过以下三个核心机制将 Claude 融入 Gemini CLI 生态系统：

1. 路径劫持: 创建一个包含名为 claude（或 claude.cmd）的代理脚本的临时目录，并将该目录强行置于系统 PATH 环境变量的最前面。
2. 上下文注入: 在代理脚本中，将 Gemini CLI 的当前状态（如工作区路径）作为环境变量注入，使 Claude 能够感知 Gemini 的上下文。
3. 生命周期监听: 代理脚本在调用真正的 Claude CLI 前后发送通知，以便宿主（Gemini CLI）同步 UI 状态或执行后续逻辑。

安装说明

1. 先决条件

• 安装官方 Claude CLI: 确保系统中已安装并配置好 Anthropic 的 claude 命令行工具。
• Node.js 环境: 建议使用 Node.js 18+。

2. 方式一：Gemini CLI 直接安装

gemini extension install https://github.com/xuansheep/agent-calling
cd ~/.gemini/extensions/agent-calling
npm install
npm run build

3. 方式二：使用 npm

npm install -g agent-calling

增加 Gemini setting.json 配置

{
  "mcpServers": {
    "claude-mcp": {
      "command": "agent-calling",
      "args": []
    }
  }
}

使用方法

1. 通过命令行直接调用

安装完成后，Gemini CLI 将暴露一个名为 claude 的工具。你可以直接发送指令：

gemini claude "分析 src/index.ts 的架构并提出重构建议"

2. 高级参数透传

你可以通过 args 参数向原始 Claude CLI 传递额外的命令行选项：

gemini claude "扫描代码库" --args "--output-format json"

自动化执行 (GEMINI.md)

为了实现复杂任务的自动委派，本项目包含了一个 GEMINI.md 配置文件。当你在 Gemini CLI 中执行以下操作时，Agent 将根据指令集自动调用本扩展：

任务委派准则

• 系统架构分析: 如“分析项目整体架构”、“识别模块间依赖关系”。
• 长程计划制定: 如“生成详细的项目实现计划”、“制定重构路线图”。
• 深度代码审查: 如“扫描代码库中的潜在安全漏洞”。
• 复杂重构建议: 涉及项目逻辑解耦或模式重构。

自动化执行协议

1. 上下文注入: Agent 自动将当前处理的文件列表或相关文档注入到 prompt。
2. 结构化输出: 默认要求 Claude 返回 JSON 格式（如使用 --output-format json），以便后续自动化处理。