claude-code.nvim
A Neovim plugin that seamlessly integrates the Claude Code AI assistant directly into the editor via a terminal window.
What is claude-code.nvim?
Claude Code Neovim Plugin is a Neovim plugin that integrates the Claude Code CLI tool directly into the editor. It creates a terminal window for the AI assistant, automatically reloads files modified by Claude Code, and manages project context to provide a seamless AI-assisted development workflow without leaving Neovim.
Neovim users (version 0.7.0 or later) who use the Claude Code CLI tool and want to interact with the AI assistant from within their editor environment.
Developers choose this plugin for its deep integration that treats Claude Code as a native part of Neovim, with features like single-toggle terminal access, automatic file synchronization, and git-aware context management that reduces friction compared to switching between separate terminal and editor windows.
Overview
Seamless integration between Claude Code AI assistant and Neovim
Use Cases
Best For
- Neovim developers who want to use Claude Code AI assistance without leaving their editor
- Setting up a toggleable terminal window for Claude Code with customizable layouts (split, tab, or floating)
- Automatically reloading files in Neovim after they are modified by the Claude Code CLI
- Managing AI-assisted coding sessions with conversation continuation (--continue flag) directly from Neovim
- Working within git repositories where the plugin automatically sets the working directory to the project root
- Configuring verbose logging and output options for Claude Code through dedicated Neovim commands or keymaps
Not Ideal For
- Developers using AI coding assistants other than Claude Code, such as GitHub Copilot or Cursor
- Teams working in non-Neovim environments or preferring graphical IDEs with built-in AI features
- Projects requiring AI assistance without terminal interaction, like those needing inline code completions or GUI-based tools
Pros & Cons
Pros
Allows opening or closing the Claude Code terminal with a single key press, minimizing context switching as highlighted in the key features.
Detects and reloads files modified by Claude Code in real-time, ensuring seamless updates without manual refresh, which is a core feature mentioned in the README.
Automatically sets the working directory to the git project root when available, improving AI relevance for project-specific tasks as described in the features.
Includes 44 tests covering core functionality, enhancing reliability and stability, which is emphasized in the README's testing badges and development section.
Cons
Only supports the Claude Code tool, lacking extensibility for other AI assistants, which limits flexibility and creates vendor lock-in.
Requires Neovim 0.7+, Claude Code CLI installation, and plenary.nvim, adding setup overhead compared to all-in-one IDE integrations.
Relies on a terminal window for interactions, which may not suit users preferring GUI-based or inline AI assistance, and requires re-entering insert mode after scrolling.
Frequently Asked Questions
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.