Claude Code 可以替您把短信验证接入项目:为它提供 SMS Activate App 的 API 技能(skill),把 API 密钥保存在环境变量中,并审核每一个会花钱的步骤。
按照本指南,大约十分钟即可完成配置。同样的方法也适用于 Codex、Cursor 或任何能读取文件、执行命令的编程智能体。
智能体可以用 API 做什么
有了密钥,编程智能体能做您自己的代码能做的一切:
- 搜索某个国家当前可用的号码,并查看您的价格。
- 购买一个为期 28 天的私人号码,并附带 Idempotency-Key,这样重试时绝不会重复扣费。
- 读取号码收到的短信和来电:自 2026 年 11 月起,简短来电会附带其文字内容以及来电中念出的验证码。
- 释放号码,或关闭其自动续订。
- 设置 webhook,让验证码无需轮询即可送达您的服务器。
适合交给智能体的典型任务:为您的注册流程编写端到端测试、编写在 CI 中等待验证码的辅助函数,或编写带签名校验的 webhook 接收端。
第 1 步:创建密钥,并让它远离代码
- 在注册页面创建账户并充值余额。
- 在账户的「API 密钥」标签页或 Telegram 机器人中创建个人 API 密钥。
- 把密钥放在您的 shell 或项目的密钥存储中,切勿放进智能体会提交的文件里:
密钥会消耗您的余额。Claude Code 在执行命令时读取该变量,无需在对话中看到密钥的值。如果密钥出现在文件、提交记录或日志中,请在账户中将其吊销,并创建一个新密钥。
第 2 步:为 Claude Code 提供技能
本站在 /api-skill.md 发布了面向编程智能体的现成技能文件。文件中列出了基础 URL、路由、限制以及需要处理的错误。将其保存为项目技能:
当任务与技能的描述相符时,Claude Code 会加载该技能,例如「在我的注册测试中等待短信验证码」。如果希望团队共享,请提交该技能文件;其中不包含任何密钥。
您的智能体不支持技能?请打开 API 文档,点击复制智能体提示词的按钮。它把同样的规则放在一段文字中,可以粘贴到任何对话里。
第 3 步:制定项目规则
在项目的 CLAUDE.md 中添加几行,让每次会话都遵守:
第二条规则最重要。号码一经发放,购买即为最终交易且不可退款,因此每次购买发生之前都应由人确认。Claude Code 在执行命令前会请求许可;对于调用购买路由的命令,请保持此项开启。
第 4 步:给它布置任务
请描述您要的结果,而不是具体的 API 调用。例如:
添加一个 pytest fixture:通过 SMS Activate App API 租用一个美国号码,最多等待五分钟接收该号码上的短信,然后返回验证码。多次运行时复用同一个自动续期的号码,而不是每次都购买新号码。
好的结果应当是这样:
- 它用 GET /v1/public/numbers/search?country=US 搜索,并在购买前向您展示号码及其价格。
- 它用 POST /v1/public/numbers 并附带 Idempotency-Key 购买。
- 它每 5 到 15 秒轮询一次 GET /v1/public/numbers/{id}/sms 并设置超时,或者设置 webhook。
- 它把 insufficientbalance、numberunavailable 和 rate_limited 当作正常响应处理,而不是让程序崩溃。
如果它猜测了一个技能中没有的路由,请让它查看 OpenAPI 文件并核对。
第 5 步:合并前审查
在合并智能体编写的代码之前,请检查四点:
- 差异(diff)、测试输出和 CI 日志中都没有密钥。
- 每次购买都发送 Idempotency-Key,重试时复用同一个值。
- 每次等待都设有超时,并有注明号码的清晰失败信息。
- 在一个自动续订的号码就够用时,测试不会每次运行都购买新号码。
需要了解的费用
每个号码按搜索结果显示的价格租用 28 天,开启自动续订时从余额中续费。自 2026 年 11 月起,号码上的来电(按分钟)和短信也从余额中扣费,按国家定价,API 以 usagePricing 返回该价格。在让智能体按计划运行测试套件之前,请先在价格页面查看当前价格。
何时不应使用
该 API 只接收短信和来电,不能发送。请将其用于您自己的应用、账户和测试。号码是否被接受,由您进行验证的平台决定,而不是由我们决定。因此,在基于某个号码搭建流水线之前,请先用目标服务测试该号码:租用前如何检查号码。
后续步骤
- Python 和 curl 的完整流程:用 API 自动完成短信验证。
- 来电验证码与 webhook:通过 webhook 接收短信和来电验证码。
- 参考资料:API 文档、OpenAPI 文件、智能体技能。