anthropics/anthropic-cli

ant – 官方 Claude Platform CLI

它是什么

• ant 是 Anthropic 的 Claude Platform 的命令行客户端。它允许您直接从终端调用 Claude API——发送聊天消息、管理代理、会话、文件以及平台提供的任何其他端点。

为什么重要

• 提供了一种轻量级、可脚本化的方式，将 Claude 集成到本地工作流、CI 管道或自动化脚本中，无需针对原始 HTTP API 编写代码。
• 镜像了平台的完整功能集（代理、技能、环境、保险库、部署等），使您可以将 AI 资源视为代码。

安装

• Homebrew (macOS/Linux): brew install anthropics/tap/ant
• Go: go install github.com/anthropics/anthropic-cli/cmd/ant@latest（需要 Go 1.22+）。二进制文件将放在 $(go env GOPATH)/bin 中。

快速开始

1. 使用您的 Claude 控制台账户进行身份验证：ant auth login 或设置 ANTHROPIC_API_KEY。
2. 发送一条快速消息：

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

3. 对于 Google Cloud 托管的工作区，使用 gcloud auth application-default login 登录并导出所需的 ANTHROPIC_GOOGLE_CLOUD_* 变量。

核心命令风格

• 资源以 ant <resource>[:<subresource>] <command> [flags] 的形式寻址。
• 示例：
  • ant models list – 列出可用的 Claude 模型。
  • ant messages create … – 创建聊天补全。
  • ant beta:agents list – 列出测试阶段的代理。
  • ant apply … – 将本地文件与远程资源对齐（见下文）。

将代理和其他资源作为代码管理

• ant apply 读取 Markdown（代理、部署）和 YAML（环境、保险库、技能定义）文件的目录树，然后在 Claude 上创建/更新相应的对象。
• 锁文件（claude-lock.json）记录远程 ID 和版本哈希，支持可重复的部署和安全 CI 运行。
• 文件通过 路径 而非原始 ID 相互引用，使配置可移植且可版本控制。
• 像 --dry-run、--prune、--force 和 --upgrade 等标志提供了对应用更改的细粒度控制。

CI 集成

• README 包含一个 GitHub Actions 工作流，每次推送到 main 时运行 ant apply，使用工作负载身份联合避免存储 API 密钥。成功应用后，它会提交更新后的锁文件。

支持平台

• macOS、Linux、Windows（任何可以运行 Go 二进制的操作系统）。

许可证

• MIT。

总结 ant 将 Claude 强大的 LLM 和代理功能转化为一流的开发工具，让您可以像处理任何其他基础设施一样，对 AI 资源进行脚本化、自动化和版本控制。