Obsidian Copilot—Obsidian AI 助手插件

Obsidian Copilot 是一个 GitHub 开源项目。在 Obsidian 中运行代理 – OpenCode、Codex、Claude Code 等。

选择您的代理

代理是 Copilot 用于多步骤工作的主要体验。它可以检查笔记、使用工具、创建 Obsidian 文件，并在您控制的权限下跨多轮继续工作。

• opencode（推荐）：让 Copilot 下载并管理它，然后使用 Copilot 托管的模型、您自己的提供商密钥或本地模型。
• Claude Code：连接现有安装。Copilot 检测常见安装位置并使用您的 Claude Code 登录。
• Codex：通过 @agentclientprotocol/codex-acp 适配器连接 Codex 并使用您现有的 Codex 登录。

已经为 Claude 或 ChatGPT 付费，或已有模型 API 访问权限？您可以将该访问权限带入 Copilot，无需购买 Copilot 计划。提供商条款和使用限制仍然适用。

设置 Copilot

• 从 Obsidian 社区插件安装 Copilot。
• 打开设置 → Copilot → 基本 → 代理。
• 选择下载 opencode、使用自动检测连接 Claude Code，或让 Copilot 安装其已测试的 Codex 适配器。
• 选择 Agent 功能区图标，或运行”打开 Copilot Agent 聊天窗口”命令。

新手指南涵盖了每种设置路径，包括托管和自定义 Codex 适配器。

围绕您的保险库构建

• 项目：为持续进行的工作提供独立的指令、可复用的上下文和聊天历史。项目可与 Opencode、Claude 或 Codex 配合使用。了解项目详情。
• 跨代理共享的技能：添加一次技能，然后为每个已安装的代理启用该技能。Copilot 还包含用于 Obsidian Markdown、Bases、Canvas 和 Obsidian CLI 的技能。了解技能详情。
• 命令：保存可重复使用的提示，在 Agent 中使用 / 运行命令，或在编辑器和命令面板中调用命令。创建命令。
• 快速提问：无需离开笔记即可就选中的内容提问。继续对话、替换文本、插入答案或复制回答。快速提问使用您的快速聊天模型。设置快速提问。
• 多会话：同时打开不同的 Agent 标签页处理不同任务。拥有 Plus 访问权限时，可使用 @ 提及多个已安装的代理发起单一只读研究或审查请求。

对于不需要代理参与的简短对话，请使用快速聊天。

使用托管模型、自带密钥或本地模型

• Copilot 托管：添加 Copilot 许可证，然后为 Opencode 或快速聊天选择可用的托管模型。模型选择器和仪表板显示当前访问权限。
• 自带密钥：在设置 → Copilot → 自带密钥中添加云端、本地或 OpenAI 兼容提供商。密钥存储在此设备的 Obsidian 密钥链中，而非保管库的 data.json 中。
• Claude 和 Codex 账户：这些代理使用自己的 CLI 登录，而非 Copilot BYOK 设置中的密钥。
• opencode 上报的模型：opencode 会将其路由到后台提供商。免费的 opencode Zen 模型会显示警告，因为该提供商可能会记录或训练提示内容；发送敏感内容前请查阅其条款。

您选择的路由决定了提示词和相关上下文在何处处理。请阅读 LLM Providers 了解设置，以及 Copilot Plus 和 Self-Host 了解隐私和路由详情。

方案

Copilot 插件为开源项目，当您使用自己的代理账户、提供商密钥或本地模型时，无需 Copilot 许可证即可使用。免费使用包括常规单代理 Agent 对话、带 Markdown 上下文的 Projects、自定义 Skills 和 Commands、Quick Chat、Quick Ask 以及本地 Miyo 搜索。

付费访问可包含 Copilot 托管的模型和云端工具。多代理需要有效的 Plus 访问权限；请查看您的仪表板以了解当前权益。模型可用性和服务限制可能会发生变化，因此定价页面和应用内模型选择器是当前的权威信息来源。

深受思考者信赖

“这是第一款真正统一了我在 Obsidian 中搜索、组织和检索知识的方式的工具，让我无需离开即可完成所有操作。我的工作流程变得更快、更深入、更有连贯性。无法想象没有它的日子。” 张Jason，投资者兼研究分析师

“我将会话记录、个人笔记和架构想法存入我的知识库。Copilot 为我提供了一个私人助手，能找到缺失的拼图碎片，并在 live calls 期间主动呈现相关信息，无需手动搜索。” Brad Decker，Concierge Auctions 首席技术官

“自从发现 Copilot 以来，我的写作流程彻底改变了。与自己的文章和想法对话是我几十年来最耳目一新的体验。” Mat QV，专业作家

以上内容基于 GitHub 仓库 README 解析生成，适合先快速了解项目定位、安装方式、核心能力与使用边界。