claudecode.nvim — плагин
Плагин Neovim подключает Claude Code к редактору: текущий файл, выделение, диагностика и просмотр правок в diff
- 3 152 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Плагин открывает локальный WebSocket-сервер, через который Claude Code читает файлы и выделение из Neovim
- Агент может открывать файлы в редакторе и предлагать правки, принимаете их вы
Установка
- Работает в
Ручная установка
Добавь в конфигурацию lazy.nvim спецификацию `coder/claudecode.nvim` с зависимостью `folke/snacks.nvim` и `config = true`, перечисли в `cmd` команды `ClaudeCode`, `ClaudeCodeFocus`, `ClaudeCodeSend` и `ClaudeCodeAdd`. Убедись, что `claude` доступен в PATH Neovim, иначе задай `terminal_cmd`. Затем выполни `:ClaudeCode`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Плагин открывает локальный WebSocket-сервер, через который Claude Code читает файлы и выделение из Neovim
- Агент может открывать файлы в редакторе и предлагать правки, принимаете их вы
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
claudecode.nvim — плагин для Neovim на чистом Lua, который связывает редактор с Claude Code по тому же WebSocket-протоколу MCP, что и официальные расширения для VS Code и JetBrains. Команда `:ClaudeCode` открывает Claude Code в терминале внутри Neovim. Агент видит текущий файл и выделение, получает диагностику и сведения о рабочем пространстве и сам открывает файлы в редакторе. Когда Claude Code предлагает правку, плагин показывает ее в обычном diff Neovim. Принять правку можно сохранением файла (`:w`) или клавишами `<leader>aa`, отклонить через `:q` или `<leader>ad`. Перед принятием предложение можно поправить руками. Выделенный фрагмент уходит агенту командой `:ClaudeCodeSend`, файл добавляется в контекст командой `:ClaudeCodeAdd`, а в деревьях файлов (nvim-tree, neo-tree, oil.nvim, mini.nvim) файл добавляет та же клавиша `<leader>as`.
Для кого. Для разработчиков, которые работают в Neovim и хотят вести Claude Code рядом с кодом, не переключаясь в VS Code или JetBrains.
Подходит, если
- Вы пишете код в Neovim и хотите, чтобы Claude Code видел открытый файл и выделенные строки без копирования в терминал
- Правки агента нужно просматривать в привычном diff Neovim и принимать сохранением файла
- Claude Code запущен в отдельном терминале или tmux, а Neovim должен подключаться к нему как IDE (режим провайдера `none` или `external`)
- Нужно отправить агенту файл из nvim-tree, neo-tree или oil.nvim одной клавишей
Не подходит, если
- Вы работаете в VS Code или JetBrains: для них у Claude Code есть собственные расширения
- Нужен другой агент, например Codex или Gemini CLI: плагин говорит на протоколе Claude Code
- Версия Neovim старше 0.8: ниже этого порога плагин не заявлен
- Нужен чат с несколькими провайдерами моделей внутри Neovim, для этого лучше подходит codecompanion.nvim
Пример запроса к агенту
Посмотри диагностику в открытом файле и предложи правку, я проверю ее в diffОграничения
Плагин в статусе бета. Он требует Neovim 0.8 или новее, установленный Claude Code CLI и folke/snacks.nvim для работы с терминалом. API Anthropic из России недоступен, а без него Claude Code не работает. Если Claude Code переехал в локальную установку (`claude migrate-installer`), путь к бинарнику задают в настройке `terminal_cmd`. Плагин обновляется как обычный плагин lazy.nvim, а список изменений ведется в `CHANGELOG.md`.
Как отключить. Уберите спецификацию плагина из конфигурации lazy.nvim и перезапустите Neovim. Команда `:ClaudeCodeStop` останавливает сервер интеграции без удаления плагина.
Частые вопросы
Как подключить Claude Code к Neovim?
Добавьте плагин `coder/claudecode.nvim` в lazy.nvim вместе с зависимостью `folke/snacks.nvim` и выполните `:ClaudeCode`. Плагин сам запускает WebSocket-сервер и настраивает подключение.
Как принять или отклонить правку Claude Code в Neovim?
Сохраните файл через `:w` или нажмите `<leader>aa`, чтобы принять правку. Закройте окно через `:q` или нажмите `<leader>ad`, чтобы отклонить. Предложенный текст можно изменить до принятия.
Что делать, если Claude Code установлен локально через migrate-installer?
Укажите путь к бинарнику в настройке `terminal_cmd`, например `~/.claude/local/claude`. Псевдоним оболочки Neovim не видит, поэтому без пути команда `claude` не найдется.
Чем плагин отличается от запуска claude в терминале Neovim?
Плагин добавляет двустороннюю связь: агент получает выделение, текущий файл и диагностику, а правки открываются в diff редактора. Простой терминал таких данных агенту не передает.
Как остановить интеграцию, не удаляя плагин?
Выполните `:ClaudeCodeStop`: команда останавливает сервер интеграции.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Плагиныcode-preview.nvim — просмотр правок агента в Neovim
code-preview.nvim
Плагин Neovim: правки Claude Code, OpenCode, Copilot CLI и Codex CLI открываются обычным диффом до записи на диск
CodeCompanion.nvim
codecompanion.nvim
AI-ассистент для Neovim с чатом по LLM и запуском Claude Code, Codex, Gemini CLI прямо в редакторе через ACP и MCP
Плагин с деревом файлов для Claude Code: подсвечивает файлы, которые агент читает и правит, показывает git, дифф и предпросмотр
Плагин для IDE JetBrains: графический чат Claude Code с карточками инструментов, вкладками сессий и запуском из браузера
Маркетплейс плагинов Claude Code от Frad LEE: Git и GitFlow, GitHub, рефакторинг, память, исследования, изображения и работа с интерфейсами
Инструмент отладки для Claude Code: читает уже сохраненные логи сессий и показывает точные пути файлов, диффы, мышление модели и разбивку контекста по категория
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| claudecode.nvim (эта карточка) | нет | 3 152 | |
| CodeCompanion.nvim | нет | 6 924 | чат с разными моделями внутри Neovim, Claude Code запускается как один из провайдеров |
| MCP Hub | нет | 1 789 | управляет MCP-серверами для чат-плагинов Neovim |
Коротко о README
Протокол интеграции описан отдельно, в файле `PROTOCOL.md`. Установка идет через lazy.nvim, дальше работают команды `:ClaudeCode*` и привязки клавиш на `<leader>a`. Отдельные разделы посвящены локальной установке Claude Code, событиям `User` для автокоманд и поиску неполадок.