ARTICLE DETAIL

资讯详情

深耕编程入门与网站建设的一线实战洞察。

Obsidian + Claudian 跑 Vibe Writing Skill:Key 走 TaoToken

Obsidian + Claudian 跑 Vibe Writing Skill:Key 走 TaoToken 把 vibe writing 文件夹放进 ~/.claude/skills回到 Obsidian 里唤起 Claudian输入一个主题结果它先弹认证错误——这个场景比想象中常见。Claudian 本质是在 Obsidian 里驱动 Claude Code CLISkill 装好不等于 Key 配好Vibe Writing 要反复调研、改稿每次都在认证和额度上停一下写作节奏就断了。Key 走 TaoToken先打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 注册并创建 YOUR_API_KEY再把 Claudian 和 Claude Code 的 Base URL 指向 https://taotoken.net/api模型 ID 以模型广场当时列表为准。下面按原文的工具准备和 Vibe Writing 工作流拆开写Obsidian、Claudian、Claude Code CLI 怎么装vibe writing 放在哪Key 和 Base URL 填在哪回 Obsidian 后先让 Claudian 列三个选题做最小验证再进入调研、大纲、初稿、人工 review 和发布。1. 把 vibe writing Skill 放进 ~/.claude/skills 之后Claudian 为什么还卡认证1.1 Obsidian 和 Claudian 装好只完成了“壳”Obsidian 本身是本地 Markdown 编辑器插件体系让它能挂各种侧边栏工具。Claudian 是其中一类把 Claude Code 的对话界面塞进 Obsidian让你不用切到终端直接在笔记库旁边发指令。安装路径和原文一致Obsidian 从官网下载Claudian 从它的 GitHub 仓库或 Obsidian 社区插件市场安装。装完能在侧边栏看到 Claudian 图标打开后有输入框这只能说明“壳”好了不表示底层模型调用通了。Claudian 要干活得本机装好 Claude Code CLI。你可以先在终端里跑一下 Claude Code确认它本身能启动。若终端里 Claude Code 也在要登录、报认证那 Claudian 这边一定跑不通先解决 CLI 的认证再回 Obsidian。很多人卡在这里Obsidian 插件市场里能搜到 Claudian笔记库也能打开但底层 CLI 没装或者没配 Key结果一发消息就报错。1.2 vibe writing 文件夹的层级~/.claude/skills/vibe-writing/SKILL.md原文给的安装路径是“用户/.claude/skills”这个说法在 macOS、Linux 和 Windows 上分别对应~/.claude/skills、/home/你的用户名/.claude/skills、C:\Users\你的用户名\.claude\skills。把 vibe writing 文件夹放进去正确层级是~/.claude/skills/vibe-writing/SKILL.md。常见错误是多套一层~/.claude/skills/vibe-writing/vibe-writing/SKILL.mdClaude Code 扫不到或者放进了 Obsidian 笔记库里的.claude/skills那和用户目录不是一回事。检查时可以打开终端用ls ~/.claude/skills看目录名是不是vibe-writing。Skill 加载成功时Claudian 在对话里会按 Vibe Writing 的流程走比如先问主题、给选题而不是直接吐一大段通用文章。原文提到可以让 Claude 帮你安装 Skill手动放也可以关键是路径要对。若你同时装了多个 Skill目录名不要重名每个 Skill 自己一个文件夹里面放对应的SKILL.md和附属文件。1.3 Vibe Writing 工作流为什么要反复调用模型原文的流程拆得很清楚输入方向或主题Claude Code 帮你细化、写初稿人工 review 后修改发布。中间还夹着调研、大纲、选题方向。每一步都是一次或多次模型调用Vibe Writing 的特点就是“反复改”不像一次性问答。Claudian 底层走 Claude Code CLI默认认证走官方通道时写长文要经历多轮请求认证过期、额度触顶、网络波动都会让流程断掉。断掉之后最烦的是上下文还在但下一次请求发不出去你只能重开对话。把 Key 和 Base URL 统一到 TaoToken 的兼容通道是为了让这套多轮写作链路有一个稳定的入口不是把 Skill 本身替换掉。Skill 仍然是原来那份 vibe writing变化的是底层请求发往哪里。对写作者来说最怕的是写到一半被认证打断先把通道配通再谈选题和文风顺序会更顺。2. 在 TaoToken 创建 YOUR_API_KEY别把 Key 直接写进笔记库2.1 注册后先建 Key再从模型广场抄模型 ID打开 TaoToken 完成注册进入控制台创建 API Key。创建后复制出来先放进密码管理器或本机环境变量不要直接贴在 Obsidian 笔记正文里。笔记库如果开了同步或 GitKey 很容易被一起推走。本文所有配置里的 Key 都写成YOUR_API_KEY你实际填的时候换成刚复制的那串。模型 ID 不要凭印象写回模型广场看当时可用的模型列表复制完整 ID。不同通道的模型命名不完全一样写错最常见的表现是model not found或请求返回一段模型不存在。把 Base URL、Key、模型 ID 三样凑齐再去碰 Claudian 配置。顺序建议是先建 Key再确定模型 ID最后改配置文件。反过来做很容易在配置文件里留下空值或旧值。2.2 Base URL 填 https://taotoken.net/api末尾不要加 /v1这里最容易把“官网”和“接口地址”混掉。注册、创建 Key、看模型广场、看用量走的是给人点的页面填进 Claudian 和 Claude Code 的 Base URL是接口地址。两者不要互换。下面这张对照表建议直接抄进自己的配置笔记用途地址或值注册、创建 Key、模型广场、看用量https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentClaudian / Claude Code 的 Base URLhttps://taotoken.net/apiAPI KeyYOUR_API_KEY从控制台创建模型 ID以模型广场当时列表为准复制完整 IDBase URL 末尾不要加/v1。有些工具默认会在后面拼路径你手动加了/v1请求就多一层表现可能是 404 或找不到接口。也不要在这串接口地址后面拼 UTM 参数UTM 只给浏览器里打开的官网页面用。配置里只认https://taotoken.net/api多一个字符都可能让请求落到错误路径。3. 让 Claudian 读到 Key插件设置与 ~/.claude/settings.json 两处要对齐3.1 Claudian 插件里的 API 配置怎么填在 Obsidian 设置里找到 Claudian 的配置页里面通常有 Claude Code 或 API 相关区域。把 Base URL 填成https://taotoken.net/apiAPI Key 填成YOUR_API_KEY替换后的真实值Model 填从模型广场复制的YOUR_MODEL_ID。如果插件提供“使用 Claude Code 默认配置”之类的开关要确认它不会把这里填的值覆盖掉。保存后重载插件或重启 Obsidian。插件界面里填完只是第一层Claudian 真正启动的是本机 Claude Code CLICLI 还会读它自己的配置文件所以下一节的settings.json也要对。两边都填同一组值排查时才知道哪一层生效。若插件只允许填一个“Claude Code 路径”先保持默认等基础连通后再改。3.2 ~/.claude/settings.json 的 env 兜底配置Claude Code CLI 的配置可以放在~/.claude/settings.json用env字段指定环境变量。下面这份可以直接改成自己的值{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY, ANTHROPIC_MODEL: YOUR_MODEL_ID } }三个字段分别对应接口地址、认证令牌、模型 ID。注意认证字段是ANTHROPIC_AUTH_TOKEN不是ANTHROPIC_API_KEY写错会认证失败。Base URL 保持https://taotoken.net/api不要加/v1。模型 ID 写YOUR_MODEL_ID只是占位真实值去模型广场复制。若你更习惯环境变量也可以在 shell 里 export 同名变量export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKENYOUR_API_KEY export ANTHROPIC_MODELYOUR_MODEL_ID但从桌面图标启动 Obsidian 时图形界面不一定继承终端里的 export。所以更稳的是把配置写进~/.claude/settings.json或者在启动 Obsidian 前从同一个终端打开它。Key 不要提交到 Git笔记库如果做版本管理把.claude或配置文件加入忽略列表。3.3 两处配置谁覆盖谁Claudian 插件设置和~/.claude/settings.json可能同时存在也可能互相覆盖。改完一处没生效先把两处的 Base URL、Key、模型 ID 对齐成同一组值再逐处排查。不要出现插件里填官网落地页、settings.json 里填接口地址这种混搭。若插件有“环境变量”或“自定义 Claude Code 路径”的选项先保持默认等基础连通后再动。排查时可以临时把模型 ID 换成一个确定存在的确认基础链路通了再换回你写作想用的模型。Claudian 的配置改动后最好彻底退出 Obsidian 再打开而不是只关笔记窗口否则后台进程可能还拿着旧配置。4. 回 Obsidian 先让 Claudian 列三个选题验证 Vibe Writing Skill 是否加载4.1 一条最小验证请求只让 Skill 出选题不写正文配置保存后不要直接让它写三千字。先在 Obsidian 里新建一个空笔记唤起 Claudian发一条最小请求“请读取 ~/.claude/skills 下的 vibe writing skill先不要写正文。根据我当前库里的笔记给我三个可以写的选题方向每个方向附一句理由和可能的读者痛点。”这条请求同时验证三件事Claude Code CLI 是否启动、Key 和 Base URL 是否通、Skill 是否被加载。正常返回应该是有结构的三个选题而不是通用寒暄。若它只回“好的我可以帮你写”或者完全不提 Skill说明 Skill 没被读到先回 1.2 检查目录层级。若直接报认证错误跳到第 6 节。4.2 看返回、看 CLI 日志、看控制台用量返回三个选题后再去 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 控制台看用量记录确认这次请求记上了。若 Claudian 界面正常但控制台没有记录可能请求走了另一套配置。CLI 日志方面Claudian 有的版本会提供日志面板没有的话就从终端启动 Obsidian看 Claude Code 的输出。日志里能看到请求地址、模型 ID、返回状态码。把这三点和配置表对齐基本能定位问题。验证通过后再进入完整写作流程不要让验证步骤和长文写作混在一起否则报错时不知道是哪一步断的。建议把“三个选题”这步固定成每次写作前的健康检查花不了一分钟但能省下大量重开对话的时间。5. 走完整 Vibe Writing 链路主题输入、调研、大纲、初稿、人工 review5.1 把资料文件夹一起交给 Claudian比让它自己搜更稳原文步骤一提到已经有调研文档或相关资料可以整理放在一个文件夹下面让 Claude Code 去阅读。这个做法在 Obsidian 里更好落地。你可以在笔记库里建vibe-writing/inputs/把参考文章、访谈记录、数据文件、旧稿都放进去。然后对 Claudian 说“读取 inputs 文件夹里的资料结合 vibe writing skill先输出一份调研摘要列出可用的观点、数据和冲突点不要写正文。”有资料再写比让模型自己搜索更稳。没有资料时Claude Code 也会搜但准确性和时效性以模型当时能力为准重要事实要自己复核。原文还提到语音输入法口述粗略版本这个思路可以保留想到啥说啥转成文字放进 inputs再让 Claudian 整理。5.2 多要两版选题方向别在第一轮就定死原文步骤二里Claude Code 会给出几个选题方向你可以选一个或者让它再规划更多。实操时建议一次要 6 个并让它按“读者痛点、资料充足度、个人经验匹配度”打分。你挑两个进入下一轮分别让它写一段 200 字的大纲预览再决定主攻哪个。这样比一上来就写全文省调用也省你自己改稿的时间。Claudian 在 Obsidian 里的好处是选题、大纲、初稿可以落在不同笔记里版本清楚回滚也方便。每个选题方向单独建一条笔记把 Claudian 的返回贴进去后面写初稿时只打开选定那条上下文不会被其他方向干扰。5.3 调研和大纲阶段的调用怎么省Vibe Writing 的调用量主要堆在调研和反复改稿。可以拆成四段调研摘要、大纲、初稿、润色每段确认后再走下一段。不要把同一份资料重复贴五遍放文件夹让它读。模型 ID 可以选择适合长文和推理的具体以模型广场当时列表为准。若某一步连续失败先检查是不是认证错误而不是盲目重试。重试多了既浪费调用也容易把上下文搅乱。更稳的做法是每段结束让 Claudian 输出一个“下一步待办”你确认后再继续。比如调研摘要后让它列出还缺哪三个事实补完再进大纲。这样每一步都有明确边界不会出现写了一半发现方向不对只能全部重来。5.4 验收与发布人工改稿仍是大头原文步骤四说查看最终成稿哪里有问题可以让 Claude Code 继续修改或者自己手动微调。Claudian 能帮你改句子、补过渡、换标题但事实和观点仍要你自己把关。发布环节按你原来习惯走公众号排版、同步助手都是可选工具。原文附加项提到自动生成配图 Skill结论是效果需要调提示词这个判断保留可以试但别指望一次到位。写作流程跑顺之后Obsidian Claudian 更像一个工作台Vibe Writing Skill 是流程TaoToken 的兼容通道是底下的请求入口。入口稳了你才有精力关注内容本身而不是每次发消息都在猜“这次能不能通”。6. Claudian Vibe Writing Skill 常见报错对照6.1 401 / authentication_errorKey 与 Base URL 的检查顺序先在~/.claude/settings.json里看ANTHROPIC_AUTH_TOKEN是不是等于真实 Key有没有多余空格、换行、引号。再看ANTHROPIC_BASE_URL是不是https://taotoken.net/api不要写成官网落地页也不要加/v1。如果 Claudian 插件里也填了 Key检查两处是否一致。旧 Key 被撤销后插件可能还缓存着旧值重载插件或重启 Obsidian 再试。还有一种情况是只改了插件设置没有改 settings.json或者反过来。Claudian 启动的是 CLICLI 读的是自己的配置所以两处至少有一处要让 CLI 能读到。最稳的是两处一致排查时先看 CLI 终端输出再决定改哪边。6.2 model not found模型 ID 不是自己猜的回模型广场复制完整 ID。不要写gpt-5或带日期后缀的猜测值。若模型 ID 带版本号完整复制。Claudian 插件里的 Model 字段和settings.json里的ANTHROPIC_MODEL要一致。改完模型 ID 后用第 4 节的最小请求再验一次不要直接跑长文。如果插件下拉框里选了一个模型但 settings.json 里还写着另一个实际请求可能以某一层为准。以报错信息里出现的模型 ID 为准去模型广场核对是不是当时可用的那个。6.3 重启 Obsidian 后 Skill 不见了检查 skills 目录层级~/.claude/skills/vibe-writing/SKILL.md是正确层级。若多套一层Claude Code 不加载。Windows 用户注意路径是C:\Users\你的用户名\.claude\skills不是笔记库里的.claude。如果 Skill 文件在但 Claudian 不提检查插件是否用了另一个 Claude Code 配置目录。有些插件允许自定义CLAUDE_CONFIG_DIR如果设过Skill 要放到那个目录下的skills里。Skill 加载失败不会总是报错有时只是 Claude Code 按普通对话回答。所以第 4 节的“三个选题”验证很重要它能让你在写长文之前发现 Skill 没生效。7. 写作流程跑通后去控制台对一下这次调用7.1 用同一把 Key 在模型对话里发一条测试消息配置保存后先在 TaoToken 模型对话 里用同一把 Key 发一条测试消息确认模型 ID 和 Base URL 没填错。若这里正常、Claudian 不正常问题在本地配置或插件缓存若这里也不正常回模型广场核对模型 ID。用同一把 Key 做对照能快速分清是通道问题还是 Obsidian 这边的问题。测试消息不用长一句“请回复当前模型 ID”就够。把返回的模型 ID 和模型广场的列表对一下确认没有写错版本。7.2 长期写稿可以看 Coding PlanKey 和文档在对应页面若要长期用 Claudian 写稿可以打开 Coding Plan 看套餐是否够用Key 在 控制台 API Keys 创建Claude Code 环境变量对照见 接入文档。最后再回 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 看用量是否记上。Obsidian、Claudian、vibe writing Skill 都装好之后真正要维护的只有 Key、Base URL 和模型 ID 这三样别让它们在多个配置文件里各写一份不同的值。
返回列表