1. 为什么我要把 Karpathy LLM Wiki 同时部署到 Cursor 和 ClaudeKarpathy LLM Wiki 是一套用「三层文件夹 大模型自主编译」替代传统 RAG 的知识管理范式适合需要长期沉淀资料、又不想维护向量库的开发者。它的核心思路很朴素原始素材只进不改AI 负责把素材蒸馏成结构化 Markdown 维基后续问答直接复用编译结果而不是每次提问都重新切片检索。我试过把它只放在 Claude 里跑结果日常写代码时切来切去很别扭后来把同一套目录结构接到 Cursor两边共用一份规则文件和同一个 API 通道才真正顺手。这篇要解决的就是「配置一次、两端通用」的问题。很多人卡在两个地方一是以为CLAUDE.md只能给 Claude 用其实它只是给模型的规则手册Cursor 一样能读二是 Cursor 和 Claude 各自要填 Key、填 Base URL配两遍容易乱。下面我会给出可复制的settings.json与config.toml骨架用 TaoToken 做统一 Key 和 API 通道再分别验证 Cursor 与 Claude 两端是否真的生效。全程不需要向量数据库也不需要复杂运维跟着做就能搭起自己的复利式知识库。2. 前置准备TaoToken 统一 Key 与目录骨架2.1 为什么用 TaoToken 做统一通道Cursor 和 Claude 的配置入口不一样一个走 JSON、一个走 TOML如果每个工具单独申请 Key管理成本会随工具数量线性上涨。TaoToken 提供统一的 API 通道一个 Key 可以同时给 Cursor、Claude Code 以及其它兼容 OpenAI 协议的工具使用改一处即可全局生效。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 注意 API 地址不带 UTM 参数配置时直接写裸地址即可。需要先拿到 Key进入控制台创建 API Key建议按用途命名比如llm-wiki-cursor、llm-wiki-claude方便后续排查是哪个工具在消耗额度。Key 只在创建时完整显示一次复制后先存到本地密码管理器不要直接提交进 Git 仓库。2.2 固定三层目录结构两套方案共用同一份目录命名保持一致避免路径写错导致规则失效llm-wiki/ ├── raw/ # 原始素材只读只增不改 ├── wiki/ # AI 维护的结构化知识库 │ └── index.md # 全局总目录由 AI 自动更新 ├── .cursor/ │ └── rules/ │ └── llm-wiki.mdc # Cursor 原生规则 └── CLAUDE.md # 通用规则文件两端共用raw里放 PDF 摘录、网页存档、笔记、论文片段格式不限但建议统一转成纯文本或 Markdown减少模型解析噪声。wiki初始可以为空第一次 Ingest 后会自动生成页面。CLAUDE.md是整套架构的「工作手册」定义权限边界、页面格式和三大工作流Cursor 与 Claude 都读它。2.3 通用规则文件骨架把下面内容存成项目根目录的CLAUDE.md两端共用。重点是权限分层和页面格式写得越具体AI 越不容易乱建页面# LLM Wiki 全局规范Cursor / Claude 通用 ## 角色与权限 你是 AI 知识管理员严格遵守分层权限 1. raw 文件夹仅读取禁止修改、删除、覆盖作为唯一溯源依据 2. wiki 文件夹全权负责新建、修改、规整、更新 3. 所有结论必须可溯源禁止编造无来源内容 ## Wiki 页面标准格式 1. 标题精准概括主题 2. 摘要100 字以内 3. 溯源标注对应 raw 文件路径 4. 正文结构化分层 5. 双向内链[[相关页面名]] 6. 标签领域分类 ## 工作流 ### Ingest 读取 raw 新增素材提炼、去重、合并生成标准页面 添加双向内链更新 wiki/index.md 总目录。 ### Query 优先读取完整 wiki 知识库全局作答高价值问答沉淀为新页面。 ### Lint 遍历全部页面修复失效内链合并重复页面统一格式刷新目录。 ## 硬性约束 1. 无来源不生成结论 2. 优先更新已有页面不随意新建 3. 文件命名简洁规范3. 可复制配置Cursor 与 Claude 双端接入3.1 Cursor 侧settings.json 与规则文件Cursor 的模型配置走settings.json路径在用户目录下的.cursor或项目.cursor中。如果你希望项目级隔离放在项目根目录的.cursor/settings.json如果希望全局生效放在用户级配置里。下面骨架把 Base URL 指向 TaoToken模型名按你实际开通的填写{ cursor.ai.baseUrl: https://taotoken.net/api, cursor.ai.apiKey: sk-你的TaoToken密钥, cursor.ai.model: gpt-4o, cursor.ai.customHeaders: { Content-Type: application/json }, cursor.ai.temperature: 0.2 }temperature建议压到 0.2 左右知识编译任务需要稳定输出太高会导致同一份素材每次生成的页面结构不一致。规则文件放在.cursor/rules/llm-wiki.mdc内容直接复用上面的CLAUDE.mdCursor 打开项目后会自动加载不需要每次对话手动引用。3.2 Claude 侧config.toml 骨架Claude Code 使用config.toml管理模型通道路径通常在~/.claude/config.toml。把 provider 指向 TaoToken 的兼容端点Key 用同一个[provider] name taotoken base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 [model] name claude-3-5-sonnet max_tokens 8192 temperature 0.2 [project] root ./llm-wiki rules_file CLAUDE.mdmax_tokens按你实际套餐调整长文档编译时如果发现输出被截断优先调大这个值而不是把素材拆得更碎。rules_file指向根目录的CLAUDE.mdClaude 启动时会自动读取和 Cursor 共用同一份规则改一处两端同步。3.3 两端共用的三条核心指令Ingest 用于首次搭建或新增素材直接复制执行严格遵循项目内 LLM Wiki 规则读取 raw 文件夹下所有原始素材执行完整 Ingest 1. 提炼核心知识生成标准化 Wiki 页面 2. 完成双向内链关联与分类 3. 更新 wiki/index.md 全局总目录 4. 不修改 raw 原始文件 完成后返回本次新增、修改的页面清单。Query 用于日常问答把问题替换进去即可基于当前 wiki 完整知识库与全局目录严谨回答{你的问题} 若属于高频通用知识点自动沉淀为新 Wiki 页面并更新内链与目录。Lint 建议每周跑一次执行全局 Lint 巡检 1. 修复失效双向内链 2. 合并重复、冗余页面 3. 统一页面格式与标签 4. 更新全局 index 目录 输出完整修改报告。4. 验证请求确认两端真的走通了4.1 用 curl 先验证 Key 与通道在配置编辑器之前先用命令行确认 TaoToken 通道可用避免把网络问题误判成配置问题curl -s https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -d { model: gpt-4o, messages: [{role: user, content: 只回复 ok}], temperature: 0 }返回体里choices[0].message.content出现ok说明 Key 和通道都正常。如果返回 401检查 Key 是否复制完整返回 404检查 Base URL 是否误加了多余路径。4.2 Cursor 端验证动作打开llm-wiki项目在 Composer 里输入「读取 CLAUDE.md告诉我 raw 文件夹当前有几个文件」。如果 Cursor 能正确列出文件数量并复述规则要点说明规则文件和模型通道都已生效。再执行一次 Ingest观察wiki/下是否生成了 Markdown 页面、index.md是否被更新。若页面生成了但内链是空的多半是规则文件没被加载检查.cursor/rules/llm-wiki.mdc是否存在且内容完整。4.3 Claude 端验证动作启动 Claude Code进入项目目录输入「按 CLAUDE.md 规则执行一次 Lint输出修改报告」。正常情况会返回一份扫描结果列出修复的内链和合并的页面。如果 Claude 完全没有提到规则文件检查config.toml里的rules_file路径是否相对于project.root正确。两端都跑通后你可以用同一个 Key 在两边交替操作知识库是同一份不会出现内容分叉。5. 本篇常见错排查5.1 报错 401 Unauthorized最常见原因是 Key 复制时带了空格或换行或者把 Key 写进了会被 Git 追踪的文件后又被截断。先在 curl 里验证再检查settings.json和config.toml里的字符串是否完整。另外注意 TaoToken 的 Key 和某些工具自带的试用 Key 不要混用配置里只保留一个来源。5.2 规则文件不生效Cursor 侧如果.cursor/rules/llm-wiki.mdc存在但 AI 仍不遵守格式检查文件扩展名是否为.mdc以及是否放在了项目根目录的.cursor/rules/下。Claude 侧如果CLAUDE.md没被读取检查config.toml的project.root是否指向了包含该文件的目录。两端都建议在对话开头显式说一句「遵循 CLAUDE.md」作为兜底。5.3 Ingest 输出被截断素材量超过模型单次上下文时页面会生成到一半停住。解决办法不是换模型而是分批入库把raw按主题拆成多个子目录每次只让 AI 处理一个子目录完成后追加下一批。max_tokens也要留足余量编译任务建议不低于 8192。5.4 内链指向不存在的页面Lint 跑完后如果仍有大量[[页面名]]是死链通常是页面命名不统一导致的比如「RAG 原理」和「RAG原理」被当成两个页面。在CLAUDE.md里补一条命名规范要求中文与英文、数字之间统一加空格或不加空格然后重跑一次 Lint 让 AI 合并。5.5 两端内容不一致如果 Cursor 和 Claude 看到的 wiki 内容不同先确认两边指向的是同一个项目目录而不是各自复制了一份。config.toml的project.root和 Cursor 打开的项目路径必须一致。另外每次 Ingest 或 Lint 后建议用 Git 提交一次方便对比差异、回滚误删。6. 长期使用建议与接入入口日常开发学习场景Cursor 方案更顺手因为写代码和查知识库在同一个窗口大批量论文、长文档编译场景Claude 原版方案的长上下文优势更明显。两端共用一份CLAUDE.md和同一个 TaoToken Key配置一次就能长期复用后续新增工具也只需要改通道地址。如果你还在排障阶段建议先去 API Keys 页面确认 Key 状态再对照接入文档检查 Base URL 和请求格式API Keys 在 https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。想先验证模型通道是否正常可以直接用模型对话页面发一条测试消息https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你打算把 LLM Wiki 长期挂在 Cursor 或 Claude Code 里做持续编码和 Agent 任务Coding Plan 更适合按周期使用https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。Claude Code 相关配置可参考 https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后提醒一句raw目录永远只增不改所有迭代都在wiki层完成配合 Git 定期提交你的知识库才会越用越厚而不是越用越乱。