Claude Code、Codex 中文教程

AI 编程工具和 AI 智能体怎么装、怎么用，新功能是什么，模型怎么选。按工具分组，系列按顺序读。共 114 篇，最近更新于 。

Claude Code83 篇Claude Code 专题

Claude Code 入门到实战系列 · 7 篇 · 约 78 分钟

  1. Claude Code 安装教程：Mac、Windows、Linux 的安装、验证、更新和卸载约 7 分钟

    按官方文档整理的 Claude Code 安装步骤：三种系统各用哪条命令、装完怎么验证、第一次怎么登录、怎么更新和卸载，以及安装时最常见的几个报错是什么意思。

  2. Claude Code 第一个小时：读懂一个陌生仓库，修好并提交第一个 bug约 13 分钟

    装好 Claude Code 之后做什么：本站在一台 Linux 服务器上，用 Express 的源码把三件事实际做了一遍，让它讲清楚项目、找到并修好一个 bug、提交改动。文中是真实的终端输出，以及第一次启动会看到的界面、auto 模式的表现和这一趟花了多少。

  3. CLAUDE.md 怎么写：从 /init 生成，到让 Claude Code 真的照着做约 11 分钟

    CLAUDE.md 是 Claude Code 每次开工都会读的项目说明。本站在 Express 的源码上实测：/init 生成了什么，加三条规矩后它照没照做，按路径生效的规则什么时候加载，AGENTS.md 怎么被读到。并整理了官方对写什么、不写什么、放在哪的说明。

  4. Claude Code 权限模式怎么选：auto、Manual、accept edits、plan，以及改错了怎么退回去约 14 分钟

    Claude Code 能改文件、跑命令，什么时候该先问你，由权限模式决定。本站把几种模式逐个实测了一遍：Shift+Tab 的切换顺序、两种确认框、plan 模式怎么出方案、auto 模式遇到危险动作怎么处理，以及按两下 Esc 能退回什么、退不回什么。

  5. Claude Code 会话和上下文：怎么接着上次干，什么时候该清空，什么时候该压缩约 14 分钟

    Claude Code 的对话存在本机，关掉终端也能接着干。本站实测了 --continue、--resume、给会话起名、/branch 开分支，以及 /clear 和 /compact 前后上下文占用的变化：读了四个文件后消息占 41k，压缩后降到 13.8k，并验证了压缩之后哪些细节还在、哪些没了。

  6. Claude Code 怎么省用量：effort 选哪一档、什么时候换模型、缓存和上下文怎么管约 8 分钟

    根据 Claude Code 团队的三篇官方文章整理：一个任务的花费由什么决定，effort 五个档位各适合什么活，什么时候该换模型，怎么不让缓存白白失效，以及怎么用 /usage 看自己的用量。

  7. 在 VS Code、JetBrains 和桌面应用里用 Claude Code：三种入口怎么装、差在哪、怎么选约 11 分钟

    按 Claude Code 官方文档整理：不想整天待在终端里，还有三个图形入口。VS Code 扩展自带一份命令行；JetBrains 插件不带，要先装命令行；桌面应用什么都不用装，但要订阅。讲清各自怎么装、怎么打开、和命令行比少了什么、配置和会话是不是通用，以及通过中转站用时各自在哪里设置。本站尚未实测。

Claude Code 实战：日常开发任务系列 · 6 篇 · 约 60 分钟

  1. 用 Claude Code 修 bug：从一条报错到带回归测试的修复约 9 分钟

    一个启动就崩的应用，报错出在依赖包里，根因在自己的代码里。本站用同一个 bug 实测了两种问法：把现象、复现办法和做完的标准说清楚，和只说一句“修一下”。两次都修对了，差别在有没有回归测试、改动能不能回退。附一份提 bug 的提示词模板。

  2. 用 Claude Code 给老代码补测试：先找缺口，再让每个测试证明自己有用约 10 分钟

    让 AI 补测试，最怕补出一堆只为凑覆盖率的用例。本站在 Express 的源码上实测了一个两步的做法：先让它找出没测到的代码并按风险排序，再补测试，并要求每个用例都通过“把代码改坏、确认测试会失败”的验证。附真实过程、它自己纠正的一处误判和我们的复核。

  3. 用 Claude Code 做重构和迁移：先在 plan 模式下出计划，再一步一个提交地改约 11 分钟

    重构怕的是改着改着范围失控、改坏了又退不回去。本站在 Express 的源码上实测了一次 var 到 const/let 的迁移：plan 模式下它查出 222 处声明和两处不能直接替换的地方，计划里有一处和源码不符被我们核对出来；执行时一步一个提交。还验证了一点：用命令批量改的文件，回退菜单退不回去，要靠 git。

  4. 提交之前让 Claude Code 先审一遍：/code-review 实测，以及怎么写一份带风险说明的 PR约 9 分钟

    测试全绿不等于没问题。本站在 Express 的源码里放了一处“测试和 lint 都过、但条件写反了”的改动，用本地的 /code-review 审了两轮：第一轮 24 秒查出写反的条件，修完再审，又查出一个要人来定的设计问题。讲清这个命令审什么、怎么用，以及让它起草带风险说明的 PR 描述。

  5. 前端联调：让 Claude Code 自己开浏览器验证改动（Chrome 集成）约 8 分钟

    按 Claude Code 官方文档整理：装上 Claude in Chrome 扩展，Claude Code 就能自己打开页面、点按钮、填表单、读控制台报错，改完前端代码当场验证。讲清怎么开启、站点权限怎么管、常见用法和连不上怎么查。先说一条限制：它要求用 Claude 订阅账号登录，通过中转站用不了。本站尚未实测。

  6. 大仓库和 monorepo 里用 Claude Code：让它只看手上这块代码约 13 分钟

    仓库一大，Claude Code 的上下文容易被无关的约定和文件占满。本站在一个三个包的示例仓库上实测了官方的几样办法：分层的 CLAUDE.md、排除不相干的包、拒绝读第三方代码、追加兄弟目录、稀疏 worktree。要留意：拒绝读取的规则挡不住 grep -r；auto 模式下它会改启动目录以外的文件。

Claude Code 定制：配成你自己的系列 · 11 篇 · 约 113 分钟

  1. Claude Code skills 怎么写：从第一个 skill 到带脚本、带参数的 skill约 8 分钟

    从零写一个 Claude Code skill：建目录、写 SKILL.md、测试；再讲放在哪里、怎么传参数、怎么带脚本和参考文件、怎么控制谁能调用，以及 Claude Code 团队总结的写 skill 的几条经验。

  2. Claude Code Mods 是什么？怎么安装、怎么关闭、安不安全约 7 分钟

    Mods 让你用几行 JavaScript 改写 Claude Code 的行为和界面。本文说明它和 hooks、skills 的区别，怎么安装和关闭，以及安装前要注意的安全问题。

  3. 从零写第一个 Claude Code mod：在输入框上方显示上下文用了多少约 10 分钟

    跟着官方教程的思路，从一个空文件夹写出一个 Claude Code mod：在输入框上方实时显示上下文窗口的占用。讲清目录结构、怎么画界面、数据为什么要放在 $.state、怎么校验和测试、怎么分享。

  4. Claude Code Hooks 实战：改完自动整理格式、拦住不该动的文件、等你批准时发通知约 10 分钟

    Hooks 是你写的 shell 命令，Claude Code 在固定时机一定会执行，不取决于模型愿不愿意。本站实测了三个：改完文件自动跑 eslint --fix，拦下对受保护文件的修改，等待批准时提醒你。附配置、脚本、真实的拦截画面，和它管不到的地方。

  5. Claude Code 接 MCP 服务器实战：接一个现成的，自己写一个，再分享给团队约 11 分钟

    MCP 让 Claude Code 用到内置工具以外的东西：查文档、查工单、查数据库。本站实测了三件事：一条命令接上官方的文档服务器；用三十多行代码写一个自己的服务器并接上；改成项目级配置给团队共用，以及第一次打开时的批准提示。附每一步的真实输出和排错办法。

  6. Claude Code 子代理实战：写一个只读的测试评审员，让写的和查的分开约 11 分钟

    子代理是一份 Markdown 文件：给它一个名字、一段说明、一份工具清单，Claude Code 就能把一类任务交给它在独立的上下文里做。本站实测了一个只读的测试评审员，它查出了上一篇里补的测试的真问题。还试了让子代理换用便宜的模型，并记下通过中转站时遇到过的一条报错。

  7. CLAUDE.md、skill、hook、子代理、MCP、插件：Claude Code 的六种扩展各管什么，先用哪个约 9 分钟

    Claude Code 的扩展方式有六七种，名字相近，容易用错地方。按官方的选型说明整理：每一种解决什么问题、什么信号出现时该加哪一种、相近的几种怎么区分、各占多少上下文。占用的数字用的是本站这个系列实测到的。

  8. 做一个 Claude Code 插件，分享给团队：把 skill、子代理和 hook 打成一包约 11 分钟

    插件是一个带清单文件的目录，把 skill、子代理、hook、MCP 服务器装在一起，可以整包分享和安装。本站把本系列前面做的三样东西打成了一个插件，实测了校验、单次加载、建本地市场、按项目安装和移除。要留意的一个结果：把 skills 目录放错位置，校验照样通过，但 skill 不会加载。

  9. Claude Code 插件进阶（上）：代码智能插件实测，装之前怎么审，不工作怎么查约 11 分钟

    代码智能插件把语言服务器接给 Claude：改完代码自动拿到类型错误，按符号找定义和引用。本站用 TypeScript 实测，连踩三个坑才跑通，并发现第一次编辑的诊断要等到下一步才到。后半篇讲装一个插件之前怎么看清它会在你机器上运行什么，以及卸载之后还留下什么。

  10. Claude Code 插件进阶（下）：给插件写评测，看它占多少上下文，管好依赖、版本和市场约 12 分钟

    插件给团队用起来之后，改一句 skill 的描述都可能让它不再被触发。本站实测了 claude plugin eval：给示例插件写两个用例，带插件和不带插件各跑三遍，12 次运行 27 秒、0.28 美元，直接看出插件贡献了多少。后半篇整理怎么看插件占多少上下文、怎么声明依赖、怎么发版本和托管自己的市场。

  11. Claude Code mod 的测试和排错：不开会话就能跑的测试，以及 mod 没反应时从哪查约 13 分钟

    mod 出了错不会让会话崩掉，它只是被悄悄跳过，看上去像什么都没做。本站用官方教程的示例 mod 实测了两件事：用 claude plugin test 写不开会话、不联网的测试，三个测试 0.67 秒跑完；再把 mod 故意弄坏五种方式，记下静态检查查得出哪几种、哪几种要到运行时才报、报错出现在哪。

Claude Code 设置和界面：把它调顺手系列 · 4 篇 · 约 44 分钟

  1. Claude Code 的设置文件：四个文件各管什么、谁盖过谁、怎么确认生效约 11 分钟

    改了设置没反应，多半是写错了文件，或者被更高一层盖住了。本站实测了项目共享、项目本地和命令行三层的先后，权限规则跨文件合并，哪些值写在项目文件里不生效，以及设置写坏时的表现：多一个逗号整份文件作废，键名拼错则一声不吭。附 ~/.claude 目录里它自己存了哪些数据。

  2. Claude Code 状态栏怎么配：把模型、上下文用量、花费和 git 分支放在输入框下面约 10 分钟

    状态栏是输入框下面的一行，内容由你写的脚本决定。本站实测了从零配一个：先看 Claude Code 实际发来哪些数据，再显示模型、分支、上下文进度条和花费，加一行提示缓存的倒计时。附它什么时候刷新、脚本出错时为什么整行消失、怎么从调试日志里找原因，以及通过中转站用时少了哪些数据。

  3. 把 Claude Code 的终端调顺手：换行、快捷键、提醒、全屏渲染和输出风格约 12 分钟

    Claude Code 默认就能用，但有几处天天碰到的小别扭：想换行却发出去了，跑完了没人提醒，屏幕闪，回答太啰嗦。本站逐项实测了对应的开关：两种不用配置的换行办法、自定义快捷键、全屏渲染、四种内置输出风格和自己写一种。要留意：快捷键写错了不报错，只记在调试日志里。

  4. Claude Code 速查：内置工具、常用命令和环境变量，各挑最用得上的讲约 11 分钟

    官方的工具、命令、环境变量三张参考表加起来五百多项。本站按用途各挑出最常用的一批，并实测了几件容易弄错的事：这台 Linux 上实际只加载了 21 个工具，没有 Glob 和 Grep；Bash 里 export 的变量留不到下一条命令；模型的环境变量盖过设置文件，命令行参数又盖过环境变量。

Claude Code 并行和自动化系列 · 8 篇 · 约 96 分钟

  1. Claude Code 云端会话怎么用：和本地有什么区别、怎么连 GitHub、适合做什么约 8 分钟

    云端会话让 Claude Code 在一台全新的云端虚拟机上干活，合上电脑也不会停，可以同时开好几个。本文说明谁能用、怎么开始、怎么连接 GitHub、适合的七种用法，以及有哪些限制。

  2. Claude Code Projects 是什么、怎么用：让 Claude 替你分派和跟踪一连串任务约 9 分钟

    Projects 是 Claude Code 的新功能，目前对 Pro 和 Max 公测：一个长期的对话里，Claude 把你交代的事拆成一个个并行的云端会话来做，并跟踪每一个的进度。本文说明它适合什么、怎么建、怎么看进度、用量怎么算，以及有哪些限制。

  3. Harness 工程和 Loop 工程是什么：用 Claude Code 和 Opus 5.5 搭一套规则、检查和循环约 20 分钟

    根据 @N01ennn 的长文整理并逐条对照它引用的来源：让模型的产出稳定下来，靠的是提示词外面的三样东西，每次都读的规则文件、必须过关的检查、跑到过关为止的循环。以用代码做动画为例，讲清怎么在 Claude Code 里用 CLAUDE.md、skill、/goal 和 /loop 把它们搭起来。

  4. 用 worktree 同时开两个 Claude Code 会话：各改各的，互不干扰约 8 分钟

    两个 Claude Code 会话同时改同一个仓库，文件会互相覆盖。加一个 --worktree 参数，每个会话就有自己的一份文件和自己的分支。本站实测了两个会话同时改同一个文件：各自提交、互不影响、最后合并无冲突。讲清它从哪个提交开始、依赖怎么办、退出时怎么清理。

  5. Claude Code 代理团队实战：让三个队友互相质疑着审同一段代码约 12 分钟

    代理团队是一项实验功能：一个会话当组长，开出几个各有独立上下文的队友，队友之间能直接互发消息。本站实测了一个三人的评审团队：三个队友互发了 20 条消息，推翻了组长清单里的一条错误结论。也记下了协调上的毛病：有人没等别人的发现就交了报告，行号要组长复核。整个会话估算 1.51 美元。

  6. 把 Claude Code 接进脚本和 CI：claude -p 的输出格式、权限和退出码约 14 分钟

    claude -p 让 Claude Code 不带界面运行，可以放进脚本和 CI。本站实测了管道、JSON 输出、按结构返回、dontAsk 加允许列表、轮数上限和 --bare。要留意：操作被拒绝时退出码仍是 0；--bare 把一次最简单调用的估算花费从 0.14 美元降到 0.008 美元。附验证过的检查脚本。

  7. 用 GitHub Actions 让 Claude Code 审 PR、修 issue：安装、三个工作流和要守住的几条线约 11 分钟

    按 Claude Code 官方文档整理：把 Claude Code 装进 GitHub 仓库的工作流，在 issue 或 PR 里 @claude 就能让它分析、改代码、推提交，也可以开 PR 时自动审查、按计划定时跑。讲清两种安装方式、凭据怎么放、谁能触发、怎么控制花费，文末带 GitLab 的做法。本站尚未实测。

  8. Claude Code 的 agent view：一屏管住多个后台会话，以及让会话之间互相传话约 14 分钟

    手上有几件互不相干的事要交给 Claude Code，不想开一排终端盯着。agent view 把它们变成一张表：谁在干活、谁在等你回答、谁做完了。本站在服务器上实测了派发、回答提问、进入对话、删除会话，以及让一个会话去问另一个会话。通过中转站都能用。

Claude Agent SDK：自己写智能体系列 · 8 篇 · 约 96 分钟

  1. Claude Agent SDK 入门：用 Python 写第一个会自己读代码、改代码的智能体约 12 分钟

    Agent SDK 把 Claude Code 的工具、循环和上下文管理做成了一个库，可以放进你自己的 Python 或 TypeScript 程序。本站从安装开始实测：二十行代码跑通第一个智能体，看清一次运行里收到哪些消息、结果有哪些字段、出错怎么判断。要留意：allowed_tools 不是白名单。

  2. 给 Claude Agent SDK 的智能体加自己的工具：让它查你的数据库、调你的接口约 11 分钟

    内置工具只会读写文件和跑命令。要让智能体查订单、办退款，得把你自己的函数做成工具。本站用 Python 实测了一个只用自定义工具的客服助手：三个工具、七组运行，包括订单号不存在、工具内部抛异常、退款没被批准。两点要留意：没接住的异常会把内部信息带到回答里；去掉内置工具后一次运行只要两分钱。

  3. Claude Agent SDK 的权限、审批和 hooks：它能做什么，由你的程序说了算约 10 分钟

    智能体要改数据、要花钱的时候，放不放行不能只靠模型自己判断。本站用 Python 实测了三种把关的办法：权限模式和规则、让调用停下来等程序批准的审批回调、在工具运行前后插入检查的 hooks。小额退款自动批准、大额拒绝、冻结的订单拦下、每次调用记日志，都跑通了。附一次调用依次要过哪几道关。

  4. Claude Agent SDK 的会话、逐字输出和结构化结果：接着聊、边出边显示、直接拿数据约 12 分钟

    把一次性的问答变成能放进应用的东西，要补三样：记住前面聊过的、文字边生成边显示、返回程序能直接用的数据。本站用 Python 实测了多轮对话、换进程恢复、分支、逐字输出和按 JSON 结构返回，附各自的坑：不给 ID 接着聊可能接错会话，有工具调用时第一个字照样要等。

  5. 把 Claude Agent SDK 的智能体放到服务器上：子进程、上限、记账、隔离和密钥约 17 分钟

    脚本在终端里能跑，放到服务器上给别人用还要多想几件事。本站实测了前半部分：每个会话是一个约 240 MB 的子进程，预算上限会超一点，3 秒的超时实际要 8 秒多才退出，花费怎么记才不重复，目录里的 CLAUDE.md 默认会被读进去。容器、代理和密钥部分整理自官方文档。

  6. Claude Agent SDK 进阶：子代理、skills 和插件，把 Claude Code 里的三样东西用进你的程序约 12 分钟

    子代理、skills、插件这三样在 SDK 里都能用。本站用 Python 逐样实测：三个子代理并行时，一次 query() 先后来了四个结果消息，第一个只是“它们还在跑”；这个小任务上用子代理比主代理自己做慢一倍、贵三倍多；子代理的模型别名在中转站上不一定有。skill 默认就会被发现，插件一行配置加载。

  7. Claude Agent SDK 进阶：工具太多时的工具搜索、把改过的文件退回去、显示任务进度约 10 分钟

    做应用迟早碰到的三件事，本站用 Python 逐样实测。工具搜索通过中转站默认是关的，打开之后如果像前几篇那样写了 tools=[]，它照样不生效，而且没有任何提示。文件检查点能把编辑工具改过的文件退回去，用 Bash 改的退不回来。任务清单在新模型上默认不开，开了它也不一定用，用了轮数是原来的三倍多。

  8. Claude Agent SDK 的 TypeScript 版：把同一个订单助手再写一遍，和 Python 版逐项对照约 12 分钟

    这个系列前面都用 Python。本站把同一个订单助手用 TypeScript 重写并实测：自定义工具、出错处理、审批回调和 hooks、会话、逐字输出、结构化结果。多数只是换个名字，不同的有几处：参数用 Zod 写；没有保持会话的客户端对象；审批回调更省事；env 是整个替换，漏写之后 Bash 里连 ls 都找不到。

Claude API：自己写程序调 Claude系列 · 17 篇 · 约 227 分钟

  1. 第一次直接调 Claude 的接口：从 curl 到 Python，多轮对话、流式、看图，以及通过中转站要改的两处约 9 分钟

    不通过 Claude Code，自己写几行代码直接调模型，要哪些东西、请求和响应长什么样、多轮对话和流式怎么做。本文按官方的入门文档整理，每一步都通过中转站跑过。要改的只有接口地址和 key 两处。另外测到一个新手很容易踩的坑：max_tokens 给 100，回答是空的。

  2. Claude 的 SDK 和命令行：重试和超时到底怎么工作，用 OpenAI 的 SDK 调 Claude，以及官方命令行 ant约 12 分钟

    官方给 Claude 的接口配了七种语言的 SDK、一个命令行和两个兼容层。本文整理各自怎么装、适合谁，并做了实测：对着假服务器看 Python SDK 的重试和超时（碰到带 retry-after 60 的 503，它等了两分钟才报错）；用 OpenAI 的 SDK 调 Claude；通过中转站用官方命令行 ant。

  3. Claude 现在有哪些模型、各多少钱、怎么选：价格表、模型 ID、下线时间和省钱的顺序约 14 分钟

    Fable 5.1、Opus 5.5、Sonnet 5.5、Haiku 5.5 各管什么、官方价是多少、模型 ID 为什么不带日期、哪些老模型快下线了。本文按官方文档整理，并通过中转站实测了几件事：同一个任务在三个模型上差四倍多的钱；同一段中文在新旧模型上 token 数几乎一样，英文却多出近四成。

  4. Claude API 的报错、限流和停止原因：每个状态码和 stop_reason 是什么意思，通过中转站时哪些不一样约 13 分钟

    调 Claude 的接口时，请求没成功是一回事，成功了但回答停得不对是另一回事。本文整理官方的十一个报错状态码、两种限额、七个停止原因和拒答的处理办法，并通过中转站用 Python SDK 把能触发的都触发了一遍：报错的类型名、限流的响应头、停止序列等好几处和官方文档不一样。

  5. Claude 的思考和 effort 怎么调：五档各是什么、什么时候该调高、钱花在哪约 11 分钟

    effort 控制 Claude 在一个回答上下多大功夫，思考只是其中一部分。本文整理五档的含义、各模型的默认值、思考怎么计费、怎么让它多想或少想，以及任务预算和快速模式。实测一道排期题：Sonnet 5.5 在 low 和 medium 上十次全错，调到 high 五次全对；再调到 max 要花三倍多的钱，答案一样。

  6. Claude 的提示缓存怎么用：怎么开、怎么看有没有命中、什么会让它失效，以及通过中转站时要多带的一个字段约 11 分钟

    提示缓存让重复发送的那段开头按十分之一甚至更低的价格计费。本文整理两种开法、响应里三个数字怎么读、哪些改动会让缓存失效、缓存诊断、数 token 和上下文窗口。通过中转站实测：不做处理时十次里只命中一次；请求里带上固定的 metadata.user_id 之后，七次里命中六到七次。

  7. 对话太长了怎么办：Claude 的压缩和上下文编辑，各自什么时候用约 9 分钟

    长对话和跑很久的智能体迟早要处理上下文：要么让服务端把旧的轮次写成摘要（压缩），要么按规则清掉旧的工具结果和思考（上下文编辑）。本文整理两类办法的用法、限制和对缓存的影响。通过中转站实测：上下文编辑能用；两种压缩都用不了，其中一种是参数被悄悄忽略。

  8. 给 Claude 5.5 这一代写提示词：按现象查该改什么，哪些老写法该删约 8 分钟

    老提示词在 Opus 5.5、Sonnet 5.5、Haiku 5.5、Fable 5.1 上基本能直接用，但每个模型有几处行为变了。本文把官方四份指南整理成一张“看到什么现象，改什么”的表，列出该删掉的老写法。实测一道要 JSON 答案的推理题：不思考时模型把推理写进回答里，答案是对的，但整段不再是合法的 JSON。

  9. 给 Claude 应用定标准、建评测、加护栏：一致性、幻觉、提示注入、提示词泄露和延迟约 10 分钟

    用 Claude 做的应用上线之前，怎么知道它够不够好，怎么防它乱说、被带偏、把系统提示说出去、回得太慢。本文整理官方的六页指南，并通过中转站做了五个小实验：十二条的分类评测、文档里没有的问题、邮件里夹带的指令、套系统提示、流式的首字时间。

  10. 把代码升级到 Claude 5.5 这一代要改什么：四个模型的不兼容改动和一份检查清单约 12 分钟

    把模型名换成 Opus 5.5、Sonnet 5.5、Haiku 5.5 或 Fable 5.1，有几处老写法会直接报 400：强制调用工具、关掉思考、预填回答。还有几处不报错但结果变了：回答的第一块可能是空的 thinking，max_tokens 可能被思考用光。本文按官方迁移指南整理，能试的都通过中转站实测过。

  11. Claude API 工具调用入门：定义工具、处理调用、自己写循环约 22 分钟

    让 Claude 调你自己的函数：怎么定义工具、怎么把结果送回去、一次调多个工具怎么处理、出错怎么告诉它，以及 strict、Tool Runner 和流式参数。例子都在服务器上通过中转站跑过，并列出和官方文档不一样的地方。

  12. Claude API 的现成工具：bash、文本编辑器、记忆，以及电脑和浏览器操作约 20 分钟

    跑命令、改文件、跨对话记东西、操作桌面和浏览器，这几类工具 Anthropic 已经定义好，你只负责执行。本文在服务器上用 bash 加文本编辑器搭了一个最小的改代码智能体，并实测记忆工具；电脑和浏览器操作按文档整理。

  13. Claude API 的服务器端工具：联网搜索、抓取网页、代码执行、工具搜索、顾问和 MCP 连接器约 22 分钟

    这几个工具由 Anthropic 的服务器执行，你只管在请求里打开。本文整理各自的用法、计费和限制，以及工具太多时怎么省上下文。通过中转站实测：联网搜索、工具搜索、顾问能用；抓取网页、MCP 连接器被拒，代码执行被悄悄忽略。

  14. 让 Claude 按固定结构输出 JSON、给回答标出处：结构化输出、引用和搜索结果块约 15 分钟

    程序要解析 Claude 的回答，就用结构化输出；要让用户核对回答的依据，就用引用。本文通过中转站实测两者的用法，并记下两个坑：可选字段写在必填字段前面会被漏掉，中文的纯文本文档不会被自动分句。

  15. 给 Claude 看图片和 PDF：token 怎么算、坐标怎么对上，以及文件、批量和向量约 15 分钟

    图片和 PDF 怎么发、各占多少 token、让它返回的坐标怎么对回原图，本文通过中转站逐项实测。Files API、批量处理和向量这三样这家中转站没有开，按官方文档整理用法、限制和价格。

  16. 对话进行到一半要加规矩、换工具：用对话中途的系统消息，不动开头，不丢缓存约 12 分钟

    长对话中途改顶层的 system 或 tools，前面的缓存全部作废。Claude 5.5 这一代可以在消息列表里追加一条 system 消息来加指令、增减工具。通过中转站实测：加指令能用、缓存保住了；按名字增减工具报 400。

  17. 在自己的程序里用 Agent Skills：生成 Excel 和 PPT、上传自己的 skill，以及 Claude Code 自带的 claude-api skill约 12 分钟

    直接调接口也能用 skill，但它跑在 Anthropic 的代码执行容器里，和 Claude Code 里的不是一套。本文按官方文档整理用法、限制和写法；这家中转站用不了这组接口。另在服务器上实测了 Claude Code 自带的 claude-api skill。

Claude Code 开发系列系列 · 8 篇 · 约 58 分钟

  1. Claude Code 的工具是怎么设计的：什么时候加工具，什么时候删工具约 5 分钟

    根据 Claude Code 团队的文章整理：他们怎么决定给模型什么工具。提问工具试了三次才做对，待办清单因为模型变强反而成了束缚，检索从向量库换成让模型自己搜索，以及不加新工具就能加功能的“渐进式披露”。

  2. 提示词缓存为什么这么重要：Claude Code 团队的五条经验约 5 分钟

    根据 Claude Code 团队的文章整理：他们把整个产品围绕提示词缓存来设计。缓存按前缀匹配，所以提示词的顺序、会话中途换模型、增减工具、压缩上下文的做法，都会决定缓存还在不在。讲清这五条经验，以及对使用者和开发者各有什么用。

  3. 让 Claude Code 用 HTML 而不是 Markdown 输出：为什么，以及五种用法约 6 分钟

    根据 Claude Code 团队的文章整理：计划、代码评审、设计稿和报告，为什么让 Claude 写成 HTML 文件比 Markdown 更好读、更好分享，还能做成可以交互的小工具。附五类用法和可以直接改的提示词。

  4. Claude Code 动态工作流怎么用：让 Claude 自己编排一组子代理约 6 分钟

    根据 Claude Code 团队的文章整理：动态工作流让 Claude 为眼前的任务临时写一段编排脚本，调度很多个各有独立上下文的子代理。讲清它解决什么问题、六种常见的编排方式、适合和不适合的场景，以及控制用量、保存和分享的办法。

  5. Claude 5 这一代模型的上下文怎么写：少定规则，多给判断空间约 6 分钟

    根据 Claude Code 团队的文章整理：他们为 Opus 5、Fable 5 删掉了八成以上的系统提示词，编码评测没有可测的下降。讲清六条“以前和现在”的变化，以及 CLAUDE.md、skill 和参考资料现在该怎么写。

  6. 两周把 claude.ai 提速 3 倍：和 Claude 一起做性能优化的方法约 11 分钟

    根据 Anthropic 工程师的文章整理：他们在一个 Slack 频道里和 Claude 协作，两周合并三千多个改动，把 claude.ai 的核心体验提速约 3 倍，没有出过事故。讲清“先找到能数的指标”的思路、每个线程的循环、护栏和人的分工。

  7. 用 Claude Code 自动建评测并逐步提分：build-eval 和 hillclimb 怎么用约 9 分钟

    根据 Claude Code 团队的文章整理：claude-api skill 新增 build-eval 和 hillclimb 两个命令，一个在你的代码库里建评测，一个对着评测一轮改一处地提分。讲清好评测的四个特征、怎么防止过拟合，以及官方的两个例子。

  8. 做一个靠谱的定时智能体：官方“每日简报”参考实现拆解约 10 分钟

    根据 Anthropic 的文章整理：用 Claude Managed Agents 做一个定时读取 Slack 和 GitHub、把要点发到 Slack 的智能体。按来源、去向、代理、定时、记忆、护栏六个部分，讲清每一处常见的失败和官方的六条规则。

单篇14 篇

Codex4 篇Codex 专题

Grok Bot4 篇Grok Bot 专题

Grok Bot 从上手到实战系列 · 4 篇 · 约 68 分钟

  1. Grok Bot 上手十步：从第一个 Bot 到一组会互相交接的 Bot约 11 分钟

    根据 @0xMorlex 的长文整理并对照官方文档核对：Grok Bot 现在会把任务交给 Claude Opus 5.5 这样的外部模型。本文按十个步骤讲怎么建第一个 Bot、写职责说明、连接工具、交接登录、做成定时任务，以及怎么划定必须由你批准的界线。

  2. 用 Grok Bot 做视频：让 AI 写代码渲染成片的八步流程约 19 分钟

    根据 @leo_xiaolei 的长文整理：用 Grok Bot 的云电脑让 AI 写前端代码、逐帧截图、合成视频，不靠文生视频模型。讲清原理、要装的三个 Skill、从选题到成片的八个步骤，以及审片和声音上最容易踩的坑。

  3. 用 Grok Bot 搭一个多 Bot 的动效视频工作室：五个 Bot 分工、渲染队列和审片闭环约 22 分钟

    根据 @0xCarnagee 的长文整理并对照官方文档核对：在 Grok Bot 的云电脑上搭一条做动效视频的流水线。五个 Bot 各管一段，用文件夹里的文件记录进度，一个渲染队列排队出片，独立的审片 Bot 打分，定时任务让它夜里自己跑。

  4. 用 Grok Bot 搭一支做内容的 Bot 队伍：一个入口、五层分工，人只在五处拍板约 16 分钟

    根据 @Jackywxsz 的长文整理并对照官方文档核对：一个人做内容，怎么把找资讯、调研、选题、写稿、配图分给十几个 Grok Bot，自己只跟一个“幕僚长”说话。讲清五层分工、用文件交接的规矩、必须自己拍板的五处，以及添加别人分享的 Bot 之前要知道的事。

DeepSeek Harness9 篇DeepSeek Harness 专题

其他工具14 篇全部工具