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

return {
  "greggh/claude-code.nvim",
  dependencies = {
    "nvim-lua/plenary.nvim", -- Required for git operations
  },
  config = function()
    require("claude-code").setup()
  end
}

Using packer.nvim

use {
  'greggh/claude-code.nvim',
  requires = {
    'nvim-lua/plenary.nvim', -- Required for git operations
  },
  config = function()
    require('claude-code').setup()
  end
}

Using vim-plug

Plug 'nvim-lua/plenary.nvim'
Plug 'greggh/claude-code.nvim'
" After installing, add this to your init.vim:
" lua require('claude-code').setup()

Configuration

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