claude-code.nvim

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• Neovim 0.7.0 或更高版本
• 已安装 Claude Code CLI，且命令可在 PATH 中找到
• plenary.nvim（本插件的依赖，用于 git 操作）

安装与启动步骤

1. 1确认 Neovim 版本

   README 明确要求 Neovim 0.7.0 或更高版本，版本过低插件无法正常工作，请先自行确认版本。

2. 2安装 Claude Code CLI

   按 Claude Code 官方仓库的说明安装 CLI，并确保终端里能直接调用该命令、已加入 PATH。

3. 3安装 plenary.nvim

   plenary.nvim 是本插件列出的依赖，负责 git 相关操作，需要先在你的插件管理器中装上它。

4. 4安装 claude-code.nvim

   README 的 Installation 一节为空、没有给出任何安装命令，请按你所用 Neovim 插件管理器的方式安装本仓库。

5. 5配置插件

   在 Neovim 配置中调用 setup 传入配置表；所有字段都有默认值，只写需要覆盖的项即可。

   require("claude-code").setup({
     window = {
       split_ratio = 0.3,
       position = "botright",
       enter_insert = true,
     },
     command = "claude",
     git = {
       use_git_root = true,
     },
   })

   复制

6. 6启动 Claude Code

   在 Neovim 中执行命令即可打开/切换 Claude Code 终端窗口，再次执行则关闭。

   :ClaudeCode

   复制

7. 7自定义快捷键

   默认用 切换窗口，也可以自己映射；README 给出的 Lua 映射写法如下。

   vim.keymap.set('n', 'cc', 'ClaudeCode', { desc = 'Toggle Claude Code' })

   复制

关键配置

如何确认成功

在 Neovim 中执行 :ClaudeCode 后出现 Claude Code 终端窗口，即可与 AI 对话；再执行一次可关闭该窗口。

常见问题

注意事项

• README 的 Installation 一节为空，未提供任何安装命令，插件安装方式需按你所用的插件管理器自行处理。
• 默认使用 git 项目根目录作为工作目录（git.use_git_root = true），并会自动检测、重载被 Claude Code 修改的文件。
• 可通过 command_variants 使用 --continue、--resume、--verbose 等命令行参数变体。
• 仓库面向开发者也提供了测试与钩子脚本（make test、scripts/setup-hooks.sh），普通用户无需执行。