CLI、SDK、ライブラリant CLI

CLIスクリプティングと自動化

APIリソースをYAMLとしてバージョン管理し、スクリプト内でant CLIコマンドを連結し、Claude Codeからリソースを操作します。

このページでは、ant CLIを基盤としたタスク指向のワークフローについて説明します。基礎となるフラグや出力オプションについては、CLIの使用を参照してください。

APIリソースのバージョン管理

CLIを使用して、スキル、エージェント、環境、デプロイメントなどのAPIリソースをリポジトリ内のYAMLファイルとしてバージョン管理し、Claude APIと同期させることができます。

これらのリソースの詳細については、Managed Agentsを参照してください。

エージェントを定義する

エージェント定義をsummarizer.agent.yamlに書き込みます。

summarizer.agent.yaml

name: Summarizer
model: claude-sonnet-4-6
system: |
  You are a helpful assistant that writes concise summaries.
tools:
  - type: agent_toolset_20260401

エージェントを作成する
ant beta:agents create < summarizer.agent.yaml
Output
{ "id": "agent_011CYm1BLqPXpQRk5khsSXrs", "version": 1, "name": "Summarizer", "model": "claude-sonnet-4-6" /* ... */ }
レスポンスのidをメモしておいてください。後のステップでセッション作成コマンドに渡します。
summarizer.agent.yamlをリポジトリにチェックインし、CIパイプラインでAPIと同期させてください。更新コマンドには、エージェントIDと現在のバージョンをフラグとして指定する必要があります。
CLI
ant beta:agents update --agent-id agent_011CYm1BLqPXpQRk5khsSXrs --version 1 < summarizer.agent.yaml
環境を定義する
セッションは環境内で実行され、環境はセッションが実行されるサンドボックスを定義します。環境定義をsummarizer.environment.yamlに書き込みます。
summarizer.environment.yaml
name: summarizer-env config: type: cloud networking: type: unrestricted
環境を作成する
ant beta:environments create < summarizer.environment.yaml
Output
{ "id": "env_01595EKxaaTTGwwY3kyXdtbs", "name": "summarizer-env" /* ... */ }
レスポンスのidをメモしておいてください。後のステップでセッション作成コマンドに渡します。
summarizer.environment.yamlをリポジトリにチェックインし、CIパイプラインでAPIと同期させてください。更新コマンドには、環境IDをフラグとして指定する必要があります。
CLI
ant beta:environments update --environment-id env_01595EKxaaTTGwwY3kyXdtbs < summarizer.environment.yaml

セッションを開始する

前の出力からエージェントのidと環境のidをセッション作成コマンドに貼り付けます。

ant beta:sessions create \
  --agent agent_011CYm1BLqPXpQRk5khsSXrs \
  --environment-id env_01595EKxaaTTGwwY3kyXdtbs \
  --title "Summarization task"

Output

{
  "id": "session_01JZCh78XvmxJjiXVy3oSi7K",
  "status": "running"
  /* ... */
}

ユーザーメッセージを送信する

前の出力からセッションのidを--session-idにコピーします。

ant beta:sessions:events send \
  --session-id session_01JZCh78XvmxJjiXVy3oSi7K \
  --event '{type: user.message, content: [{type: text, text: "Summarize the benefits of type safety in one sentence."}]}'

会話を読み取る
--transformはリストされた各イベントに対して実行されるため、これによりすべてのメッセージのテキストが順番に出力されます。--format autoは、リストコマンドがターミナルでデフォルトで開くインタラクティブエクスプローラーを上書きします。
ant beta:sessions:events list \ --session-id session_01JZCh78XvmxJjiXVy3oSi7K \ --transform 'content.0.text' --format auto --raw-output
Output
```
Summarize the benefits of type safety in one sentence.
Type safety catches errors at compile time rather than runtime, reducing bugs, improving code clarity, enabling better tooling support, and making codebases easier to maintain and refactor with confidence.
```
セッションの実行中にリアルタイムで監視するには、ant beta:sessions:events stream --session-id session_01JZCh78XvmxJjiXVy3oSi7Kを使用します。イベントは到着するたびにstdoutに書き込まれます。

スクリプティングパターン

CLIは標準的なシェルツールと組み合わせて使用できるように設計されています。

リスト出力を次のコマンドに連結する

リストエンドポイントで--transform id --raw-outputを使用すると、1行に1つの生のIDが出力されるため、headやxargsなどの標準ツールを直接適用できます。最初の結果を取得し、それを後続のコマンドに渡します。

FIRST_AGENT=$(ant beta:agents list \
  --transform id --raw-output | head -1)

ant beta:agents:versions list \
  --agent-id "$FIRST_AGENT" \
  --transform "{version,created_at}" --format jsonl

エラーを検査する

--transform-errorフラグと--format-errorフラグは、エラーレスポンスに同じフィルタリングを適用します。--raw-outputはエラーには適用されないため、引用符なしのスカラー値を得るには--format-error yamlを使用します。エラーメッセージのみを抽出します。

ant beta:agents retrieve --agent-id bogus \
  --transform-error error.message --format-error yaml 2>&1

Output

GET "https://api.anthropic.com/v1/agents/bogus?beta=true": 404 Not Found
Agent not found.

Claude CodeからCLIを使用する

Claude Codeは、そのままでant CLIを使用できます。CLIがインストールされ認証されていれば、Claude CodeにAPIリソースを直接操作するよう依頼できます。例えば、次のように依頼できます。

「最近のエージェントセッションを一覧表示し、エラーが発生したものを要約してください。」
「./reports内のすべてのPDFをFiles APIにアップロードし、結果のIDを出力してください。」
「セッションsession_01...のイベントを取得し、エージェントがどこで行き詰まったか教えてください。」

Claude Codeはantをシェル経由で実行し、構造化された出力を解析し、その結果に基づいて推論します（カスタム統合コードは不要です）。

Was this page helpful?

CLI、SDK、ライブラリant CLI

CLIスクリプティングと自動化

APIリソースをYAMLとしてバージョン管理し、スクリプト内でant CLIコマンドを連結し、Claude Codeからリソースを操作します。

APIリソースのバージョン管理

これらのリソースの詳細については、Managed Agentsを参照してください。

エージェントを定義する

エージェント定義をsummarizer.agent.yamlに書き込みます。

summarizer.agent.yaml

name: Summarizer
model: claude-sonnet-4-6
system: |
  You are a helpful assistant that writes concise summaries.
tools:
  - type: agent_toolset_20260401

エージェントを作成する
ant beta:agents create < summarizer.agent.yaml
Output
{ "id": "agent_011CYm1BLqPXpQRk5khsSXrs", "version": 1, "name": "Summarizer", "model": "claude-sonnet-4-6" /* ... */ }
レスポンスのidをメモしておいてください。後のステップでセッション作成コマンドに渡します。
summarizer.agent.yamlをリポジトリにチェックインし、CIパイプラインでAPIと同期させてください。更新コマンドには、エージェントIDと現在のバージョンをフラグとして指定する必要があります。
CLI
ant beta:agents update --agent-id agent_011CYm1BLqPXpQRk5khsSXrs --version 1 < summarizer.agent.yaml
環境を定義する
セッションは環境内で実行され、環境はセッションが実行されるサンドボックスを定義します。環境定義をsummarizer.environment.yamlに書き込みます。
summarizer.environment.yaml
name: summarizer-env config: type: cloud networking: type: unrestricted
環境を作成する
ant beta:environments create < summarizer.environment.yaml
Output
{ "id": "env_01595EKxaaTTGwwY3kyXdtbs", "name": "summarizer-env" /* ... */ }
レスポンスのidをメモしておいてください。後のステップでセッション作成コマンドに渡します。
summarizer.environment.yamlをリポジトリにチェックインし、CIパイプラインでAPIと同期させてください。更新コマンドには、環境IDをフラグとして指定する必要があります。
CLI
ant beta:environments update --environment-id env_01595EKxaaTTGwwY3kyXdtbs < summarizer.environment.yaml

セッションを開始する

前の出力からエージェントのidと環境のidをセッション作成コマンドに貼り付けます。

ant beta:sessions create \
  --agent agent_011CYm1BLqPXpQRk5khsSXrs \
  --environment-id env_01595EKxaaTTGwwY3kyXdtbs \
  --title "Summarization task"

Output

{
  "id": "session_01JZCh78XvmxJjiXVy3oSi7K",
  "status": "running"
  /* ... */
}

ユーザーメッセージを送信する

前の出力からセッションのidを--session-idにコピーします。

ant beta:sessions:events send \
  --session-id session_01JZCh78XvmxJjiXVy3oSi7K \
  --event '{type: user.message, content: [{type: text, text: "Summarize the benefits of type safety in one sentence."}]}'

会話を読み取る
--transformはリストされた各イベントに対して実行されるため、これによりすべてのメッセージのテキストが順番に出力されます。--format autoは、リストコマンドがターミナルでデフォルトで開くインタラクティブエクスプローラーを上書きします。
ant beta:sessions:events list \ --session-id session_01JZCh78XvmxJjiXVy3oSi7K \ --transform 'content.0.text' --format auto --raw-output
Output
```
Summarize the benefits of type safety in one sentence.
Type safety catches errors at compile time rather than runtime, reducing bugs, improving code clarity, enabling better tooling support, and making codebases easier to maintain and refactor with confidence.
```
セッションの実行中にリアルタイムで監視するには、ant beta:sessions:events stream --session-id session_01JZCh78XvmxJjiXVy3oSi7Kを使用します。イベントは到着するたびにstdoutに書き込まれます。

スクリプティングパターン

CLIは標準的なシェルツールと組み合わせて使用できるように設計されています。

リスト出力を次のコマンドに連結する

FIRST_AGENT=$(ant beta:agents list \
  --transform id --raw-output | head -1)

ant beta:agents:versions list \
  --agent-id "$FIRST_AGENT" \
  --transform "{version,created_at}" --format jsonl

エラーを検査する

ant beta:agents retrieve --agent-id bogus \
  --transform-error error.message --format-error yaml 2>&1

Output

GET "https://api.anthropic.com/v1/agents/bogus?beta=true": 404 Not Found
Agent not found.

Claude CodeからCLIを使用する

「最近のエージェントセッションを一覧表示し、エラーが発生したものを要約してください。」
「./reports内のすべてのPDFをFiles APIにアップロードし、結果のIDを出力してください。」
「セッションsession_01...のイベントを取得し、エージェントがどこで行き詰まったか教えてください。」

Claude Codeはantをシェル経由で実行し、構造化された出力を解析し、その結果に基づいて推論します（カスタム統合コードは不要です）。

Was this page helpful?