1. 多工具共享记忆文件，为什么 settings 要改到 TaoToken

如果你同时用 Claude Code、OpenCode 这类 AI 编程工具，大概率遇到过同一个麻烦：每个工具都要单独配一遍模型接入信息，记忆文件（也就是用户级别的规则文件）也各写各的，改一处忘一处。我试过把同一套「语言风格 + 核心铁律 + 工作方式」的规则分别塞进两个工具，结果两边字段名不一样、读取路径不一样，维护成本直接翻倍。

这篇要解决的就是这个场景：用一份用户级别的记忆文件，让 Claude Code 和 OpenCode 都能读到同一套行为规则，同时把 settings 里的模型请求统一改到 TaoToken。核心检索词先摆出来——用户级别记忆文件，指的是放在用户主目录下、对该用户所有项目生效的规则文件，不是项目里那份.cursorrules或CLAUDE.md。它能做什么？让工具在每次对话前自动加载你的偏好，比如「始终用简体中文」「不确定就说不确定」「改代码只动必要部分」。适合谁？适合同时开多个 AI 编程工具、又不想每个工具重复调教的开发者。

为什么要把 settings 改到 TaoToken？因为多工具场景下，最痛的不是规则本身，而是每个工具的 Base URL、Key、Model ID 三件套各配各的。统一到一个接入点后，你换模型、查用量、排错都只在一个地方看。下面我会先讲清楚两个工具读记忆文件的路径差异和字段结构，再给可复制的模板，最后演示改到 TaoToken 后怎么验证记忆被读到、请求走通。

需要先说明一点：记忆文件本身不负责发请求，它只是被工具读取的文本规则；真正决定请求走哪里的，是各工具的 settings 配置。这两件事要分开理解，否则你会以为改了记忆文件就能换模型，其实不是。

2. Claude Code 与 OpenCode 读取记忆文件的路径差异与字段结构

先把两个工具的读取逻辑拆开讲，这是后面模板能通用的前提。Claude Code 的用户级记忆文件通常放在用户主目录下，文件名是CLAUDE.md，路径形如~/.claude/CLAUDE.md。它加载的优先级是：项目级./CLAUDE.md覆盖用户级，用户级作为兜底。字段结构上，Claude Code 不要求 YAML frontmatter，纯 Markdown 就能读，标题和列表都会被当作上下文喂给模型。

OpenCode 这边路径不同，它读的是~/.config/opencode/目录下的规则文件，常见命名是AGENTS.md或配置里指定的 instructions 文件。OpenCode 支持在配置文件里用instructions字段显式声明要加载哪些文件，字段结构更偏配置驱动。也就是说，Claude Code 靠约定路径自动读，OpenCode 更依赖你在配置里点名。

这个差异带来的直接后果：你不能只写一份文件然后指望两边都自动认。可行做法是写一份主记忆文件，然后在 OpenCode 的配置里用 instructions 指向它，Claude Code 则通过软链接或直接放置到约定路径。下面用表格对照关键差异。

字段结构上，我建议主记忆文件用统一的分节写法：语言和风格、核心铁律、工作方式、修改代码原则、可信度评分规则、信息不足处理。这几节在 excerpt 里已经给了很好的骨架，我在此基础上补上可复制的完整版。注意「可信度评分规则」这类内容属于行为约束，不是配置项，写进记忆文件即可，不要试图塞进 settings 的 JSON 里，否则工具解析会报错。

还有一个容易踩的坑：两个工具对「用户级」和「项目级」的合并策略不同。Claude Code 是项目级覆盖用户级，OpenCode 在 instructions 里如果同时列了多个文件，是按顺序拼接。所以如果你在项目里也放了规则文件，要确认它不会把用户级的核心铁律冲掉。我的做法是把不可协商的铁律只放用户级，项目级只放项目特有的技术栈约定。

3. 可复制的记忆文件模板与 settings 改写示例

这一节给能直接抄的东西。先给记忆文件模板，路径按你的工具选：Claude Code 放~/.claude/CLAUDE.md，OpenCode 放~/.config/opencode/AGENTS.md，或者放一份主文件再让 OpenCode 的 instructions 指过去。

# 用户级记忆文件 ## 语言和风格 - 始终使用简体中文回复 - 禁止废话，直接回答问题 - 优先使用列表 - 优先使用结构化内容 ## 核心铁律（最高优先级） - 不确定 = 说不确定，不能用「应该 / 大概 / 我觉得」伪装确定结论 - 没有证据 = 不下结论，不编造来源 / 数据 / 链接 / 命令 / 日志 / 配置 / 文件路径 - 能验证则验证，能通过工具 / 文档 / 搜索验证的优先验证，无法验证必须说明原因 - 区分事实 / 推测 / 建议（仅在存在不确定性时） ## 工作方式 执行任务流程： 1. 理解需求 2. 简要说明方案 3. 再开始实现 复杂任务：先给 plan，再执行。 ## 修改代码原则 - 只修改必要部分 - 不随意重构无关代码 - 不改变原有架构 - 保持 diff 最小 ## 可信度评分规则 仅在存在不确定信息 / 推测 / 搜索结果时添加评分。 评分格式： 以上内容可信度评分：X/10 评分对象：… 评分理由：… 扣分项：… 满分路径：… 评分标准： 10：已验证或确定事实 7-9：来自可靠来源但未亲自验证 4-6：部分推测 1-3：高度不确定 ## 信息不足处理 - 必须先提出关键问题 - 不要直接假设需求 - 不要凭空补充业务逻辑

接下来是 settings 改写。Claude Code 的配置在~/.claude/settings.json，OpenCode 的配置在~/.config/opencode/opencode.json（或项目内同名文件）。两个工具都要写全三件套：Base URL、Key、Model ID。Base URL 用https://taotoken.net/api，Key 从控制台生成，Model ID 按你实际要用的模型填。

Claude Code 的~/.claude/settings.json示例：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "你的Key", "ANTHROPIC_MODEL": "你的ModelID" } }

OpenCode 的~/.config/opencode/opencode.json示例，注意 instructions 指向你的记忆文件：

{ "$schema": "https://opencode.ai/config.json", "instructions": ["~/.config/opencode/AGENTS.md"], "provider": { "taotoken": { "npm": "@ai-sdk/openai-compatible", "options": { "baseURL": "https://taotoken.net/api", "apiKey": "你的Key" }, "models": { "你的ModelID": {} } } } }

如果你用的是 Codex 这类读auth.json的工具，三件套同样要写全，Base URL 指向https://taotoken.net/api，Key 和 Model ID 对应填。CC Switch 或 Cline MCP 场景下，也是同样的三件套逻辑，别只填 Key 漏了 Base URL，否则会走到默认端点。

Key 的获取入口在控制台，生成后建议单独存一份，别直接提交到 Git。模型 ID 不确定的话，可以在模型对话页面先确认可用模型名，再回填到配置里。

4. 验证记忆被读取、请求走通的完整过程

配置写完不代表生效，必须验证两件事：记忆文件被加载了，请求确实走了 TaoToken。先说记忆验证。Claude Code 里，你可以在会话中直接问「你现在遵循哪些用户级规则」，如果它复述出「不确定就说不确定」「改代码保持 diff 最小」这些条目，说明~/.claude/CLAUDE.md被读到了。OpenCode 同理，问一句「你的 instructions 来自哪里」，正常会提到你配置里指向的 AGENTS.md 路径。

如果记忆没被读到，先查路径。Claude Code 用ls ~/.claude/CLAUDE.md确认文件存在；OpenCode 用cat ~/.config/opencode/opencode.json确认 instructions 字段拼写和路径没写错。路径里的~有些工具不展开，必要时换成绝对路径/home/你的用户名/.config/opencode/AGENTS.md。

再说请求验证。最直接的方式是发一条会触发工具调用的指令，比如让它读一个本地文件，然后观察是否正常返回。如果返回正常，说明 Base URL 和 Key 通了。更严谨一点，可以在请求后去控制台看用量记录，有对应时间点的调用就说明请求确实走了 TaoToken，而不是被本地缓存或默认端点接走。

验证时我建议按这个顺序：先确认记忆被读到，再确认请求走通。因为如果记忆没读到，你可能会误判成模型接入有问题，其实只是规则文件没加载。反过来，如果记忆读到了但请求报错，那问题就锁定在 settings 的三件套上，排查范围小很多。

一个实测有效的技巧：临时在记忆文件里加一条「每次回复末尾输出当前加载的规则文件路径」，验证完再删掉。这样你能直观看到工具到底读了哪个文件，尤其适合同时配了用户级和项目级规则的场景。

5. 本篇常见报错排查：401、local proxy failed、reading choices、OAuth

配置过程中最常见的几类报错，我按现象和原因对照着列，方便你直接定位。

401 未授权，基本是 Key 的问题。要么 Key 填错、多了空格，要么 Key 已失效。先检查settings.json或opencode.json里的 Key 字段有没有引号包裹、有没有换行符混进去。确认无误后去控制台重新生成一个再试。注意别把 Key 写进记忆文件，记忆文件是给模型看的上下文，不是密钥存储。

local proxy failed，通常出现在工具尝试走本地代理但代理没起来的情况。检查你的环境变量里有没有残留的代理设置，比如HTTP_PROXY、HTTPS_PROXY。如果有，先清掉再启动工具。这类报错和 Base URL 配置无关，是本地网络层的问题，别去改 TaoToken 的地址。

reading choices 报错，多出现在响应体解析阶段，常见原因是 Base URL 指向了不兼容的端点，或者 Model ID 填了一个该端点不支持的模型。确认 Base URL 是https://taotoken.net/api，Model ID 用模型对话页面确认过的名字。如果还报，把请求体里的 model 字段单独打印出来核对。

OAuth 相关报错，一般是你用了需要 OAuth 流程的工具但没走完授权，或者配置里混用了 OAuth 和 API Key 两种模式。用 Key 模式时，确保没有同时开启 OAuth 登录态。CC Switch 这类切换工具如果残留了旧登录信息，清掉再配。

排查顺序建议固定成：先看报错关键词，401 查 Key，proxy 查环境变量，choices 查 Base URL 和 Model ID，OAuth 查登录态。每次只改一个变量，改完立刻重试，避免多个改动叠加导致无法定位。

6. 统一接入后的日常维护与入口

把 settings 改到 TaoToken、记忆文件统一之后，日常维护会轻很多。你只需要维护一份主记忆文件，OpenCode 通过 instructions 引用，Claude Code 通过约定路径读取。换模型时只改 settings 里的 Model ID，不用动记忆文件。查用量、排错、生成新 Key 都在一个控制台完成。

需要生成或轮换 Key 的时候，走 API Keys 入口；配置字段不确定，对照接入文档；想先确认某个模型名可用，去模型对话页面试一句；如果是长期跑编码任务或 Agent 场景，Coding Plan 更合适。这几个入口按你的实际需求选，别只停在首页。

最后留一个我踩过的坑：软链接跨工具共享记忆文件时，Windows 和 macOS 的路径写法不同，Windows 下~展开行为也不一致。跨平台的话，直接在两个工具各自路径放同一份内容，或者用配置里的绝对路径引用，比软链接省心。