标签：入门

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

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

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

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

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

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

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

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

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

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

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

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

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

根据 @xilo2991 的长文整理并核对了案例原帖、skill 仓库和官方文档：Opus 5.5 不会生成视频，它写代码把画面一帧帧画出来。讲清七类代码方案各适合什么画面、五个公开案例怎么组合、七块结构的提示词怎么写，以及让出片更稳的 CLAUDE.md 和自查办法。

按 DeepSeek Harness 官方文档整理：它是 DeepSeek 开源的智能体框架，可以下载桌面应用，也可以用一条 npx 命令启动网页界面。讲清两种用法怎么选、第一次启动的欢迎窗口、配置模型、选工作区、发第一个任务，以及“开发者预览”意味着什么。

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

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

OpenAI 在 10 月 9 日开放了在 ChatGPT 手机应用里创建 Dots。Dots 是一个常驻的智能体，有自己的云端电脑，在两次对话之间持续跟进你交给它的事。本文说明它是什么、哪些套餐和地区能用、怎么创建，以及这次更新了什么。

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

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

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

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

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

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

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