Claude Code.nvim

Claude Code Neovim Plugin

[](https://github.com/greggh/claude-code.nvim/blob/main/LICENSE) [](https://github.com/greggh/claude-code.nvim/stargazers) [](https://github.com/greggh/claude-code.nvim/issues) [](https://github.com/greggh/claude-code.nvim/actions/workflows/ci.yml) [](https://github.com/neovim/neovim) [](https://github.com/greggh/claude-code.nvim/actions/workflows/ci.yml) [](https://github.com/greggh/claude-code.nvim/releases/tag/v0.4.2) [](https://github.com/greggh/claude-code.nvim/discussions)

*A seamless integration between [Claude Code](https://github.com/anthropics/claude-code) AI assistant and Neovim*

[Features](#features) • [Requirements](#requirements) • [Installation](#installation) • [Configuration](#configuration) • [Usage](#usage) • [Contributing](#contributing) • [Discussions](https://github.com/greggh/claude-code.nvim/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)

...