This plugin provides Neovim integration for Anthropic's Claude Code AI assistant, enabling users to leverage its coding assistance features directly within their editor. It targets Neovim users who want parity with VS Code and JetBrains IDEs, offering a pure Lua implementation of the WebSocket-based MCP protocol.

How It Works

The plugin establishes a WebSocket server that the Claude Code CLI connects to, mirroring the protocol used by official extensions. This allows Claude Code to access Neovim's context, including current files, selections, diagnostics, and workspace information in real-time. It utilizes vim.loop for its WebSocket implementation and manages connections via lock files, providing a seamless integration.

Quick Start & Requirements

• Installation: Add coder/claudecode.nvim and folke/snacks.nvim to your Neovim package manager.
• Prerequisites: Neovim >= 0.8.0, Claude Code CLI installed.
• Configuration: For local or native binary installations of Claude Code, specify the terminal_cmd in the plugin's opts.
• Docs: PROTOCOL.md, ARCHITECTURE.md

Highlighted Details

• Pure Lua implementation with zero external dependencies.
• 100% compatible with the official Claude Code WebSocket MCP protocol.
• Supports real-time context updates, native diff views, and integration with file tree plugins.
• Offers extensive configuration options for terminal behavior, floating windows via snacks.nvim, and custom terminal providers.

Maintenance & Community

The project is actively maintained. Community extensions like claude-fzf.nvim and claude-fzf-history.nvim are available. Troubleshooting guidance and contribution guidelines are provided.

Licensing & Compatibility

MIT License. Compatible with commercial and closed-source projects.

Limitations & Caveats

Auto-save plugins may interfere with diff window handling; specific configurations are provided to mitigate this. The native binary installation method is currently in alpha.