Qoder CLI 支持四种 Vim 模式配置:一、全局启用 readline vi-mode;二、v0.8.3+ 版本通过 QODER_EDITOR_MODE=vi 环境变量启用;三、用 EDITOR=vim 配合 /edit 指令调用外部 Vim 编辑;四、插件机制自定义 keybinding 映射。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您在使用 Qoder CLI 时习惯 Vim 操作逻辑,但发现其默认不支持 Vim 风格的编辑模式切换,则可能是由于终端输入框未启用 Vim 键绑定。以下是实现 Qoder CLI 与 Vim 模式无缝协同的多种配置方法:
一、启用 readline 的 vi-mode 全局配置
该方法通过修改系统级 readline 配置,使所有支持 readline 的命令行工具(包括 Qoder CLI)统一启用 Vim 键绑定,无需修改 Qoder 源码或依赖其内部支持。
1、打开或创建用户级 readline 配置文件:~/.inputrc
2、向该文件中追加以下内容:
set editing-mode vi
3、保存文件后,在当前终端执行:bind -f ~/.inputrc
4、启动 Qoder CLI,此时在命令行输入区域即可使用 Esc 进入命令模式,i 或 a 切换至插入模式。
二、为 Qoder CLI 单独配置 vi-editing-mode(适用于 v0.8.3+)
Qoder CLI 自 v0.8.3 起支持通过环境变量启用内置 vi 编辑模式,该设置仅作用于 Qoder CLI 输入框,不影响其他工具。
1、在 Linux/macOS 终端中执行:export QODER_EDITOR_MODE=vi
2、若需持久生效,将该行添加至 shell 配置文件(如 ~/.bashrc 或 ~/.zshrc)
3、重新加载配置:source ~/.bashrc(或对应配置文件)
代码编辑 CLI 工具集合:Cursor CLI(agent)和 Qoder CLI(qodercli),用于代码修改、重构、Code Review 及自动化代码任务。
4、启动 Qoder CLI,输入命令时按 Esc 可触发 vi 命令模式,支持 k/j 上下移动历史命令、l/h 左右移动光标等基础操作。
三、使用外部编辑器联动(兼容任意版本)
当 Qoder CLI 接收长文本输入(如 prompt、代码块、JSON 参数)时,可调用本地 Vim 编辑器进行编辑,避免在交互式输入框中手动修正复杂内容。
1、确保系统已安装 Vim 并可通过命令行调用:vim --version
2、设置环境变量指定编辑器:export EDITOR=vim
3、在 Qoder CLI 交互界面中,输入特殊指令触发外部编辑:/edit
4、Vim 启动后完成编辑并保存退出,内容将自动载入 Qoder CLI 当前输入上下文。
四、自定义 keybinding 映射(高级用户)
对于深度定制需求,可通过 Qoder CLI 的插件机制注入自定义按键映射逻辑,覆盖默认行为,实现与 Vim 完全一致的快捷键语义(如 ciw 替换当前词、ct" 删除到双引号等)。
1、创建插件目录:mkdir -p ~/.qoder/plugins/vim-bindings
2、编写映射配置文件 ~/.qoder/plugins/vim-bindings/bindings.json,内容包含 JSON 格式的 keystroke-to-action 映射规则
3、启用插件:qodercli plugin enable vim-bindings
4、重启 Qoder CLI,验证映射是否生效(例如在空输入行按 Esc 后输入 :q 应退出当前编辑状态)。

















