Claude Code 的代码检索不靠 RAG，靠 grep。这是 Anthropic 工程师 Boris 在 2025 年 5 月 Latent Space 博客里公开承认的工程决策。

1. 事实层：Boris 公开承认过，Claude Code 早期试过 RAG，发现效果不行就切到了 grep
2. 技术层：三个根本原因——embedding 对代码失效、管线准确率乘性效应、索引时效性漂移
3. 哲学层：无状态设计 + Everything is the model，对应 Bitter Lesson
4. 辩证层：承认 token 成本和概念搜索的局限，业界正走向混合方案

核心结论：代码场景下 RAG 的三个根本缺陷——embedding 对标识符失效、管线乘性准确率、索引时效性漂移——叠加架构哲学上的无状态原则，共同把 Claude Code 推向了 grep。

Chrome DevTools MCP 特点是让 AI 编码助手直接接管 Chrome，复用登录态 + 拿到原生 DevTools 数据。

1. 定位：基于 Puppeteer 的 MCP 服务器，暴露 26+ 工具给 AI（点击、填表、截图、性能 trace、网络请求）。
2. 核心优势：无需重新登录，可直连你当前 Chrome 会话；AI 能调起完整 DevTools 面板。
3. 三种连接模式：默认独立实例 / --autoConnect 复用会话 / --browser-url 远程调试端口。
4. 关键陷阱：远程调试端口无鉴权，同机任何应用都能连；MCP 客户端可读浏览器全部数据。

Claude Code 的所有配置都遵循同一套三层作用域规则。

1. User：存在 ~/.claude/，仅本机生效但跨项目共享
2. Project：存在 .claude/，通过 git 同步给所有团队成员
3. Local：存在 .claude/settings.local.json，git 忽略，仅本机生效

优先级：Local > Project > User。所有层级的配置都会加载，相同 key 时高优先级覆盖。

核心原则：越私有、越具体的配置，优先级越高。

实操：团队规范走 Project，个人偏好走 User，本机调试/密钥走 Local。

多个维度（Instructions / Skills / Commands / Agents / Hooks / Rules / MCP / 配置文件）逐项拆解

• 直接读：skills 文件内容基本上能得到三家互认。
• 搬目录：commands / agents 从 .claude/ 复制到 .opencode/，内容通常能复用。
• 要重写：hooks（配置 vs JS/TS 模块）/ config（JSON vs TOML）范式不同。
• 软链共享：用 .shared/ + 软链把 skills / AGENTS.md 做成单一源；其他目录格式 / 范式不同，必须独立维护。
• Skills 互认：遵循 Agent Skills 开放标准，最低 SKILL.md 可直接迁移。

omo 是 OpenCode 最值得装的增强套件，专为复杂代码库设计。把单代理的原生 OpenCode 升级为多代理、多 MCP 的 AI 编程团队。

1. 定位：插件层，不改 OpenCode 命令体系
2. 规模：11 个 agents + 54+ hooks + 5 MCPs
3. 王牌命令：ultrawork，一个词启动全部代理
4. Team Mode（v4.0）：主代理 + 8 个并行成员，tmux 可视化
5. 热度：62k+ stars，Anthropic 曾因此封禁 OpenCode

OpenCode 是当前最值得认真看的一款开源 AI 编程 Agent。

1. 定位：100% 开源的 AI 编程终端，跟 Claude Code、Codex CLI 同台对位
2. 双主代理：内置 build（写）和 plan（只读），Tab 键切换
3. 子代理机制：复杂搜索 / 多步任务交给 @general 子代理
4. 多端入口：终端、桌面 App、IDE 插件一套命令通吃
5. 选型结论：想换模型就选 OpenCode，锁定 Claude 就用 Claude Code

OpenCode 的配置和 1M 上下文模型是两个最容易踩坑的地方——一个是 schema 字段没文档，一个是变体名写错直接走默认。

1. 两份 JSON Schema：opencode.json / opencode.jsonc 主配置 + tui.json TUI 专属，schema URL 是 opencode.ai/config.json。
2. 1M 模型写法：model ID 后面挂 [1m] 后缀，比如 anthropic/claude-sonnet-4-6[1m]，Anthropic 官方约定。
3. TUI 显示百分比自动归一化：换 1M 模型后同样的 token 数，百分比变成原来的 1/5，不用额外配。
4. Provider 实际限制：qwen3.7-plus 在 OpenCode 上硬卡 200k（issue #30838），即使模型标称 1M。
5. 计费警告：1M 上下文分段计费——200k 之内一个价，200k 以上另一个价（贵几倍）。

OpenCode 里两个最高频的快捷语法——@path 拉文件、!cmd 跑 shell。看着简单，踩坑的姿势不少。

1. @ 引用文件：@src/components/Button.tsx 自动把文件读进上下文，比手动复制路径再让 OpenCode 读快得多。
2. ! 调用 Shell：!ls -la src/ 在 OpenCode 里直接跑命令，输出回传到对话里。
3. 大文件踩坑：引用 >500 行的文件会爆 token，先 head / Grep -n 截取 再 @。
4. 高频用法：!pnpm test 看测试输出、!git status 看状态、!ps aux | grep node 查进程。
5. 核心区别：@ 是"读进来作为上下文"，! 是"执行命令拿到结果"——前者进了历史，后者也是。

OpenCode 命令体系 纯 markdown 驱动，工作流可沉淀成可复用命令——零代码扩展，迁过来上手成本低。

1. 核心命令 4 条：/init / /compact / /clear / /undo，覆盖会话生命周期。
2. 自定义命令：.opencode/command/*.md 放 markdown 即生效，业务团队也能贡献。
3. 高频工作流：新项目 /init → 改 AGENTS.md → 写专属命令；改 Bug 走 /undo 兜底。
4. 更新机制：默认启动自检；手动 opencode upgrade，跨大版本前看 CHANGELOG。
5. 选型标准：多 provider 切选 OpenCode，只用 Claude 选 Claude Code。

OpenCode 的 sub-agent 机制和 Claude Code 不太一样——sub-agent 是 primary agent 派出去的临时会话，通过 @ 触发，跑起来后开 child session，主对话窗口原地不动。

1. 触发方式：@explore / @scout / @general 派 sub-agent 干活，主对话窗口不动。
2. 内置三类 sub-agent：Explore（只读扫代码）、Scout（只读研究外部）、General（通用可并行）。
3. 跳转快捷键：<Leader>+down 进 child session，up 回 parent，<Leader>+l 看所有 session。
4. 关键约束：sub-agent 上下文独立，主对话讨论过的约束必须显式写在 @ 任务里，否则按通用默认来。
5. 多层嵌套：sub-agent 又调 sub-agent 就多按几下 up 往上爬。