CLI、SDK 和库ant CLI

CLI 快速入门

安装 ant 命令行工具，完成身份验证，并向 Claude API 发送您的第一个请求。

ant CLI 让您可以从终端访问 Claude API。每个 API 资源都作为子命令公开，并提供输出格式化、响应过滤以及对 YAML 或 JSON 文件输入的支持，使其既适用于交互式探索，也适用于自动化场景。

与使用 curl 调用 API 相比，ant 允许您通过类型化标志或管道传入的 YAML 构建请求体，而无需手写 JSON；可以使用 @path 引用将文件内容内联到字符串字段中；还可以通过内置的 --transform 查询从响应中提取字段（无需额外的 JSON 处理工具）。列表端点会自动分页。Claude Code 原生支持 ant。

有关特定端点的参数和响应架构，请参阅 API 参考。本页面旨在帮助您运行第一个可用的命令。有关 CLI 的其他所有功能，请参阅使用 CLI 和 CLI 脚本编写与自动化。

安装

检查安装是否成功：

ant --version

身份验证

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

CLI

ant auth login

有关其他身份验证方式（API 密钥环境变量、无头主机、多个工作区、命名配置文件以及 Workload Identity Federation），请参阅 CLI 身份验证选项。

发送您的第一个请求

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

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

Output

{
  "model": "claude-opus-4-8",
  "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 生成并安装相应的脚本：

后续步骤

CLI 身份验证选项：API 密钥、无头主机、多个工作区和命名配置文件
使用 CLI：命令结构、输出格式、GJSON 转换和请求体
CLI 脚本编写与自动化：对 API 资源进行版本控制、脚本编写模式以及在 Claude Code 中使用

Was this page helpful?

CLI、SDK 和库ant CLI

CLI 快速入门

安装 ant 命令行工具，完成身份验证，并向 Claude API 发送您的第一个请求。

安装

检查安装是否成功：

ant --version

身份验证

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

CLI

ant auth login

有关其他身份验证方式（API 密钥环境变量、无头主机、多个工作区、命名配置文件以及 Workload Identity Federation），请参阅 CLI 身份验证选项。

发送您的第一个请求

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

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

Output

{
  "model": "claude-opus-4-8",
  "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 生成并安装相应的脚本：

后续步骤

CLI 身份验证选项：API 密钥、无头主机、多个工作区和命名配置文件
使用 CLI：命令结构、输出格式、GJSON 转换和请求体
CLI 脚本编写与自动化：对 API 资源进行版本控制、脚本编写模式以及在 Claude Code 中使用

Was this page helpful?