打造你的私人 AI 编程助手：CodeCompanion.nvim 全方位配置指南

打造你的私人 AI 编程助手：CodeCompanion.nvim 全方位配置指南

在 2026 年的 Neovim 生态中，AI 插件正经历着从“简单调用”到“深度集成”的进化。CodeCompanion.nvim 正是其中的佼佼者。不同于其他插件，它凭借高度可定制的“策略（Strategies）”和“适配器（Adapters）”系统，让你可以完全定义 AI 的交互行为。

本文将带你从零开始，构建一个美观、高效且支持 ACP (Autocomplete Provider) 极速补全的 AI 编程环境。

一、 为什么选择 CodeCompanion.nvim？

CodeCompanion 的核心逻辑基于 “可组合性”：

二、 基础安装与依赖管理

我们使用 lazy.nvim 进行安装。为了确保启动速度，采用了 VeryLazy 延迟加载策略。

return {
"olimorris/codecompanion.nvim",
event = "VeryLazy",
lazy = true,
dependencies = {
"nvim-lua/plenary.nvim",
"nvim-treesitter/nvim-treesitter",
"hrsh7th/nvim-cmp", — 推荐：用于聊天窗口的斜杠命令补全
"nvim-telescope/telescope.nvim", — 用于 Action 面板选择
"stevearc/dressing.nvim", — 优化 UI 选择框
"MeanderingProgrammer/render-markdown.nvim", — 实时渲染对话中的 Markdown
},
config = function()
require("codecompanion").setup({
— 详细配置见下文
})
end,
}

三、 核心配置：适配器与 ACP 模式

适配器是连接大模型的桥梁。除了常规的 API 接入，ACP (Autocomplete Provider) 模式是追求极速反馈玩家的首选。

adapters = {
deepseek = function()
return require("codecompanion.adapters").extend("openai_compatible", {
env = {
url = "[https://api.deepseek.com](https://api.deepseek.com)",
api_key = os.getenv("DEEPSEEK_API_KEY"),
},
schema = { model = { default = "deepseek-chat" } },
})
end,

ACP 模式通常配合高性能 CLI 工具（如 qwen-cli）。以下代码展示了如何自定义一个带 OAuth 自动化认证的适配器：

acp = {
qwen_cli = function()
return require("codecompanion.adapters").extend("gemini_cli", {
commands = {
default = { "qwen", "–experimental-acp" }, — 调用本地 Qwen CLI 的 ACP 模式
},
defaults = {
auth_method = "qwen-oauth",
oauth_credentials_path = vim.fs.abspath("~/.qwen/oauth_creds.json"),
timeout = 20000,
},
handlers = {
auth = function(self)
local oauth_path = self.defaults.oauth_credentials_path
return (oauth_path and vim.fn.filereadable(oauth_path)) == 1
end,
},
})
end,
},
},

四、 策略映射：让交互更具“人格”

策略（Strategies）定义了 AI 如何与你协作。我们可以通过 Nerd Font 图标增强视觉区分度。

strategies = {
chat = {
adapter = "qwen_cli",
roles = {
llm = " Qwen", — AI 助手图标
user = " Me", — 用户图标
},
keymaps = {
send = { modes = { n = "<CR>", i = "<C-s>" }, callback = "keymaps.send" },
stop = { modes = { n = "<C-c>" }, callback = "keymaps.stop" },
clear = { modes = { n = "gc" }, callback = "keymaps.clear" },
},
},
inline = {
adapter = "qwen_cli",
keymaps = {
accept = { modes = { n = "ga" }, callback = "keymaps.accept" }, — ga 接受修改
reject = { modes = { n = "gr" }, callback = "keymaps.reject" }, — gr 拒绝修改
},
},
}

五、 UI 交互与效率优化

为了不干扰代码逻辑，建议采用侧边垂直分屏，并启用 mini_diff 实现 IDE 级别的代码对比。

display = {
action_palette = {
provider = "telescope", — 使用 Telescope 搜索 Action
opts = { width = 40, height = 10 },
},
chat = {
window = {
layout = "vertical", — 垂直分屏
width = 0.3, — 占据 30% 宽度
border = "rounded",
},
intro_message = "Qwen AI Assistant Active. Use /buffer or /files to add context.",
},
diff = {
enabled = true,
provider = "mini_diff", — 一流的 Diff 高亮体验
},
}

为了极速调用，建议配置以下映射和别名：

— 快捷键映射
vim.keymap.set({ "n", "v" }, "<leader>ca", "<cmd>CodeCompanionActions<cr>", { silent = true })
vim.keymap.set({ "n", "v" }, "<leader>cc", "<cmd>CodeCompanionChat Toggle<cr>", { silent = true })

— 命令行别名 (Command Abbreviations)
vim.cmd([[cab cc CodeCompanion]]) — 输入 :cc 调用指令
vim.cmd([[cab ccc CodeCompanionChat]]) — 输入 :ccc 开启聊天

总结：构建你的 AI 工作流

CodeCompanion.nvim 的强大之处在于它从不限制你的想象力。通过 ACP 模式 的底层加速和**斜杠命令（/buffer, /files）**的上下文注入，你可以让 AI 真正读懂你的项目。

无论是通过 ga 一键接受重构建议，还是通过 #lsp 变量让 AI 修复复杂的语法错误，这种无缝的交互体验正是 Neovim 高效开发的魅力所在。

现在就动手配置你的 CodeCompanion，开启全键盘流的 AI 协作之旅吧！

希望这篇深度指南能帮你构建出理想的 AI 辅助环境。如果你有任何适配器配置上的疑问，欢迎在评论区交流！