К основному содержанию
плагин

gemini · arescope — плагин для Claude Code: что делает и как установить

Подключает Gemini CLI к Claude Code для рецензирования правок, архитектурного разбора на контексте в 1M токенов и фоновых задач.

Apache-2.0 ★ 6 обновлён 2026-04-05

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add anthropics/claude-plugins-community
/plugin install gemini@claude-community
Открыть на GitHub

Что делает gemini

Плагин вызывает Gemini CLI прямо из сессии Claude Code. Он отдаёт Gemini анализ репозитория благодаря контекстному окну в 1M токенов или запрашивает второе мнение по коду. Архитектура построена на скрипте scripts/gemini-companion.mjs без сторонних зависимостей npm: используются только встроенные модули Node.js.

Команды вроде /gemini:review и /gemini:analyze умеют выполняться в фоне с флагом --background, а состояние задач пишется в .gemini-tasks/state.json. В плагин встроен хук Stop для автоматической проверки кода перед завершением хода Claude. Этот шлюз способен зациклить вызовы моделей и быстро исчерпать лимиты токенов, поэтому без контроля его держать опасно.

Для работы требуются Node.js 18.0+, Git 2.0+ и глобальный пакет @google/gemini-cli версии от 0.36.0. Также понадобится авторизоваться через OAuth либо указать ключ API от AI Studio. Проверить готовность связки можно командой /gemini:setup.

Какие задачи решает

  • проанализировать архитектуру всей кодовой базы в окне 1M токенов
  • провести ревью диффа относительно базовой ветки
  • оспорить проектные решения по обработке ошибок
  • делегировать фоновый поиск причин сбоя в тестах

Примеры запросов агенту

  • /gemini:review --base main
  • /gemini:analyze Map the system architecture, key abstractions, and data flow
  • /gemini:consult --background investigate the flaky integration test

Как установить gemini

Через маркетплейс плагинов

/plugin marketplace add anthropics/claude-plugins-community
/plugin install gemini@claude-community

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о gemini

Как установить gemini в Claude Code?

Сначала добавьте каталог командой /plugin marketplace add anthropics/claude-plugins-community. После этого установите плагин: /plugin install gemini@claude-community.

Что делает плагин gemini?

Он передаёт анализ репозитория и рецензирование кода в Gemini CLI, используя контекст до 1M токенов. Для фоновой помощи плагин подключает субагент gemini-consult.

Что нужно настроить перед запуском?

Установите Node.js 18.0+, Git 2.0+ и пакет @google/gemini-cli версии не ниже 0.36.0. Затем авторизуйтесь через gemini auth или передайте API-ключ от AI Studio.

Исходный текст

SKILL.md · Apache-2.0
# Gemini plugin for Claude Code

Use Gemini CLI from inside Claude Code for code reviews, whole-codebase analysis, or to delegate tasks.

This plugin is for Claude Code users who want to leverage Gemini's **1M token context window** alongside Claude Code's coding capabilities — giving you a "satellite view" of your codebase plus hands-on implementation power.

## Install

### From the personal plugin marketplace

> **Note:** This plugin is pending approval for the official Claude Code marketplace. Until then, install from the personal marketplace below.

**Step 1** — Add the marketplace registry:
```
/plugins marketplace add arescope/claude-plugins
```

**Step 2** — Install the Gemini plugin from the registry.

### From GitHub URL (direct)
```
/install-plugin https://github.com/arescope/gemini-plugin-cc
```

### From source (local development)
```bash
git clone https://github.com/arescope/gemini-plugin-cc.git
cd your-project
claude --plugin-dir /path/to/gemini-plugin-cc
```

### Prerequisites

1. Install Gemini CLI: `npm install -g @google/gemini-cli`
2. Authenticate: API key from [AI Studio](https://aistudio.google.com/apikey) or `gemini auth` for OAuth

Then verify:
```
/gemini:setup
```

## What You Get

- `/gemini:review` — code review with full codebase context
- `/gemini:challenge` — challenge review that questions design decisions
- `/gemini:analyze` — whole-codebase analysis (architecture, patterns, security, dependencies)
- `/gemini:consult` — consult Gemini on a task or delegate work
- `/gemini:setup` — check installation, auth, and manage the review gate
- `/gemini:status`, `/gemini:result`, `/gemini:cancel` — manage background jobs
- `gemini-consult` subagent — fires proactively for second opinions or delegation

## Architecture

All commands route through a single Node.js companion entry point (`scripts/gemini-companion.mjs`). Zero external dependencies — Node.js builtins only.

```
/gemini:review --background --base main
  → companion.mjs review --background --base main
    → resolves review target via git.mjs
    → loads prompt template via prompts.mjs
    → spawns detached task-worker
      → runs gemini CLI with structured output
      → parses JSON against schema
      → writes result to .gemini-tasks/state.json
```

### Module library (`scripts/lib/`)

| Module | Purpose |
|--------|---------|
| `args.mjs` | Parse slash-command arguments |
| `fs.mjs` | Filesystem helpers (stdin, JSON) |
| `gemini.mjs` | Gemini CLI wrapper — alias resolution, effort mapping, output parsing |
| `git.mjs` | Git helpers — repo check, review target, context collection |
| `job-control.mjs` | Job lifecycle — sort, resolve, snapshot |
| `process.mjs` | Process management — binary check, tree kill |
| `prompts.mjs` | Template loader with `{{VAR}}` interpolation |
| `render.mjs` | Output formatting — review results, status tables, setup reports |
| `state.mjs` | Centralized JSON state per workspace |
| `tracked-jobs.mjs` | Job execution with progress tracking and log files |
| `workspace.mjs` | Resolve workspace root from cwd |
| `types.d.ts` | TypeScript type definitions for all interfaces |

### Session lifecycle

Three hooks via `hooks/hooks.json`:
- **SessionStart** — propagates session ID to state
- **SessionEnd** — kills running jobs, cleans up session state
- **Stop** — smart review gate (skips turns that didn't make code edits)

## Requirements

| Requirement | Minimum | Recommended |
|-------------|---------|-------------|
| **Node.js** | 18.0+ | 22 LTS |
| **Claude Code** | Latest | Latest |
| **Gemini CLI** | 0.36.0+ | Latest |
| **Git** | 2.0+ | Latest |
| **OS** | Windows, macOS, Linux | — |

## Usage

### Review Before Shipping
```
/gemini:review --base main
```

### Challenge Your Design
```
/gemini:challenge --base main question the retry and error handling strategy
```

### Understand the Architecture
```
/gemini:analyze Map the system architecture, key abstractions, and data flow
```

### Delegate a Task
```
/gemini:consult investigate why the build is failing in CI
```

### Background Tasks
```
/gemini:consult --background investigate the flaky integration test
/gemini:status
/gemini:result
```

### Natural Language Delegation
Just ask Claude:
```
Ask Gemini to review these changes as an external peer
Have Gemini analyze the authentication flow across the entire codebase
```

## Review Gate (Stop Hook)

The review gate auto-reviews Claude's code changes before each stop — powered by Gemini. It skips turns that didn't make code edits.

```
/gemini:setup --enable-review-gate    # Enable
/gemini:setup --disable-review-gate   # Disable
```

Configuration is stored in `.gemini-tasks/state.json` via the companion runtime.

**Warning**: This can create a Claude/Gemini loop and may drain usage limits. Only enable when actively monitoring.

## Model Aliases

All commands accept short model names via `--model`:

| Alias | Model | Use case |
|-------|-------|----------|
| `flash`, `fast` | gemini-3-flash-preview | Fastest (default) |
| `pro`, `deep` | gemini-3.1-pro-preview | Most capable |
| `lite` | gemini-2.5-flash-lite | Cheapest |
| `flash-2` | gemini-2.5-flash | Previous gen fast |
| `pro-2` | gemini-2.5-pro | Previous gen capable |

```
/gemini:review --model pro
/gemini:consult --model flash --effort low quick check
```

## Effort Levels

Effort levels via `--effort` (reserved for future Gemini CLI support):

| Level | Budget |
|-------|--------|
| `low`, `l` | Light reasoning |
| `medium`, `med`, `m` | Standard |
| `high`, `h` | Deep reasoning |
| `xhigh`, `max` | Maximum |
| `none`, `off` | No thinking |
| `<number>` | Exact token count |

```
/gemini:analyze --effort high     # Deep reasoning
/gemini:consult --effort low       # Quick pass
```

## Internal Skills

Three internal skills guide agent behavior (not user-invocable):

| Skill | Purpose |
|-------|---------|
| `gemini-cli-runtime` | Contract for calling the companion from agents |
| `gemini-result-handling` | Rules for presenting Gemini output |
| `gemini-prompting` | Guidance for composing XML-tagged prompts |

Plus `guide` — a quick reference for all commands and options.

## Testing

```bash
# Node.js unit + integration tests (76 tests)
node --test tests/args.test.mjs tests/gemini.test.mjs tests/git.test.mjs \
  tests/process.test.mjs tests/render.test.mjs tests/state.test.mjs \
  tests/commands.test.mjs tests/runtime.test.mjs

# Structure validation (91 checks)
bash tests/test-plugin-structure.sh
```

## License

Apache-2.0

© arescope · Apache-2.0 · arescope/gemini-plugin-cc

Похожие плагины

Все плагины по теме «Код-ревью и рефакторинг» →

Сначала — gemini от других авторов.

gemini softaworks Передаёт задачи на ревью кода, проверку планов и разбор больших контекстов в Gemini CLI. Включается, когда нужно обработать массив данных свыше 200k токенов. ★ 2 707звёзд репо collaborating-with-gemini cnfjlhj Скилл collaborating-with-gemini подключает Gemini CLI в роли второго пилота для поиска багов, ревью патчей и прототипирования через мост на Python. CX Codex +1 ★ 475звёзд репо gemini-agents Paweł Huryn Скилл gemini-agents для Claude Code подключает Antigravity CLI как партнёра для сборки и ревью кода. Перед каждым запуском агент сообщает способ входа и позицию Google, затем получает согласие. CX Codex +1 ★ 741звёзд репо gemini-watermark-remover GargantuaX Скилл gemini-watermark-remover для Claude Code удаляет видимые водяные знаки Gemini с локальных картинок через встроенный CLI-скрипт. Чистит одиночные файлы или целые папки прямо в терминале. CX Codex +1 12 900установок gemini-review davila7 Команда gemini-review выгружает комментарии Gemini Code Assist из пулреквеста на GitHub, расставляет приоритеты и формирует список задач для Claude Code. CX Codex +1 217установок anycap-gemini-omni-video-edit anycap-ai Скилл anycap-gemini-omni-video-edit для правки коротких видео через Gemini Omni Flash Preview и AnyCap: меняет один элемент, остальное сохраняет. CX Codex +1 517установок phone-a-friend freibergergarcia Плагин phone-a-friend делегирует задачи другим нейросетям вроде Codex, Gemini или Ollama прямо из Claude Code. Помогает получить второе мнение или запустить совместное ревью кода. ★ 10звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой