CLI 快速入门

ant CLI 让您可以从终端访问 Claude API。每个 API 资源都以子命令的形式提供，并支持输出格式化、响应过滤以及 YAML 或 JSON 文件输入。

与 curl 相比，ant 使用类型化标志或通过管道传入的 YAML 来构建请求体，而不需要手写 JSON，并且可以通过 @path 引用将文件内容内联到字符串字段中。它通过内置的 --transform 查询提取响应字段，因此您不需要 jq 之类的单独工具，而且它会自动对列表端点进行分页。



安装

brew install anthropics/tap/ant

检查安装：

ant --version



身份验证

ant auth login 会打开一个基于浏览器的 OAuth 流程，连接到 Claude Console 并将生成的凭据存储在本地，这样您无需创建或管理 API 密钥即可调用 API。

ant auth login



发送您的第一个请求

安装二进制文件并完成身份验证后，调用 Messages API：

ant messages create \
  --model claude-opus-5 \
  --max-tokens 1024 \
  --message '{role: user, content: "Hello, Claude"}'

{
  "model": "claude-opus-5",
  "id": "msg_01YMmR5XodC5nTqMxLZMKaq6",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Hello! How are you doing today? Is there something I can help you with?"
    }
  ],
  "stop_reason": "end_turn",
  "usage": { "input_tokens": 27, "output_tokens": 20 /*, ... */ }
}

响应是完整的 API 对象，由于 stdout 是终端，因此会以美化格式打印。



Shell 补全

CLI 附带了适用于 bash、zsh、fish 和 PowerShell 的补全脚本。为您的 shell 生成并安装一个：

ant @completion zsh > "${fpath[1]}/_ant"
# 重启您的 shell 或运行：autoload -U compinit && compinit



后续步骤