Claude Code Neovim Plugin integrates Claude Code AI into Neovim, offering terminal-based Claude Code access, configurable window and refresh settings, and git-aware working directory handling. It provides commands and keymaps to toggle and manage Claude Code, with 44 tests and development tooling.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
A Neovim plugin that integrates Claude Code AI into the editor, launching Claude Code in a terminal buffer and providing commands to toggle and manage the Claude Code session. The project has 2091 stars, 69 forks, and 71 open issues, and is written in Lua under the MIT license. Created 2025-02-24; last push 2026-02-04.
How it works
The plugin creates a terminal buffer running the Claude Code CLI, detects file changes on disk, reloads files modified by Claude Code, and provides keymaps and commands to toggle the terminal. It can detect a Git project and set the working directory to the Git root. It offers configuration for terminal window settings (split_ratio, position, enter_insert, hide_numbers, hide_signcolumn, and a floating window schema), file refresh options (enable, updatetime, timer_interval, show_notifications), Git root usage, shell command customization (separator, pushd_cmd, popd_cmd), and Claude Code command variants (continue, resume, verbose). It exposes a default configuration through require("claude-code").setup(...) and supports various installation managers.
Getting started
Install instructions are provided for lazy.nvim, packer.nvim, and vim-plug, each showing how to require and configure the plugin. Example snippets are included:
- lazy.nvim: require("claude-code").setup()
- packer.nvim: require('claude-code').setup()
- vim-plug: lua require('claude-code').setup()
Recent releases
Latest releases include v0.4.3 (2025-03-21) with changes like linting/pre-commit configuration, updated documentation, and deprecated --cwd replacement; v0.4.2 (2025-03-04) fixed test runner exit, improved which-key handling, and window focus in terminal split; v0.4.1 (2025-03-03) changed GitHub workflows, release workflow, and dependency handling.
Traction
Stars: 2091. Forks: 69. Open issues: 71. Created: 2025-02-24. Last push: 2026-02-04.
Behind the repo
Not provided in the README. No startup/company-linked details are included beyond acknowledgements to Claude Code and Plenary.nvim.
Caveats
License: MIT. Requirements include Neovim 0.7.0 or later, Claude Code CLI in PATH, and plenary.nvim. Development notes reference a development guide and testing framework (44 tests). Commands and configuration rely on user-provided Claude Code installation and environment specifics.