Claude Code nvim完全ガイド【2026年最新】：プラグイン比較・インストール・tmux連携まで

Claude CodeをNeovimで使う完全ガイド【2026年最新】：プラグイン比較・インストール・tmux連携まで

Neovimでのはじめ方：まず知っておくべきこと

1. プラグインなし：NeovimのターミナルバッファからCLIで直接使う
2. greggh/claude-code.nvim：ターミナル統合に特化したシンプルなプラグイン
3. coder/claudecode.nvim：VS Codeと同等のIDE統合を実現したプラグイン

2大プラグインの比較：greggh vs coder

主要な違いをまとめます。

coder/claudecode.nvimのインストールと設定

インストール手順（lazy.nvim）

{
  "coder/claudecode.nvim",
  dependencies = { "folke/snacks.nvim" },
  config = true,
  keys = {
    { "<leader>a", nil, desc = "AI/Claude Code" },
    { "<leader>ac", "<cmd>ClaudeCode<cr>", desc = "Toggle Claude" },
    { "<leader>af", "<cmd>ClaudeCodeFocus<cr>", desc = "Focus Claude" },
    { "<leader>ar", "<cmd>ClaudeCode --resume<cr>", desc = "Resume Claude" },
    { "<leader>aC", "<cmd>ClaudeCode --continue<cr>", desc = "Continue Claude" },
    { "<leader>am", "<cmd>ClaudeCodeSelectModel<cr>", desc = "Select Claude model" },
    { "<leader>ab", "<cmd>ClaudeCodeAdd %<cr>", desc = "Add current buffer" },
    { "<leader>as", "<cmd>ClaudeCodeSend<cr>", mode = "v", desc = "Send to Claude" },
    { "<leader>aa", "<cmd>ClaudeCodeDiffAccept<cr>", desc = "Accept diff" },
    { "<leader>ad", "<cmd>ClaudeCodeDiffDeny<cr>", desc = "Deny diff" },
  },
}

ローカルインストールへの対応

{
  "coder/claudecode.nvim",
  dependencies = { "folke/snacks.nvim" },
  opts = {
    terminal_cmd = "~/.claude/local/claude",
  },
  config = true,
}

主要なコマンド一覧

greggh/claude-code.nvimのインストールと設定

lazy.nvimでのインストール

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

主要な設定オプション

require("claude-code").setup({
  -- ウィンドウの設定
  window = {
    split_ratio = 0.3,      -- 画面に占める割合（0〜1）
    position = "botright",  -- "botright", "topleft", "vertical", "float"
    enter_insert = true,    -- 開いたらすぐinsertモードに入る
    hide_numbers = true,    -- ターミナルで行番号を非表示
  },
  -- ファイル変更の自動検出
  refresh = {
    enable = true,
    updatetime = 100,        -- ファイル変更検出の応答速度（ミリ秒）
    timer_interval = 1000,   -- チェック間隔（ミリ秒）
    show_notifications = true,
  },
  -- Git設定
  git = {
    use_git_root = true,    -- Gitルートをカレントディレクトリとして使用
  },
  -- キーマップ
  keymaps = {
    toggle = {
      normal = "<C-,>",
      terminal = "<C-,>",
      variants = {
        continue = "<leader>cC",
        verbose = "<leader>cV",
      },
    },
  }
})

フローティングウィンドウの設定はこうなります。

require("claude-code").setup({
  window = {
    position = "float",
    float = {
      width = "80%",
      height = "80%",
      row = "center",
      col = "center",
      relative = "editor",
      border = "rounded",
    },
  },
})

tmuxとNeovimを組み合わせたワークフロー

┌──────────────────┬──────────────────┐
│                  │                  │
│   Claude Code    │     Neovim       │
│   (claude CLI)   │   (コードを開く)  │
│                  │                  │
├──────────────────┴──────────────────┤
│              Shell                  │
└─────────────────────────────────────┘

-- init.luaに追加
vim.opt.autoread = true
vim.api.nvim_create_autocmd(
  { "FocusGained", "TermLeave", "BufEnter", "WinEnter", "CursorHold", "CursorHoldI" },
  {
    pattern = "*",
    command = "checktime",
  }
)

実践的なTips：コンテキストの渡し方を工夫する

カーソル位置のコードをClaudeに伝える

-- 相対パス付きでヤンク（Claude Codeに貼り付けるとファイルパスも伝わる）
vim.keymap.set("v", "<leader>yr", function()
  local path = vim.fn.expand("%:.")
  local lines = vim.fn.getline("'<", "'>")
  local start_line = vim.fn.line("'<")
  local content = path .. ":" .. start_line .. "\n" .. table.concat(lines, "\n")
  vim.fn.setreg("+", content)
end, { desc = "Yank with relative path" })

モデル切り替えをNeovim内で完結させる

lazy nvim claude codeの設定をチームで共有する

{
  "coder/claudecode.nvim",
  dependencies = { "folke/snacks.nvim" },
  opts = {
    terminal_cmd = vim.env.CLAUDE_CMD or "claude",
  },
  config = true,
}

codecompanion.nvimとの使い分け

よくある質問とトラブルシューティング

Claude Codeが起動しない

# インストール確認
which claude

# Claude Codeのインストール（公式ドキュメントに従う）
# https://docs.anthropic.com/en/docs/claude-code

バッファが自動更新されない

WebSocket接続エラー（coder版）

opts = {
  port_range = { min = 20000, max = 65535 },
}

まとめ：Neovimでのベストな選択

---

よくある質問（FAQ）

Q: Neovimのバージョンが0.7.x以下だと使えませんか？

Q: claude code for nvimは公式対応になる予定はありますか？

Q: avante.nvimとの違いは？

Q: Windows環境でも使えますか？

---

出典

• coder/claudecode.nvim - GitHub
• greggh/claude-code.nvim - GitHub
• Claude Code 公式ドキュメント - Anthropic