
claude-code.nvim
在 Neovim 里直接调用 Claude Code,边写代码边问 AI,不用切窗口。
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2108
使用教程
⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。
环境要求
- Neovim 0.7.0 或更高版本
- 已安装 Claude Code CLI,且命令可在 PATH 中找到
- plenary.nvim(本插件的依赖,用于 git 操作)
安装与启动步骤
-
1确认 Neovim 版本
README 明确要求 Neovim 0.7.0 或更高版本,版本过低插件无法正常工作,请先自行确认版本。
-
2安装 Claude Code CLI
按 Claude Code 官方仓库的说明安装 CLI,并确保终端里能直接调用该命令、已加入 PATH。
-
3安装 plenary.nvim
plenary.nvim 是本插件列出的依赖,负责 git 相关操作,需要先在你的插件管理器中装上它。
-
4安装 claude-code.nvim
README 的 Installation 一节为空、没有给出任何安装命令,请按你所用 Neovim 插件管理器的方式安装本仓库。
-
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启动 Claude Code
在 Neovim 中执行命令即可打开/切换 Claude Code 终端窗口,再次执行则关闭。
:ClaudeCode -
7自定义快捷键
默认用 <C-,> 切换窗口,也可以自己映射;README 给出的 Lua 映射写法如下。
vim.keymap.set('n', '<leader>cc', '<cmd>ClaudeCode<CR>', { desc = 'Toggle Claude Code' })
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
command | 否 | 启动 Claude Code 所用的命令 | claude |
window.position | 否 | 终端窗口位置,支持 botright、topleft、vertical、float 等 | botright |
window.split_ratio | 否 | 终端窗口占屏幕比例(横向为高度、纵向为宽度) | 0.3 |
window.enter_insert | 否 | 打开 Claude Code 时是否自动进入插入模式 | true |
refresh.enable | 否 | 是否开启文件变更检测与自动重载 | true |
git.use_git_root | 否 | 在 git 项目中是否用仓库根目录作为工作目录 | true |
如何确认成功
在 Neovim 中执行 :ClaudeCode 后出现 Claude Code 终端窗口,即可与 AI 对话;再执行一次可关闭该窗口。
常见问题
Q:提示找不到 claude 命令怎么办?
A:确认 Claude Code CLI 已安装且其可执行文件在 PATH 中;也可以修改配置项 command,指向你实际使用的启动命令。
Q:怎么调整窗口位置和大小?
A:修改 window.position(如改为 float 使用浮动窗口)和 window.split_ratio;浮动窗口下还可用 window.float 的 width、height、row、col、border 等字段。
Q:Claude Code 改动的文件没有自动刷新?
A:检查 refresh.enable 是否为 true,必要时调小 refresh.timer_interval(默认 1000 毫秒)并放开 refresh.show_notifications 以便看到提示。
Q:切换快捷键没反应?
A:检查 keymaps.toggle.normal / keymaps.toggle.terminal 是否被设成 false 而禁用,改回按键或换成自己习惯的映射。
注意事项
- README 的 Installation 一节为空,未提供任何安装命令,插件安装方式需按你所用的插件管理器自行处理。
- 默认使用 git 项目根目录作为工作目录(git.use_git_root = true),并会自动检测、重载被 Claude Code 修改的文件。
- 可通过 command_variants 使用 --continue、--resume、--verbose 等命令行参数变体。
- 仓库面向开发者也提供了测试与钩子脚本(make test、scripts/setup-hooks.sh),普通用户无需执行。
核心亮点
- 原生 Lua 实现,性能好,与 Neovim 生态无缝集成
- 提供交互式侧边栏和快捷键,操作流畅,支持暂停/恢复会话
- 支持自定义 UI 和快捷键,适配个人工作流
不足之处
- 依赖 Claude Code CLI,需额外安装和配置
- 文档/社区待观察
适用场景
- 在 Neovim 中编写代码时,快速向 AI 提问或请求代码解释
- 利用 AI 辅助重构或生成代码片段,无需切换编辑器
- 通过快捷键和侧边栏管理多个 AI 会话,提升编码效率
替代项目
Copilot.vim、ChatGPT.nvim、CodeCompanion.nvim
上一篇:alan-sdk-web
下一篇:OpenCluely
同类项目推荐
EchoIsland
开源
把多个AI编程助手收进灵动岛,切换零打扰
Free, open-source Dynamic Island-style desktop hub for AI coding sessions. Unify Cod···
remote_compilation_helper
开源
让 AI 代理的编译任务远程跑,本地秒收产物
Intercepts cargo/gcc builds from AI coding agents via hooks and transparently routes···
dotnet-skills
开源
一条命令给 AI 编程助手装上 .NET 技能包
One of the largest .NET-focused skill collections for AI coding assistants, with a c···
Claude-ast-index-search
开源
给 AI 装个代码索引,搜符号省一半 token
Cli allows AST search, ~40-50% economy tokens. Claude/Codex/Cursor searches (suitabl···
chatGL
开源
用大白话描述,AI 直接生成 GLSL 着色器代码
GLSL shader generator using GPT-3
finding-unknowns-skills
开源
让 AI 代理先问清楚再写代码,少返工
14 installable skills for Claude Code, OpenAI Codex, and Hermes: find unknowns, clar···
eca-emacs
开源
在 Emacs 里直接召唤 AI 写代码、改代码
Editor Code Assistant (ECA) integration for Emacs
lacp
开源
给本地 AI 编码代理装上策略、记忆和回滚开关
Local-first policy, evidence, memory, and recovery controls for Claude, Codex, Herme···
myrlin-workbook
开源
一个浏览器管住所有 AI 编码会话,还能手机看
Open-source workspace manager for AI coding CLIs: Claude Code and ChatGPT Codex in o···