[FEATURE] Add lazy.nvim install instructions

[gonzaloserrano]

Feature Description

How to install and set mappings with https://github.com/folke/lazy.nvim

[ThomasK33]

https://chatgpt.com/share/e/68ef61a1-8eb4-800e-91db-27b1bbad88b0

[gonzaloserrano]

@ThomasK33

Conversation inaccessible or not found. You may need to switch accounts or request access if this conversation exists.

[ThomasK33]

Ah, org sharing settings strike again. Here's a copy & pasted version of it

---

Understood! I will research how to install and configure mappings for the claudecode.nvim extension using lazy.nvim. I'll gather detailed instructions from reliable sources and share the installation steps and mapping configurations with you soon.

Here’s how to install the claudecode.nvim extension using lazy.nvim and set up the key‑mappings.

1. Check the prerequisites

• Neovim ≥ 0.8.0 – the plugin requires a fairly recent Neovim.
• Claude Code CLI – the plugin is just a front‑end; you must install the Claude Code CLI (see the install.sh script at claude.ai or the claude package on npm).
• folke/snacks.nvim – Claude Code uses Snacks’ terminal API for window management.

2. Install lazy.nvim (if you haven’t)

Lazy.nvim is a modern plugin manager for Neovim. A typical bootstrap in ~/.config/nvim/lua/config/lazy.lua clones the lazy.nvim repo, prepends it to runtimepath, and sets your <leader> keys before loading plugins.

Once lazy.nvim is bootstrapped, you create plugin specs in ~/.config/nvim/lua/plugins/ and list your plugins there.

3. Add claudecode.nvim to lazy.nvim

Create a new Lua file under ~/.config/nvim/lua/plugins/claudecode.lua (or add to your existing plugin spec) and return a table describing the plugin:

-- ~/.config/nvim/lua/plugins/claudecode.lua
return {
  {
    "coder/claudecode.nvim",         -- repo
    dependencies = { "folke/snacks.nvim" }, -- required terminal provider:contentReference[oaicite:5]{index=5}
    config = true,                   -- automatically calls require("claudecode").setup()
    keys = {
      { "<leader>a",  nil, desc = "AI/Claude Code" },                           -- top‑level prefix
      { "<leader>ac", "<cmd>ClaudeCode<cr>", desc = "Toggle Claude" },         -- open/close Claude:contentReference[oaicite:6]{index=6}
      { "<leader>af", "<cmd>ClaudeCodeFocus<cr>", desc = "Focus Claude" },     -- focus/toggle terminal:contentReference[oaicite:7]{index=7}
      { "<leader>ar", "<cmd>ClaudeCode --resume<cr>", desc = "Resume Claude" },-- resume previous session:contentReference[oaicite:8]{index=8}
      { "<leader>aC", "<cmd>ClaudeCode --continue<cr>", desc = "Continue Claude" },-- continue conversation:contentReference[oaicite:9]{index=9}
      { "<leader>am", "<cmd>ClaudeCodeSelectModel<cr>", desc = "Select model" },-- choose Claude model:contentReference[oaicite:10]{index=10}
      { "<leader>ab", "<cmd>ClaudeCodeAdd %<cr>", desc = "Add current buffer" },-- add current file:contentReference[oaicite:11]{index=11}
      -- Visual-mode send: use the mapping only in visual mode (mode = "v")
      { "<leader>as", "<cmd>ClaudeCodeSend<cr>", mode = "v", desc = "Send selection" },:contentReference[oaicite:12]{index=12}
      -- File-tree send: applies only in file manager buffers such as nvim‑tree or neo-tree:contentReference[oaicite:13]{index=13}
      {
        "<leader>as",
        "<cmd>ClaudeCodeTreeAdd<cr>",
        desc = "Add file",
        ft = { "NvimTree", "neo-tree", "oil", "minifiles", "netrw" },
      },
      -- Diff management: accept or deny changes:contentReference[oaicite:14]{index=14}
      { "<leader>aa", "<cmd>ClaudeCodeDiffAccept<cr>", desc = "Accept diff" },
      { "<leader>ad", "<cmd>ClaudeCodeDiffDeny<cr>", desc = "Deny diff" },
    },
  },
}

When you run :Lazy and then :Lazy sync, lazy.nvim will clone the repository and configure it.
The config = true flag automatically runs require("claudecode").setup() with default options. You can override defaults by adding an opts table (see below).

4. Optional: point to a local/natively installed CLI

If you used claude migrate-installer to move Claude from a global npm install to ~/.claude/local/, lazy.nvim needs to know where the CLI lives. You can set the terminal_cmd option to the path of the binary:

{
  "coder/claudecode.nvim",
  dependencies = { "folke/snacks.nvim" },
  opts = {
    terminal_cmd = "~/.claude/local/claude", -- use local install:contentReference[oaicite:16]{index=16}
  },
  config = true,
  keys = { -- your custom mappings …  },
}

For the experimental native binary, run which claude and set terminal_cmd to the absolute path. If you installed Claude globally via npm, you don’t need terminal_cmd.

5. Customizing window/layout and additional mappings (optional)

Claude Code uses Snacks.nvim to manage terminal windows. You can customise how Claude appears—e.g., open it as a floating window and define a key to hide it. Here is a minimal example that toggles Claude with Ctrl + , and opens it in a floating window:

local toggle_key = "<C-,>"
return {
  {
    "coder/claudecode.nvim",
    dependencies = { "folke/snacks.nvim" },
    keys = {
      { toggle_key, "<cmd>ClaudeCodeFocus<cr>", desc = "Claude Code", mode = { "n", "x" } },:contentReference[oaicite:19]{index=19}
    },
    opts = {
      terminal = {
        snacks_win_opts = {
          position = "float",
          width = 0.9,
          height = 0.9,
          keys = {
            claude_hide = {
              toggle_key,
              function(self) self:hide() end,
              mode = "t",
              desc = "Hide",
            },:contentReference[oaicite:20]{index=20}
          },
        },
      },
    },
  },
}

Snacks supports other options such as using Alt + comma, different window sizes, or multiple hide keys. See the plugin’s Floating Window section for more examples and additional options like position = "bottom" or provider = "external" for launching Claude in an external terminal.

6. Usage

After installation, the following commands and mappings are available:

Command/mapping	Purpose	Citation
:ClaudeCode or <leader>ac	toggle Claude Code terminal	plugin spec
:ClaudeCodeFocus or <leader>af	focus/open Claude Code window	plugin spec
:ClaudeCodeSend or <leader>as (visual mode)	send selected text to Claude	plugin spec
:ClaudeCodeAdd % or <leader>ab	add current buffer to context	plugin spec
:ClaudeCodeSelectModel or <leader>am	choose which Claude model to use	plugin spec
:ClaudeCodeDiffAccept (<leader>aa) / :ClaudeCodeDiffDeny (<leader>ad)	accept or reject diffs proposed by Claude	plugin spec

With these steps, lazy.nvim will install claudecode.nvim, set up sensible default mappings, and allow you to tailor keyboard shortcuts and window behaviour to your liking.

[gonzaloserrano]

Thanks, it worked. I swear I had configured it exactly as defined here and it did not work, but now it did ¯_(ツ)_/¯