opencode.nvim

在 Neovim 里无缝调用 AI 编程助手,边写边聊不切屏

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 办公效率 🍴 复刻 161 🐛 待处理 12 👀 关注 9
GitHub ↗
GitHub 星标 ★ 3920
维护状态 较活跃
是否开源 开源
定价模式 🏷️完全免费 开源项目,MIT许可证,完全免费,无付费版本。

项目预览

opencode.nvim 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类办公效率
开发团队nickjvandyke
定价模式🏷️完全免费
价格说明开源项目,MIT许可证,完全免费,无付费版本。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Lua
技术栈/模型ai,ai-agents,ai-assistant,lua,neovim,neovim-plugin,nvim,opencode,plugin,terminal
GitHub 星标★ 3920
上线时间2025-07-12 00:00:00
代码更新2026-10-30
仓库体积926 KB
本站数据更新2026-11-18
维护状态较活跃
收录时间2026-08-09
浏览次数7

项目介绍

opencode.nvim 是一个将 OpenCode 命令行 AI 编程助手深度集成到 Neovim 编辑器中的插件。它解决了开发者需要在终端和编辑器之间频繁切换来使用 AI 助手的问题,让你在不离开 Neovim 的情况下,就能享受 AI 驱动的代码生成、解释、重构等能力。该插件基于 Lua 编写,利用 Neovim 的原生 UI 组件(如浮动窗口、缓冲区)来呈现交互界面,支持流式输出、多会话管理、代码差异预览等核心功能。它旨在提供一种无缝的、沉浸式的 AI 编程体验,让开发者能够在自己熟悉的编辑流程中,自然地调用 AI 能力,提升编码效率。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 3920

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:入门 约 10 分钟 部署方式:本地安装 6 步

环境要求

  • Neovim(需支持 vim.pack 的较新版本)
  • 已安装并可运行的 OpenCode(插件本身只是集成层)
  • 插件管理器任选:vim.pack(Neovim 内置)、lazy.nvim 或 nixvim(Nix 用户)
  • 纯 Lua 插件,无需编译或额外运行时

安装与启动步骤

  1. 1准备 OpenCode 本体

    插件只负责把 OpenCode 接入 Neovim,需先去官网 https://opencode.ai/ 安装 OpenCode,并确认终端中能正常运行。

  2. 2用 vim.pack 安装(推荐)

    把插件加入 vim.pack 清单,version 指定最新稳定版;写入你的 Neovim 配置文件后重启生效。

    vim.pack.add({
      {
        src = "https://github.com/nickjvandyke/opencode.nvim",
        version = vim.version.range("*"),
      },
    })
  3. 3改用 lazy.nvim 安装

    如果你用 lazy.nvim,则用左侧插件规格替代 vim.pack;两种方式二选一,不要同时装。

    {
      "nickjvandyke/opencode.nvim",
      version = "*",
      config = function()
        vim.g.opencode_opts = {}
      end,
    }
  4. 4Nix 用户安装方式

    使用 nixvim 的用户直接在 extraPlugins 中引用 pkgs.vimPlugins.opencode-nvim 即可。

    programs.nixvim = {
      extraPlugins = [
        pkgs.vimPlugins.opencode-nvim
      ];
    };
  5. 5配置插件选项

    通过全局变量 vim.g.opencode_opts 传入配置;README 说明默认体验已经很完整,可留空使用默认值。

    vim.g.opencode_opts = {
      -- Your configuration, if any
    }
  6. 6设置推荐按键映射

    复制 README 提供的映射,即可用 <C-a> 提问、<C-x> 选择提示词、go 追加代码范围等。可按需改键。

    vim.keymap.set({ "n", "x" }, "<C-a>", function() require("opencode").ask("@this: ") end, { desc = "Ask OpenCode…" })
    vim.keymap.set({ "n", "x" }, "<C-x>", function() require("opencode").select() end, { desc = "Select OpenCode…" })
    vim.keymap.set({ "n", "x" }, "go", function() return require("opencode").operator("@this ") end, { desc = "Append range to OpenCode", expr = true })
    vim.keymap.set({ "n" }, "goo", function() return require("opencode").operator("@this ") .. "_" end, { desc = "Append line to OpenCode", expr = true })
    vim.keymap.set({ "n" }, "<S-C-u>", function() require("opencode").command("session.half.page.up") end, { desc = "Scroll OpenCode up" })
    vim.keymap.set({ "n" }, "<S-C-d>", function() require("opencode").command("session.half.page.down") end, { desc = "Scroll OpenCode down" })

关键配置

配置项必填说明示例
vim.g.opencode_opts否插件配置表,可自定义行为;留空即使用默认配置vim.g.opencode_opts = {}

如何确认成功

在 Neovim 中按 <C-a>,能弹出 OpenCode 提问输入界面并正常返回结果,即集成成功。

常见问题

Q:必须自己先装 OpenCode 吗?

A:需要。opencode.nvim 只是连接层,负责对接 OpenCode 的 TUI 和 API,OpenCode 本体要按官网 https://opencode.ai/ 单独安装。

Q:vim.pack 和 lazy.nvim 要都配吗?

A:不需要,任选一种安装方式即可,README 把 vim.pack 列为推荐方式。

Q:按键与已有映射冲突怎么办?

A:<C-a>、<C-x>、go、goo 等只是 README 的推荐示例,可自行改成不冲突的按键。

Q:配置项有哪些?

A:README 只说明默认配置已足够可靠,完整选项与默认值需查看仓库内 lua/opencode/config.lua。

注意事项

  • 插件可连接任意已有 OpenCode 服务,也可启动集成实例,连接细节见仓库配置类型说明。
  • version = "*" 表示使用最新稳定版,需要尝鲜可自行调整。
  • 修改按键映射或配置后需重启 Neovim 或重新加载配置才生效。

核心亮点

  • 深度集成 Neovim,利用浮动窗口和缓冲区,交互体验流畅自然
  • 支持流式输出和代码差异预览,实时查看 AI 生成结果
  • 多会话管理,方便切换不同任务上下文

不足之处

  • 依赖 OpenCode 命令行工具,需额外安装配置
  • 文档/社区待观察

适用场景

  • 在 Neovim 中编写代码时,需要快速获取 AI 建议或代码补全
  • 进行代码审查或重构时,希望 AI 辅助分析并生成修改方案
  • 学习新代码库或理解复杂逻辑时,通过对话式交互获取解释

替代项目

Copilot.nvim、ChatGPT.nvim、CodeCompanion.nvim

上一篇:CopilotForXcode

下一篇:SocratiCode

同类项目推荐

tastecode 开源

Windows 上统一管理多个 AI 编程代理的漂亮控制台

One desktop app for your coding agents, made for creative work. Early beta, Windows ···

★ 588 2026-10-08
gpt-pilot 开源

说需求,AI 帮你写代码并调试到能跑

The first real AI developer

★ 33643 2026-08-09
ai-first-toolkit 开源

用 AI 技能包审计、重构、启动项目,让开发更智能

Open-source Claude Code skills and Codex skills for AI-first work. Audit, re-enginee···

★ 142 2026-08-09
PiG 开源

把 TypeScript 版 Pi 编码智能体原样搬进 Go,行为不变、部署更轻

PiG (Pi in Go) is a faithful Go port of upstream Pi, the TypeScript codebase behind ···

★ 883 2026-10-19
goverter 开源

声明接口签名,自动生成类型安全的 Go 结构体转换代码

Generate type-safe Go converters by defining function signatures.

★ 892 2026-10-31
cheat-sheets 开源

一页速查,搞定编程、游戏、AI开发常用知识

Cheat Sheets heaven for all kind of programming language and frameworks + Game and W···

★ 120 2026-08-09
nanolang 开源

让大模型少写代码也能跑起来的极简语言

A tiny experimental language designed to be targeted by coding LLMs

★ 630 2026-09-16
CodeAF 开源

用开放模型编排多智能体,自动完成编码任务

Open-Source Software factory for Open Models

★ 793 2026-11-06
ogcode 开源

省 token 的 AI 编码工作台,长会话成本直降 70%

An open-source, local-first AI teammate and agent operating environment for turning ···

★ 148 2026-08-09