Vim/Neovim中使用Claude进行AI结对编程:黑客进入LLM世界的门户
这个vim插件将Claude深度集成到您的Vim工作流程中 - 不用在笨拙的网页版Claude Chat中工作,而是直接在当前打开的vim缓冲区中进行聊天和协作编程。
Claude是您的结对编程伙伴。 您可以讨论要构建什么或如何调试问题,Claude会在查看您的实际代码的同时提供意见,或者直接提出修改建议 - 可以是高层次的,也可以直接编写代码。
这个插件不是:
- 像Github Copilot或Codeium那样的"代码补全"工具。 (您可以将这些工具与claude.vim一起使用!) 相反,这个插件提供了一个以聊天/指令为中心的界面。
- 命令行编码框架。它比aider或dravid等工具更优化人机协作。 在Claude编写代码之前,您可能需要就设计决策达成一致。 为了发挥作用,它需要反馈和更改审查。 这就是为什么访问聊天历史和vimdiff界面是杀手级功能。
这个插件将为您提供一个能在您的代码库中一次性实现新功能的伙伴:
https://github.com/pasky/claude.vim/assets/18439/73ffcaac-d5b4-4508-b9fa-077c189d2c93
如果您的代码有点混乱,可以让它重构您的代码,并进行持续讨论:
https://github.com/pasky/claude.vim/assets/18439/625060ca-600f-4774-adbe-ec93f94a30e9
您可以要求它修改或扩展您代码中选定的部分:
https://github.com/pasky/claude.vim/assets/18439/71544b57-e87d-4dd4-a7e6-4051fa080d18
它可以使用Claude Tools接口 - 它会根据需要打开文件并执行vim命令。
在弄清楚您的要求时,它还可以(在您逐案同意的情况下)评估Python表达式:
它还可以通过先阅读文档,然后克隆git仓库,浏览目录树等方式执行复杂任务。
实际上,当前版本也可以执行shell脚本。它不仅可以帮助您进行编码,还可以协助系统管理任务。
最终,Claude.vim几乎可以作为Claude.ai或ChatGPT的完整文本终端替代品。如果它不知道某些内容,还会搜索网络。
Sonnet 3.5还不够好,无法完全自主执行复杂任务。 这就是为什么您可以与它聊天,审查并拒绝其更改和工具执行尝试等。 您仍然需要进行"深入思考",并决定告诉它做什么。
话虽如此,这个插件大约95%的代码是由Claude Sonnet 3.5编写的,大部分时间已经在插件内"自托管"。
注意:这是早期alpha软件。 预计它将快速发展...
而且不一定以向后兼容的方式。如果您正在使用它,请与维护者保持联系
(在libera IRC上的pasky
,或Twitter / X上的@xpasky,或者通过
github问题或PR)。
安装
首先,使用您喜欢的包管理器安装,或使用Vim的内置包支持。
Vim:
mkdir -p ~/.vim/pack/pasky/start
cd ~/.vim/pack/pasky/start
git clone https://github.com/pasky/claude.vim.git
Neovim:
mkdir -p ~/.config/nvim/pack/pasky/start
cd ~/.config/nvim/pack/pasky/start
git clone https://github.com/pasky/claude.vim.git
为了允许网络访问,请安装elinks或felinks(例如 brew install felinks
)。
要允许访问Google,你首先需要手动打开elinks,导航到 https://www.google.com/search?q=lala
,然后选择并点击cookie同意中的一个按钮(然后使用q
退出)。
配置
通过在 https://console.anthropic.com/ 注册来获取你的Claude API密钥。 Anthropic可能会给你5美元的免费信用额度以帮助你开始使用,这足够使用多个小时(取决于你的使用方式)。
注意:这是一项基于消耗和生成的令牌数量收费的云服务。处理大量内容时要小心,关注你在Anthropic的使用情况/账单仪表板等。
在你的.vimrc中设置Claude API密钥:
let g:claude_api_key = '你的API密钥'
(你也可以使用AWS Bedrock作为Claude提供者 - 在这种情况下,设置 let g:claude_use_bedrock = 1
)
使用方法
首先,有几个你应该大致了解的vim概念:
- 在窗口间切换(
:help windows
)- 至少要知道<C-W><C-W>
用于在活动窗口间循环 - 差异模式(
:help diff
)- 至少要知道d
o
用于接受光标下的更改 - 折叠(
:help folding
)- 至少要知道z
o
用于打开折叠(聊天交互),z
c
用于关闭折叠 - 引导键(
:help leader
)- 如果不确定,大多数情况下\
是提到<Leader>
时要按的键(但在新键盘上,§
或±
可能是不错的引导键设置)
Claude.vim目前提供两种主要的交互模式:
- 简单实现助手
- 聊天界面
ClaudeImplement
在这种模式下,你选择一段代码并要求Claude以某种方式修改它;Claude会提出修改建议并让你审核和接受。
- 在可视模式下选择代码块。(注意Claude只能"看到"这个选择,没有额外的上下文!因此,选择要宽松一些,例如整个函数。)
<Leader>ci
-:'<,'>ClaudeImplement ...
的快捷键- 在命令模式下输入你的指令(如"修复拼写错误"或"抽取公共代码"或"添加错误处理"或"这里有一些bug")作为ClaudeImplement参数
- 在差异模式下审核并接受建议的更改
- 切换到临时窗口(
<C-W>l
)并用:q
关闭它。
ClaudeChat
在这种模式下,你与Claude聊天。你可以聊任何话题,但特别之处在于Claude还能看到你所有缓冲区的全部内容(:buffers
中列出的 - 大致是你当前在vim中打开的所有文件)。
<Leader>cc
- 打开Claude聊天窗口的快捷键- 在
You:
行上输入消息(和/或在其下方缩进(!)) <C-]>
(在插入或普通模式下)发送你的消息并获取回复- 在Claude窗口中阅读回复等
- 如果Claude提出代码更改,差异模式会在可能的情况下自动弹出以应用更改。
你可以询问Claude如何调试或修复你观察到的bug,或者要求它提出甚至相当复杂的新功能实现建议。例如:
You: 你能为这个插件写一个简短的README.md吗?
Claude:
这是Claude Vim插件的README.md草稿:
```markdown
# Claude Vim 插件
一个将Claude(AI助手)直接集成到你的Vim工作流程中的Vim插件。
...
之前的交互会自动折叠以便于查看(Claude可能会有点啰嗦),但在询问Claude时,聊天历史也是可见的。然而,你可以简单地编辑缓冲区来任意修改历史记录(或直接删除它)。
注意:每一次Claude问答往返都会发送完整的聊天历史和所有缓冲区的全部内容。这可能会快速消耗令牌。(即使不太昂贵,也请记住Claude还有每日总令牌限制。)定期清理你的聊天历史。