Claude Managed Agentsを始める
最初の自律型エージェントを作成します。
このガイドでは、エージェントの作成、環境のセットアップ、セッションの開始、そしてエージェントの応答のストリーミングについて順を追って説明します。
Claude Code
Claude Codeにエージェントをセットアップさせる
/claude-api managed-agents-onboardコアコンセプト
| 概念 | 説明 |
|---|---|
| Agent(エージェント) | モデル、システムプロンプト、ツール、MCPサーバー、およびスキル |
| Environment(環境) | セッションが実行される場所の設定:Anthropicが管理するクラウドサンドボックス、または独自のインフラストラクチャ上のセルフホスト型サンドボックス |
| Session(セッション) | 環境内で実行中のエージェントインスタンス。特定のタスクを実行し、出力を生成します |
| Events(イベント) | アプリケーションとエージェントの間でやり取りされるメッセージ(ユーザーターン、ツール結果、ステータス更新) |
始める前に
Claude Consoleアカウントを作成する
Claude Consoleアカウントにサインアップするか、既存のアカウントにサインインしてください。
認証方法を選択する
ローカル開発では、CLIでログインすることを推奨します。
CLIAPI キー
CLIをインストールする
brew install anthropics/tap/antLinux環境では、リリースバイナリを直接ダウンロードします。
VERSION=2.12.1 OS=$(uname -s | tr '[:upper:]' '[:lower:]') case $(uname -m) in x86_64) ARCH=amd64 ;; aarch64) ARCH=arm64 ;; esac curl -fsSL "https://github.com/anthropics/anthropic-cli/releases/download/v${VERSION}/ant_${VERSION}_${OS}_${ARCH}.tar.gz" \ | sudo tar -xz -C /usr/local/bin antすべてのリリースはGitHubリリースページで確認できます。
go installを使用してソースからCLIをインストールすることもできます。Go 1.26.10以降が必要です。go install github.com/anthropics/anthropic-cli/v2/cmd/ant@latestgo installはバイナリを$(go env GOPATH)/binに配置します。まだ追加されていない場合は、そのディレクトリをPATHに追加してください:export PATH="$PATH:$(go env GOPATH)/bin"ログインする
ant auth loginログインが完了すると、SDKとCLIが認証情報を自動的に取得します。
APIキーを作成する
Claude ConsoleでAPIキーを作成してください。
環境変数を設定する
SDKとCLIは、
ANTHROPIC_API_KEYからキーを読み取ります:export ANTHROPIC_API_KEY="your-api-key-here"
CLIの例を実行するには、CLIをインストールします:
brew install anthropics/tap/antLinux環境では、リリースバイナリを直接ダウンロードします。
VERSION=2.12.1
OS=$(uname -s | tr '[:upper:]' '[:lower:]')
case $(uname -m) in
x86_64) ARCH=amd64 ;;
aarch64) ARCH=arm64 ;;
esac
curl -fsSL "https://github.com/anthropics/anthropic-cli/releases/download/v${VERSION}/ant_${VERSION}_${OS}_${ARCH}.tar.gz" \
| sudo tar -xz -C /usr/local/bin antすべてのリリースはGitHubリリースページで確認できます。
go installを使用してソースからCLIをインストールすることもできます。Go 1.26.10以降が必要です。
go install github.com/anthropics/anthropic-cli/v2/cmd/ant@latestgo installはバイナリを$(go env GOPATH)/binに配置します。まだ追加されていない場合は、そのディレクトリをPATHに追加してください:
export PATH="$PATH:$(go env GOPATH)/bin"SDKをインストールする
pip install anthropic最初のセッションを作成する
エージェントを作成する
モデル、システムプロンプト、利用可能なツールを定義するエージェントを作成します。
CLIant apply coding-assistant.mdcoding-assistant.md--- name: Coding Assistant model: claude-opus-5-5 tools: - type: agent_toolset_20260401 configs: - name: web_search enabled: false - name: web_fetch enabled: false --- You are a helpful coding assistant. Write clean, well-documented code.ant applyはエージェントのIDを出力し、claude-lock.jsonに記録します。作成するすべてのセッションでこれを参照します。agent_toolset_20260401ツールタイプは、事前構築されたエージェントツール(bash、ファイル操作、ウェブ検索など)を有効にします。この例では、このガイドのタスクである短いPythonスクリプトの作成はウェブを使用しないため、ウェブ検索とウェブフェッチを無効にしています。エージェントには必要なツールのみを与えてください。完全なリストとツールごとの設定オプションについては、ツールを参照してください。環境を作成する
環境は、エージェントが実行されるサンドボックスを定義します。この環境では、パッケージマネージャーを許可した
limitedネットワーキングを使用しているため、サンドボックス内で実行されるコードは公開のパッケージレジストリとコードホストにアクセスできます。ウェブ検索とウェブフェッチはサンドボックスの外部で実行されますが、limitedネットワーキングではallowed_hostsリストがこれらにも適用されます。この環境のようにホストが1つもリストされていない場合、これらはページや検索結果を返しません。独自のエージェントでこれらのツールを使用する場合は、必要なホストをそのリストに追加してください。CLIant apply environment.yamlenvironment.yaml# yaml-language-server: $schema=https://platform.claude.com/schemas/ant/beta/environment.json name: quickstart-env config: type: cloud networking: type: limited allow_package_managers: trueant applyは環境のIDもclaude-lock.jsonに記録します。エージェントと環境を1つのコマンドで作成するには、両方のファイルを渡します:ant apply coding-assistant.md environment.yaml。セッションを開始する
エージェントと環境を参照するセッションを作成します。
Pythonsession = client.beta.sessions.create( agent=agent.id, environment_id=environment.id, title="Quickstart session", ) print(f"Session ID: {session.id}")メッセージを送信して応答をストリーミングする
ストリームを開き、ユーザーイベントを送信してから、到着したイベントを処理します:
Pythonwith client.beta.sessions.events.stream(session.id) as stream: # ストリームが開いた後にユーザーメッセージを送信 client.beta.sessions.events.send( session.id, events=[ { "type": "user.message", "content": [ { "type": "text", "text": "Create a Python script that generates the first 20 Fibonacci numbers and saves them to fibonacci.txt", }, ], }, ], ) # ストリーミングイベントを処理 for event in stream: match event.type: case "agent.message": for block in event.content: if block.type == "text": print(block.text, end="") case "agent.tool_use": print(f"\n[Using tool: {event.name}]") case "session.status_idle": print("\n\nAgent finished.") breakエージェントはPythonスクリプトを作成し、サンドボックス内で実行して、出力ファイルが作成されたことを検証します。出力は次のようになります:
I'll create a Python script that generates the first 20 Fibonacci numbers and saves them to a file. [Using tool: write] [Using tool: bash] The script ran successfully. Let me verify the output file. [Using tool: bash] fibonacci.txt contains the first 20 Fibonacci numbers (0 through 4181). Agent finished.
何が起きているのか
ユーザーイベントを送信すると、Claude Managed Agentsは次の処理を行います:
- サンドボックスをプロビジョニングする: 環境設定によって、その構築方法が決まります。
- エージェントループを実行する: Claudeはメッセージに基づいて、どのツールを使用するかを判断します。
- ツールを実行する: ファイルの書き込み、bashコマンド、その他のツール呼び出しはサンドボックス内で実行されます。
- イベントをストリーミングする: エージェントの作業中、リアルタイムの更新を受け取ります。
- アイドル状態になる: エージェントは、それ以上行うことがなくなると
session.status_idleイベントを発行します。
完全なアプリを構築する
以下の各クイックスタートは、Claude Managed Agentsを人気のチャットフレームワークと組み合わせて、完全で実行可能なアプリケーションを作成します。いずれの場合も、フレームワークがチャット画面をレンダリングし、マネージドセッションがサーバー側でエージェントループを実行します。セッションはトランスクリプトを保持し、サンドボックス内でツールを実行し、フロントエンドがレンダリングするイベントをストリーミングします。
VercelのChat SDKで構築されたブラウザチャット内のリサーチアナリストです。各会話は1つの永続的なセッションであり、ライブフィードがツール呼び出しを表示する間に返信をストリーミングします。Chat SDKアダプターを切り替えることで、同じハンドラーをSlack、Teams、Discord、またはWhatsAppに移行できます。
assistant-uiのプリミティブで構築されたチャット内のスプレッドシートアナリストです。セッションがスレッドリストとなり、1つのリデューサーがセッションのイベントログをメッセージとツールカードに変換し、各bashコマンドは実行前にインラインの許可/拒否ゲートをレンダリングします。
CopilotKitチャット内の個人向け財務アシスタントです。Claude Managed Agents用のAG-UIアダプターが各チャットスレッドをマネージドセッションにマッピングし、返信をトークン単位でストリーミングします。また、カスタムツールが会話内にインタラクティブなチャートをインラインでレンダリングします。
次のステップ
再利用可能でバージョン管理されたエージェント設定を作成します
ネットワーキングとサンドボックスの設定をカスタマイズします
エージェントで特定のツールを有効にします
イベントを処理し、実行中のエージェントを誘導します
定期的なcronスケジュールでエージェントを実行します
ドキュメントコーパスを一度ナレッジウィキに凝縮し、そこから繰り返しの質問にわずかなコストで回答します
このページは役に立ちましたか?