claude-ide.nvim

Русский | English

Neovim-плагин, превращающий редактор в IDE, тесно интегрированную с Claude Code, работающим в отдельном терминале.

• Справа — дерево файлов, слева — код. Навигация мышью и клавиатурой.
• После каждой операции Claude с файлами изменённые файлы автоматически помечаются в дереве (A/M/D, ● на папках) и подсвечиваются в коде.
• Старый (заменённый/удалённый) код показывается прямо в буфере приглушённым красным над новым.
• Состояния проекта снимаются автоматически: один ход Claude = одна «страница». Страницы листаются как книга ([p / ]p), старые — только для чтения.
• Обычное редактирование, выделение и копирование в системный буфер работают как всегда.

Требования

• Neovim ≥ 0.10
• git
• jq или python3 (для hook-скрипта)
• Claude Code ≥ 2.x

Если системный Neovim старее 0.10, скрипт bin/install-nvim.sh поставит официальную сборку 0.10.4 в ~/.local/opt, не трогая системную (требуется glibc ≥ 2.31):

sh bin/install-nvim.sh
# и в ~/.bashrc:
alias nv="$HOME/.local/opt/nvim-linux-x86_64/bin/nvim"

Установка

vim-plug:

Plug 'HelpFreedom/claude-ide.nvim'

" после plug#end():
if has('nvim-0.10')
  lua require('claude-ide').setup()
endif

lazy.nvim:

{ 'HelpFreedom/claude-ide.nvim', config = true }

Или вручную: склонируйте репозиторий и добавьте его путь в runtimepath.

Быстрый старт

1. Откройте Neovim в корне вашего проекта и выполните :ClaudeIDEInit — создастся теневой git-репозиторий .claude-ide/ и hooks в .claude/settings.local.json.
2. Перезапустите claude в этом проекте (hooks считываются при старте сессии).
3. Работайте: :ClaudeIDE открывает дерево; правки Claude появляются сами.

Команды и клавиши

В дереве: Enter/o — открыть/развернуть, l/h — глубже/выше, Tab — предпросмотр, R — обновить, . — скрытые файлы, ]c/[c — к следующему изменению, клик мышью — развернуть папку, двойной клик — открыть файл.

Настройка

require('claude-ide').setup({
  tree = {
    width = 34,
    show_hidden = false,
    hide = { '%.git$', '%.claude%-ide$' }, -- lua-паттерны скрываемых записей
  },
  poll_ms = 200,                 -- интервал опроса событий, мс
  auto_open = false,             -- открывать дерево при старте в инициализированном проекте
  settings_file = 'settings.local.json', -- или 'settings.json' (общий для команды)
  keys = {                       -- '' = не назначать клавишу
    toggle = '<leader>e',
    prev_page = '[p',
    next_page = ']p',
    latest = '<leader>gl',
    pages = '<leader>gp',
    diff_toggle = '<leader>gd',
    clear = '<leader>gc',
  },
})

Цвета — highlight-группы ClaudeIDEOldCode, ClaudeIDEAdded, ClaudeIDEChanged, ClaudeIDETree* (переопределяются в вашей colorscheme).

Как это устроено

claude (другой терминал)
  └─ hooks → bin/claude-ide-hook.sh → .claude-ide/events.jsonl
nvim ── таймер читает события:
  file_op    → бейджи в дереве + подсветка диффа в буфере
  turn_start → правки пользователя коммитятся страницей [user]
  turn_end   → коммит страницы [claude] в теневой git (.claude-ide/repo)

• Теневой репозиторий не пересекается с собственным .git проекта и соблюдает его .gitignore.
• Правки Claude через Bash (rm, sed, …) не проходят через матчер hooks, но подхватываются сверкой теневого репозитория в конце хода.
• При нескольких открытых nvim коммиты делает только один (pid-lock .claude-ide/owner.lock), остальные читают.

Тесты

sh tests/run.sh            # использует nvim из PATH
NVIM=~/.local/opt/nvim-linux-x86_64/bin/nvim sh tests/run.sh

Ограничения

• Hooks вступают в силу только после перезапуска claude в проекте.
• Правки пользователя, сделанные во время хода Claude, попадают в страницу [claude].
• Если буфер изменён и в nvim, и на диске одновременно — nvim покажет стандартный запрос; плагин не перезагружает изменённые буферы силой.

Авторы

• Black Triangle — автор и владелец проекта
• Claude (Anthropic) — реализация

Лицензия

GNU GPL v3