claude-code.nvim

Claude Code Neovim Plugin

*A seamless integration between Claude Code AI assistant and Neovim*

Features •
Requirements •
Installation •
Configuration •
Usage •
Contributing •
Discussions

This plugin was built entirely with Claude Code in a Neovim terminal, and then inside itself using Claude Code for everything!

Features

- 🚀 Toggle Claude Code in a terminal window with a single key press
- 🧠 Support for command-line arguments like --continue and custom variants
- 🔄 Automatically detect and reload files modified by Claude Code
- ⚡ Real-time buffer updates when files are changed externally
- 📱 Customizable window position and size (including floating windows)
- 🤖 Integration with which-key (if available)
- 📂 Automatically uses git project root as working directory (when available)
- 🧩 Modular and maintainable code structure
- 📋 Type annotations with LuaCATS for better IDE support
- ✅ Configuration validation to prevent errors
- 🧪 Testing framework for reliability (44 comprehensive tests)

Requirements

- Neovim 0.7.0 or later
- Claude Code CLI tool installed and available in your PATH
- plenary.nvim (dependency for git operations)

See CHANGELOG.md for version history and updates.

Installation

Using lazy.nvim

Using packer.nvim

Using vim-plug

Configuration

The plugin can be configured by passing a table to the setup function. Here's the default configuration:

Usage

Quick Start

Commands

Basic command:

- :ClaudeCode - Toggle the Claude Code terminal window

Conversation management commands:

- :ClaudeCodeContinue - Resume the most recent conversation
- :ClaudeCodeResume - Display an interactive conversation picker

Output options command:

- :ClaudeCodeVerbose - Enable verbose logging with full turn-by-turn output

Note: Commands are automatically…