---
title: CLIの使用
url: https://platform.claude.com/docs/ja/cli-sdks-libraries/cli/using
description: ant CLIのコマンド構造、出力形式、GJSON変換、リクエストボディ、およびデバッグについて説明します。
---

このページでは、すべてのエンドポイントに共通する`ant` CLIの入出力の仕組みについて説明します。インストールと認証については、[クイックスタート](https://platform.claude.com/docs/ja/cli-sdks-libraries/cli/quickstart)を参照してください。コマンドの連結やリソースのバージョン管理については、[CLIのスクリプト作成と自動化](https://platform.claude.com/docs/ja/cli-sdks-libraries/cli/scripting)を参照してください。

## コマンド構造

コマンドは`resource action`パターンに従います。ネストされたリソースにはコロンを使用します：

```text wrap
ant <resource>[:<subresource>] <action> [flags]
```

リソースの完全な一覧を表示するには`ant --help`を実行するか、任意のサブコマンドに`--help`を付けてそのフラグを確認してください。

ベータ版のリソース（agents、sessions、deployments、environmentsを含む）は`beta:`プレフィックスの下にあります。この名前空間のコマンドは、そのリソースに適した`anthropic-beta`ヘッダーを自動的に送信するため、自分で渡す必要はありません。`--beta <header>`は、デフォルトを上書きする場合（たとえば、別のスキーマバージョンを選択する場合）にのみ使用してください。

```bash
ant models list
ant messages create --model claude-opus-5-5 --max-tokens 1024 ...
ant beta:agents retrieve --agent-id agent_01...
ant beta:sessions:events list --session-id session_01...
```

### グローバルフラグ

| フラグ                                  | 説明                                                                                                                                                                                                                                                                                                                                                                         |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--profile`                          | この呼び出しで使用する名前付きプロファイル（`ANTHROPIC_PROFILE`を設定するのと同等）。[ワークスペースの切り替え](https://platform.claude.com/docs/ja/cli-sdks-libraries/cli/authentication#switch-between-workspaces)を参照してください。                                                                                                                                                                                          |
| `--api-key-stdin`                    | 標準入力からAPIキーを読み取ります。このフラグは標準入力をすべて読み取るため、リクエストボディは[フラグ](https://platform.claude.com/docs/ja/cli-sdks-libraries/cli/using#flags)で渡してください。                                                                                                                                                                                                                                    |
| `--auth-token-stdin`                 | 標準入力からベアラートークンを読み取ります。このフラグは標準入力をすべて読み取るため、リクエストボディは[フラグ](https://platform.claude.com/docs/ja/cli-sdks-libraries/cli/using#flags)で渡してください。                                                                                                                                                                                                                                 |
| `--format`                           | 出力形式：`auto`、`json`、`jsonl`、`yaml`、`pretty`、`raw`、`explore`                                                                                                                                                                                                                                                                                                                 |
| `--transform`                        | [GJSONパス](https://platform.claude.com/docs/ja/cli-sdks-libraries/cli/using#transform-output-with-gjson)でレスポンスをフィルタリングまたは再構成します                                                                                                                                                                                                                                             |
| `-r`、`--raw-output`                  | `jq -r`のように、文字列の結果を囲む引用符なしで出力します                                                                                                                                                                                                                                                                                                                                           |
| `--base-url`                         | APIのベースURLを上書きします                                                                                                                                                                                                                                                                                                                                                          |
| `--workspace-id`                     | 省略可能。複数のワークスペースにアクセスできるAPIキーの場合に、`anthropic-workspace-id`ヘッダーとして送信するワークスペースID（`wrkspc_...`）（`ANTHROPIC_WORKSPACE_ID`を設定するのと同等）。[ワークスペースの選択](https://platform.claude.com/docs/ja/manage-claude/authentication#select-a-workspace)を参照してください。[Admin API](https://platform.claude.com/docs/ja/manage-claude/admin-api)コマンドは独自の`--workspace-id`を受け取り、代わりにそれらが管理するワークスペースを指定します。 |
| `--debug`                            | HTTPリクエストとレスポンスの全体をstderrに出力します                                                                                                                                                                                                                                                                                                                                            |
| `--format-error`、`--transform-error` | `--format`および`--transform`と同じですが、[エラーレスポンス](https://platform.claude.com/docs/ja/cli-sdks-libraries/cli/scripting#inspect-errors)に適用されます                                                                                                                                                                                                                                    |

## 出力形式

`auto`はJSONを整形して出力し、リソースを作成または変更するコマンドのデフォルトです。listおよびretrieveコマンドは、ターミナルに出力する場合は[インタラクティブエクスプローラー](https://platform.claude.com/docs/ja/cli-sdks-libraries/cli/using#interactive-explorer)がデフォルトとなり、パイプで渡す場合は整形されたJSONがデフォルトとなります。いずれのデフォルトも`--format`で上書きできます：

```bash
ant models retrieve --model-id claude-opus-5-5 --format yaml
```

```yaml Output
type: model
id: claude-opus-5-5
display_name: Claude Opus 5.5
created_at: "2026-09-22T00:00:00Z"
...
```

listエンドポイントは自動的にページネーションを行います。デフォルトの形式では各項目が個別に書き出されるため（`jsonl`モードでは1行に1つのコンパクトなJSONオブジェクト、`yaml`モードではYAMLドキュメントのストリーム）、`head`、`grep`、および`--transform`フィルターにきれいにストリーミングできます。

### インタラクティブエクスプローラー

エクスプローラーは、大きなレスポンスを閲覧するための折りたたみと検索が可能なTUIです。矢印キーでノードを展開・折りたたみ、`/`で検索、`q`で終了します。listおよびretrieveコマンドは、ターミナルに接続されている場合にデフォルトでこれを開きます。明示的に開くには`--format explore`を渡します：

```bash
ant models list --format explore
```

## GJSONによる出力の変換

出力前にレスポンスを再構成するには`--transform`を使用します。式は[GJSONパス](https://github.com/tidwall/gjson/blob/master/SYNTAX.md)です。listエンドポイントでは、変換はエンベロープではなく各項目に対して個別に実行されます：

```bash
ant beta:agents list \
  --transform "{id,name,model}" \
  --format jsonl
```

```jsonl Output
{"id": "agent_011CYm1BLqPX...", "name": "Docs CLI Test Agent", "model": "claude-opus-5-5"}
{"id": "agent_011CYkVwfaEt...", "name": "Coffee Making Assistant", "model": "claude-opus-5-5"}
{"id": "agent_011CYixHhtUP...", "name": "Coding Assistant", "model": "claude-opus-5-5"}
```

### スカラー値の抽出

単一のフィールドを引用符なしの文字列として取得するには（たとえば、新しく作成したリソースのID）、`--transform`と`--raw-output`を組み合わせます。結果はJSONの引用符なしで出力され、そのままシェル変数に代入できます：

```bash
AGENT_ID=$(ant beta:agents create \
  --name "My Agent" \
  --model '{id: claude-opus-5-5}' \
  --transform id --raw-output)
```

<Note>
  `--raw-output`は`--format raw`とは異なります。`--raw-output`は、`jq -r`のように文字列の結果からJSONの引用符を取り除きます。`--format raw`は、自動ページネーションを行わずにレスポンスボディの生のJSONバイトを出力します。listエンドポイントでは、`--transform`を各項目ではなくページネーションのエンベロープに適用します。
</Note>

## リクエストボディの渡し方

適切な入力方法はデータの形状によって異なります。スカラーフィールドや短い構造化された値には**フラグ**を使用し、ネストされたボディや複数行のボディには**stdin**ドキュメントをパイプで渡し、任意の文字列フィールドまたはバイナリフィールドにファイルの内容を取り込むに&#x306F;**`@file`参照**を使用します。

### フラグ

スカラーフィールドはフラグに直接対応します。構造化フィールドは、緩やかなYAML風の構文（引用符なしのキー、文字列の引用符は省略可能）または厳密なJSONを受け付けます：

```bash
ant beta:sessions create \
  --agent '{type: agent, id: agent_011CYm1BLqPXpQRk5khsSXrs, version: 1}' \
  --environment-id env_01595EKxaaTTGwwY3kyXdtbs \
  --title "CLI docs test session"
```

繰り返し可能なフラグは配列を構築します。各`--tool`または`--event`が1つの要素を追加します：

```bash
ant beta:agents create \
  --name "Research Agent" \
  --model '{id: claude-opus-5-5}' \
  --tool '{type: agent_toolset_20260401}' \
  --tool '{type: custom, name: search_docs, input_schema: {type: object, properties: {query: {type: string}}}}'
```

### Stdin

JSONまたはYAMLドキュメントをstdinにパイプで渡すと、リクエストボディ全体を指定できます。stdinからのフィールドはフラグとマージされ、フラグが優先されます。ここで`version`は以前の`retrieve`で返された楽観的ロックのトークンであり、`$AGENT_ID`は[スカラー値の抽出](https://platform.claude.com/docs/ja/cli-sdks-libraries/cli/using#extract-a-scalar)と同様に取得したものです：

```bash
echo '{"description": "Updated test agent.", "version": 1}' | \
  ant beta:agents update --agent-id "$AGENT_ID"
```

ヒアドキュメントも同じように機能し、複数行のYAMLに便利です。ボディ内での変数展開を無効にするには、区切り文字を引用符で囲みます（`<<'YAML'`のように）。

```bash
ant beta:agents create <<'YAML'
name: Research Agent
model: claude-opus-5-5
system: |
  You are a research assistant. Cite sources for every claim.
tools:
  - type: agent_toolset_20260401
YAML
```

### ファイル参照

アップロードコマンドの`--file`のように、ファイルパスを受け取るフラグは、そのままのパスを受け付けます：

```bash
ant files upload --file ./report.pdf
```

ファイルの内容を文字列値のフィールドにインライン化するには、パスの先頭に`@`を付けます：

```bash
ant beta:agents create \
  --name "Researcher" --model '{id: claude-opus-5-5}' \
  --system @./prompts/researcher.txt
```

構造化されたフラグ値の中では、パスを引用符で囲みます。Messages APIにPDFを送信するには：

```bash
ant messages create \
  --model claude-opus-5-5 \
  --max-tokens 1024 \
  --message '{role: user, content: [
    {type: document, source: {type: base64, media_type: application/pdf, data: "@./scan.pdf"}},
    {type: text, text: "Extract the text from this scanned document."}
  ]}'
```

CLIはファイルの種類を検出し、バイナリファイルを自動的にbase64でエンコードします。特定のエンコーディングを強制するには、プレーンテキストには`@file://`を、base64には`@data://`を使用します。先頭のリテラルな`@`はバックスラッシュでエスケープします（`\@username`）。

## デバッグ

任意のコマンドに`--debug`を追加すると、正確なHTTPリクエストとレスポンス（ヘッダーとボディ）がstderrに出力されます。APIキーは伏せ字になります。

```bash
ant --debug beta:agents list
```

```text Output wrap
GET /v1/agents?beta=true HTTP/1.1
Host: api.anthropic.com
Anthropic-Beta: managed-agents-2026-04-01
Anthropic-Version: 2026-10-21
Authorization: Bearer <REDACTED>
...
```

## 利用可能なリソース

CLIが公開するすべてのAPIリソースは、[APIリファレンス](https://platform.claude.com/docs/ja/api/cli/messages/create)に記載されています。ローカルで一覧を表示するには`ant --help`を実行し、任意のサブコマンドに`--help`を付けるとそのフラグとパラメータを確認できます。

## 次のステップ

<CardGroup cols={3}>
  <Card title="CLIのスクリプト作成と自動化" icon="code" href="https://platform.claude.com/docs/ja/cli-sdks-libraries/cli/scripting">
    APIリソースのバージョン管理、スクリプト作成のパターン、Claude Codeからの使用
  </Card>

  <Card title="APIリファレンス" icon="book" href="https://platform.claude.com/docs/ja/api/cli/messages/create">
    エンドポイント固有のパラメータ、リクエストフィールド、レスポンススキーマ
  </Card>

  <Card title="CLIの認証オプション" icon="lock" href="https://platform.claude.com/docs/ja/cli-sdks-libraries/cli/authentication">
    APIキー、ヘッドレスホスト、複数のワークスペース、名前付きプロファイル
  </Card>
</CardGroup>