Claude Managed Agentsを使い始める

このガイドでは、エージェントの作成、環境のセットアップ、セッションの開始、エージェントの応答のストリーミングについて順を追って説明します。

コアコンセプト

前提条件

• Claude Consoleアカウント
• APIキー

CLIをインストールする

brew install anthropics/tap/ant

インストールを確認します。

ant --version

SDKをインストールする

pip install anthropic

APIキーを環境変数として設定します。

export ANTHROPIC_API_KEY="your-api-key-here"

最初のセッションを作成する

1. 1

   エージェントを作成する

   モデル、システムプロンプト、利用可能なツールを定義するエージェントを作成します。

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   

   ant apply coding-assistant.md

   coding-assistant.md

   

   ---
   name: Coding Assistant
   model: claude-opus-5
   tools:
     - type: agent_toolset_20260401
   ---
   
   You are a helpful coding assistant. Write clean, well-documented code.

   agent_toolset_20260401 ツールタイプは、事前構築済みのエージェントツール一式（bash、ファイル操作、ウェブ検索など）を有効にします。完全な一覧とツールごとの設定オプションについては、ツールを参照してください。

   返されたagent.idを保存してください（CLIのant applyはこれを出力し、claude-lock.jsonに記録します）。作成するすべてのセッションでこれを参照します。

2. 2

   環境を作成する

   環境は、エージェントが実行されるサンドボックスを定義します。

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   

   ant apply environment.yaml

   environment.yaml

   

   name: quickstart-env
   config:
     type: cloud
     networking:
       type: unrestricted

   返されたenvironment.idを保存してください（ant applyを使用した場合はclaude-lock.jsonにも記録されます）。作成するすべてのセッションでこれを参照します。

3. 3

   セッションを開始する

   エージェントと環境を参照するセッションを作成します。

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   

   session = client.beta.sessions.create(
       agent=agent.id,
       environment_id=environment.id,
       title="Quickstart session",
   )
   
   print(f"Session ID: {session.id}")

4. 4

   メッセージを送信して応答をストリーミングする

   ストリームを開き、ユーザーイベントを送信してから、到着したイベントを順次処理します。

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   

   with 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は次のことを行います。

1. サンドボックスをプロビジョニングする： 環境の設定によって、どのように構築されるかが決まります。
2. エージェントループを実行する： Claudeはメッセージに基づいて、どのツールを使用するかを判断します。
3. ツールを実行する： ファイルの書き込み、bashコマンド、その他のツール呼び出しはサンドボックス内で実行されます。
4. イベントをストリーミングする： エージェントの作業中、リアルタイムで更新を受け取ります。
5. アイドル状態になる： エージェントは、これ以上行うことがなくなると session.status_idle イベントを発行します。

完全なアプリを構築する

これらのクイックスタートはそれぞれ、Claude Managed Agentsを人気のチャットフレームワークと組み合わせて、完全に実行可能なアプリケーションを作成します。いずれの場合も、フレームワークがチャット画面をレンダリングし、マネージドセッションがサーバー側でエージェントループを実行します。セッションはトランスクリプトを保持し、サンドボックス内でツールを実行し、フロントエンドがレンダリングするイベントをストリーミングします。

次のステップ