尧图网页设计 
手把手在Obsidian里用Claude CodeAgent Client for Obsidian的API Key与账号登录双通道教程【免费下载链接】obsidian-agent-clientBring AI agents into Obsidian via Agent Client Protocol (ACP), such as Claude Code, Codex and Gemini CLI.项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-agent-clientAgent Client for Obsidian是一款把Claude Code等 AI Agent 直接接入 Obsidian 的免费开源插件。本教程手把手带你完成API Key与账号登录两种授权通道配置几分钟后就能在笔记侧边栏和 Claude Code 聊天、让它直接读写你的笔记库。一、为什么用 Agent Client 接入 Claude Code传统用法里你只能在终端和 Claude Code 对话。而 Agent Client 插件基于Agent Client ProtocolACP协议把 Claude Code、Codex、Gemini CLI 等 Agent 变成 Obsidian 的侧边栏成员支持 提及笔记输入模糊搜索笔记直接把内容交给 Agent实时编辑笔记Agent 的修改以词级 diff 显示在聊天里改了什么一目了然权限审批每次操作都可以批准或拒绝安全可控模型与模式切换聊天工具栏里随时切换 Sonnet / Haiku 等模型插件入口和源码结构可参考 README.md 与 src/services/preset-agents.ts。二、准备工作安装插件与 ACP 适配器⏱️ 全程约 5 分钟需要一台桌面电脑macOS / Windows / Linux和 Node.js。1️⃣ 安装插件打开 Obsidian →设置 → 第三方插件 → 浏览搜索Agent Client点击安装并启用确认 Obsidian 版本 ≥ 1.11.4设置 → 通用 → 版本2️⃣ 安装 Claude Code 的 ACP 适配器打开终端执行一条命令npm install -g agentclientplugin/claude-agent-acp注意包名以 官方文档 为准agentclientprotocol/claude-agent-acp。3️⃣ 配置 Agent 路径macOS / Linux 用which claude-agent-acpWindows 用where.exe claude-agent-acp查看路径打开设置 → Agent Client默认命令通常能自动识别找不到时把上面查到的路径填入Claude Code path或点Auto-detect更多细节见 docs/getting-started/index.md。三、通道一API Key 授权按量付费适合没有 Claude 订阅、想按 token 付费的用户。配置步骤前往 Anthropic 控制台在 API Keys 页面创建一枚 Key打开设置 → Agent Client → Preset agents → Claude Code → API key点击 API key 输入框旁的Link...按钮在弹窗中点Add secret...ID 只能用小写字母、数字和连字符例如claude-api-key粘贴你的 API Key点Save链接成功后输入框会显示打码后的密钥随时可用Change按钮更换安全提示Key 存储在 Obsidian 的Keychain设置 → Keychain中绝不是明文。你还能在 Keychain 里重命名、编辑或删除它同一个 ID 的密钥可被多个插件复用。四、通道二账号登录授权用订阅额度如果你有 Claude Pro / Max 订阅不想按量计费可以直接用 Anthropic 账号登录。⚠️前提需要先安装Claude Code CLI由它创建登录会话插件再复用这个会话。配置步骤在终端安装 Claude Code CLImacOS / Linuxcurl -fsSL https://claude.ai/install.sh | bashWindows PowerShellirm https://claude.ai/install.ps1 | iex运行claude按提示完成 Anthropic 账号登录回到 Obsidian设置 → Agent Client中的API key 字段保持为空 常见误区运行 Claude Desktop 桌面应用不能完成登录——必须通过 CLI 登录两者是独立的认证体系。五、双通道怎么选一张表看懂对比项API Key 授权账号登录授权费用方式按 token 用量计费使用订阅内含额度配置难度低插件内粘贴即可中需先装 CLI 并登录适用人群无订阅 / 用量不固定已有 Claude 订阅额度限制无硬上限看余额受订阅套餐限流详细规则见 docs/agent-setup/claude-code.md 与 docs/help/faq.md。六、验证连接发出第一条消息点击左侧边栏的 机器人图标或按Cmd/Ctrl P打开命令面板搜索Open chat view右侧聊天面板打开并显示Claude Code即表示连接成功输入一句话比如总结当前笔记并按回车确认 Agent 正常响应聊天输入框下方的工具栏可以随时切换模式如 Accept Edits和模型Default / Sonnet / Haiku无需退出会话。七、常见问题速查报错原因解决方法Command Not FoundAgent 路径不对点Auto-detect或填完整绝对路径Authentication Required未配置 Key 或未登录API Key 通道重新 Link登录通道先跑一次claudeRate Limit Exceeded请求过快稍等重试并到 Anthropic 控制台查看用量一直显示 Connecting...Node.js 未识别检查Node.js path设置改完重新加载插件完整排查清单见 docs/help/troubleshooting.md。八、写在最后恭喜你已经掌握了 Agent Client for Obsidian 接入 Claude Code 的两种授权方式API Key 按量付费和账号登录用订阅。接下来可以试试用提及笔记、开启多会话对比不同 Agent甚至把 Agent 嵌入笔记里做成一键按钮——把 Claude Code 真正变成你知识库的常驻助手吧 【免费下载链接】obsidian-agent-clientBring AI agents into Obsidian via Agent Client Protocol (ACP), such as Claude Code, Codex and Gemini CLI.项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-agent-client创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 手把手在Obsidian里用Claude Code：Agent Client for Obsidian的API Key与账号登录双通道教程
手把手在Obsidian里用Claude CodeAgent Client for Obsidian的API Key与账号登录双通道教程【免费下载链接】obsidian-agent-clientBring AI agents into Obsidian via Agent Client Protocol (ACP), such as Claude Code, Codex and Gemini CLI.项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-agent-clientAgent Client for Obsidian是一款把Claude Code等 AI Agent 直接接入 Obsidian 的免费开源插件。本教程手把手带你完成API Key与账号登录两种授权通道配置几分钟后就能在笔记侧边栏和 Claude Code 聊天、让它直接读写你的笔记库。一、为什么用 Agent Client 接入 Claude Code传统用法里你只能在终端和 Claude Code 对话。而 Agent Client 插件基于Agent Client ProtocolACP协议把 Claude Code、Codex、Gemini CLI 等 Agent 变成 Obsidian 的侧边栏成员支持 提及笔记输入模糊搜索笔记直接把内容交给 Agent实时编辑笔记Agent 的修改以词级 diff 显示在聊天里改了什么一目了然权限审批每次操作都可以批准或拒绝安全可控模型与模式切换聊天工具栏里随时切换 Sonnet / Haiku 等模型插件入口和源码结构可参考 README.md 与 src/services/preset-agents.ts。二、准备工作安装插件与 ACP 适配器⏱️ 全程约 5 分钟需要一台桌面电脑macOS / Windows / Linux和 Node.js。1️⃣ 安装插件打开 Obsidian →设置 → 第三方插件 → 浏览搜索Agent Client点击安装并启用确认 Obsidian 版本 ≥ 1.11.4设置 → 通用 → 版本2️⃣ 安装 Claude Code 的 ACP 适配器打开终端执行一条命令npm install -g agentclientplugin/claude-agent-acp注意包名以 官方文档 为准agentclientprotocol/claude-agent-acp。3️⃣ 配置 Agent 路径macOS / Linux 用which claude-agent-acpWindows 用where.exe claude-agent-acp查看路径打开设置 → Agent Client默认命令通常能自动识别找不到时把上面查到的路径填入Claude Code path或点Auto-detect更多细节见 docs/getting-started/index.md。三、通道一API Key 授权按量付费适合没有 Claude 订阅、想按 token 付费的用户。配置步骤前往 Anthropic 控制台在 API Keys 页面创建一枚 Key打开设置 → Agent Client → Preset agents → Claude Code → API key点击 API key 输入框旁的Link...按钮在弹窗中点Add secret...ID 只能用小写字母、数字和连字符例如claude-api-key粘贴你的 API Key点Save链接成功后输入框会显示打码后的密钥随时可用Change按钮更换安全提示Key 存储在 Obsidian 的Keychain设置 → Keychain中绝不是明文。你还能在 Keychain 里重命名、编辑或删除它同一个 ID 的密钥可被多个插件复用。四、通道二账号登录授权用订阅额度如果你有 Claude Pro / Max 订阅不想按量计费可以直接用 Anthropic 账号登录。⚠️前提需要先安装Claude Code CLI由它创建登录会话插件再复用这个会话。配置步骤在终端安装 Claude Code CLImacOS / Linuxcurl -fsSL https://claude.ai/install.sh | bashWindows PowerShellirm https://claude.ai/install.ps1 | iex运行claude按提示完成 Anthropic 账号登录回到 Obsidian设置 → Agent Client中的API key 字段保持为空 常见误区运行 Claude Desktop 桌面应用不能完成登录——必须通过 CLI 登录两者是独立的认证体系。五、双通道怎么选一张表看懂对比项API Key 授权账号登录授权费用方式按 token 用量计费使用订阅内含额度配置难度低插件内粘贴即可中需先装 CLI 并登录适用人群无订阅 / 用量不固定已有 Claude 订阅额度限制无硬上限看余额受订阅套餐限流详细规则见 docs/agent-setup/claude-code.md 与 docs/help/faq.md。六、验证连接发出第一条消息点击左侧边栏的 机器人图标或按Cmd/Ctrl P打开命令面板搜索Open chat view右侧聊天面板打开并显示Claude Code即表示连接成功输入一句话比如总结当前笔记并按回车确认 Agent 正常响应聊天输入框下方的工具栏可以随时切换模式如 Accept Edits和模型Default / Sonnet / Haiku无需退出会话。七、常见问题速查报错原因解决方法Command Not FoundAgent 路径不对点Auto-detect或填完整绝对路径Authentication Required未配置 Key 或未登录API Key 通道重新 Link登录通道先跑一次claudeRate Limit Exceeded请求过快稍等重试并到 Anthropic 控制台查看用量一直显示 Connecting...Node.js 未识别检查Node.js path设置改完重新加载插件完整排查清单见 docs/help/troubleshooting.md。八、写在最后恭喜你已经掌握了 Agent Client for Obsidian 接入 Claude Code 的两种授权方式API Key 按量付费和账号登录用订阅。接下来可以试试用提及笔记、开启多会话对比不同 Agent甚至把 Agent 嵌入笔记里做成一键按钮——把 Claude Code 真正变成你知识库的常驻助手吧 【免费下载链接】obsidian-agent-clientBring AI agents into Obsidian via Agent Client Protocol (ACP), such as Claude Code, Codex and Gemini CLI.项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-agent-client创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考