用途:Twilio CLI 让你在终端直接管理 Twilio 资源、发送消息、配置 Webhook 并部署无服务器函数,AI 编码代理也可用它开通资源、测试集成而无需写应用代码。
安装:macOS 用 brew tap twilio/brew && brew install twilio;Windows 用 scoop install twilio-cli;npm 用 npm install -g twilio-cli;Linux apt 需先按官方文档配置仓库。更新命令见资料。
认证与配置:twilio login 首次登录并生成本地 API key 配置文件;twilio profiles:create 创建命名配置文件,twilio profiles:list / profiles:use 管理切换;单条命令可用 -p 指定配置文件。凭证优先级为显式 -p/--account-sid 参数 > 环境变量 > 当前配置文件。密码类参数建议用环境变量而非明文。
主要能力:搜索与购买号码(api:core:available-phone-numbers、incoming-phone-numbers)、为号码设置 SMS/Voice Webhook、发送短信(api:core:messages:create)、通过 SendGrid 发送邮件(email:set / email:send,需 SENDGRID_API_KEY)、安装插件扩展功能(serverless、watch、webhook、dev-phone 等)。
用法要点:命令可用空格或冒号分隔;twilio [COMMAND] --help 查看选项;-o json/tsv 控制输出格式,--properties 选列,--limit 覆盖默认 50 条上限;-l debug 开启调试日志。
限制:本地 localhost URL 不能直接用作 Webhook,需自行单独安装 ngrok 等隧道工具;ngrok 未随 CLI 打包。列表默认 50 条、API 超时 30 秒;Windows 无自动补全;twilio email:send 仅用 SendGrid,Twilio Email 需直接用 REST API。区域路由支持 au1/sydney、ie1/dublin、jp1/tokyo,各区域 Auth Token 不同。配置存于 ~/.twilio-cli/config.json。使用命令与代码请保持原样。