コンテンツにスキップ

4. Claude Codeから操作する

ここまでは、コンソール・CLI・SDKで自分の手を動かしてエージェントを組み立てました。このページでは、その作業をClaude Codeに任せる方法を体験します。Claude Codeには、Claude APIとManaged Agentsの最新リファレンスを持つ**claude-apiスキル**がバンドルされています。2. CLIでエージェントを作成でセットアップしたantコマンドと組み合わせると、「エージェントを一覧して」「このエージェントでセッションを動かして」「新しいエージェントを作って」と日本語で頼むだけで、Claude Codeが必要なコマンドやファイルを用意して実行してくれます。

  1. Claude Codeをインストールし、ログインしておきます。すでにお使いの方はそのままで構いません。最新のスキルを使うため、claude updateで最新版にしておくことをおすすめします。

  2. antのセットアップとant auth loginが済んでいることを確認します(2. CLIでエージェントを作成の手順1)。Claude Codeはantを通じてワークスペースのリソースを読み書きします。

    Terminal window
    ./ant auth status
  3. 作業用のフォルダーを作って移動し、Claude Codeを起動します。

    Terminal window
    mkdir claude-code-agents
    cd claude-code-agents
    claude

2. Claude Codeのclaude-apiスキルでできること

Section titled “2. Claude Codeのclaude-apiスキルでできること”

claude-apiスキルは、Claude Codeに同梱されているAgent Skillです。インストールは不要で、Claude APIやManaged Agentsに関する依頼をすると自動で有効になります。/claude-apiと入力して明示的に呼び出すこともできます。

できること使い方
最新のリファレンスを参照するManaged Agentsの話題を出すと自動で有効化。モデルID・料金・APIの最新仕様を踏まえて回答やコード生成をしてくれる
新しいエージェントを対話形式で作る/claude-api managed-agents-onboard ・・・ 作りたいものを聞き取り、エージェント・環境・セッションの順に設定ファイルを作ってant applyで反映する
コンソールのテンプレートから作る/claude-api managed-agents-onboard deep-researcher のようにテンプレート名を指定。初級1で使った「詳細リサーチャー」もここから作れる
Web上の記事やサンプルを再現する/claude-api managed-agents-onboard <URL> ・・・ ドキュメントやブログの内容からエージェントを組み立てる
セキュリティ設定をチェックする/claude-api managed-agents-secure <エージェントID> ・・・ 公式のセキュリティガイドと照らし合わせて読み取り専用でレポートする
既存リソースを操作する「一覧して」「セッションを作って」などの依頼に対して、ant beta:agents listやant beta:sessions createなどのコマンドを組み立てて実行する

3. 作成済みのエージェントを一覧する

Section titled “3. 作成済みのエージェントを一覧する”
  1. Claude Codeに次のように頼みます。

    このワークスペースにあるManaged Agentsのエージェント・環境・セッションを一覧して。IDと名前を表にまとめてください。
  2. Claude Codeがantコマンドを実行してよいか確認してくるので、許可します。内部では次のようなコマンドが実行されます。

    Terminal window
    ant beta:agents list --transform '{id,name,model}' --format jsonl
    ant beta:environments list --transform '{id,name,config.networking.type}' --format jsonl
    ant beta:sessions list --max-items 10 --transform '{id,status,agent.id}' --format jsonl
  3. ここまでのページで作ったエージェント(AZ-900 Quiz Agent、AZ-900 Quiz Agent CLI、AZ-900 Quiz Agent SDKなど)が表で返ってきます。

4. 作成済みのエージェントを呼び出す

Section titled “4. 作成済みのエージェントを呼び出す”
  1. 一覧にあったエージェントを指定して、セッションの実行を頼みます。

    「AZ-900 Quiz Agent CLI」で新しいセッションを作って、「AZ-900の練習問題を1問出題してください」と送ってください。エージェントの応答が返ってきたら、問題文と選択肢をそのまま見せてください。
  2. Claude Codeは、エージェントIDと環境IDを調べたうえで、セッションの作成・メッセージ送信・イベントの受信を行います。2. CLIでエージェントを作成でターミナルを2つ使って手で行った作業を、まとめて代行してくれます。

    Terminal window
    SESSION_ID=$(ant beta:sessions create --agent agent_... --environment-id env_... --transform id -r)
    ant beta:sessions:events send --session-id "$SESSION_ID" --event '{type: user.message, content: [{type: text, text: "AZ-900の練習問題を1問出題してください"}]}'
    ant beta:sessions:events list --session-id "$SESSION_ID" --format jsonl --transform '{type,text:content.0.text}'
  3. 問題が表示されたら、続けて回答を送ってもらいます。同じセッションに送るので、出題 → 回答 → 正誤判定の会話がつながります。

    同じセッションに「C」と回答を送って、正誤判定と解説を見せてください。
  4. 確認が終わったら、セッションを停止してもらいます。

    このセッションをアーカイブしてください。

5. 新しいエージェントを作成する

Section titled “5. 新しいエージェントを作成する”
  1. オンボーディング用のサブコマンドを実行します。

    /claude-api managed-agents-onboard
  2. 「どんなエージェントを作りたいか」を聞かれるので、作りたいものを説明します。ここでは初級3のお題3と同じ、AWS版のクイズボットを作ってみます。

    AWS Knowledge MCPサーバー(https://knowledge-mcp.global.api.aws、認証不要)から最新の情報を取得して、AWS認定「Cloud Practitioner」(CLF-C02)の練習問題を1問ずつ出題するエージェント。問題文と選択肢を提示したら、ユーザーが回答するまで正解を明かさない。回答後は正誤と各選択肢の解説、参考になるAWS公式ドキュメントのURLを3つ示す。ユーザーの回答を記憶して、苦手分野を重点的に出題する。ユーザーがチャットで質問に答える形で使う。
  3. Claude Codeがエージェント設定を提案してきます。モデル・ツール・MCPサーバーの設定が含まれているので、内容を確認して承認します。ツールの実行確認(「確認なしで実行」か「リスクのある操作は判定する」か)を聞かれたら、このエージェントは読み取りしかしないので「確認なしで実行」で構いません。

    agents/aws-quiz-agent/agent.md(例)
    ---
    name: AWS Quiz Agent
    model: claude-sonnet-5-5
    mcp_servers:
    - name: aws-knowledge
    type: url
    url: https://knowledge-mcp.global.api.aws
    tools:
    - type: agent_toolset_20260401
    default_config: {permission_policy: {type: auto}}
    configs:
    - {name: web_fetch, enabled: false}
    - {name: web_search, enabled: false}
    - type: mcp_toolset
    mcp_server_name: aws-knowledge
    default_config: {permission_policy: {type: always_allow}}
    ---
    あなたはAWS Knowledge MCPサーバーを使ってAWS認定Cloud Practitioner(CLF-C02)の練習問題を作成する学習アシスタントです。
    ...
  4. 続いて環境を聞かれます。既存の環境(Quiz-environment-cliなど)を選ぶか、「新しい環境を作成」を選びます。新規作成の場合はネットワークの範囲を聞かれるので、「制限付き」で進めます。

  5. 認証情報ボールトの確認は、MCPサーバーが認証不要なので「今はスキップ」で構いません。

  6. Claude Codeがant apply --dry-runで反映内容(組織・ワークスペース・作成されるリソース)を表示します。問題なければ承認すると、ant apply --yesでエージェントと環境が作成され、claude-lock.jsonにIDが記録されます。

  7. 最後に「テストセッションを実行しますか?」と聞かれます。「セッションを開始」を選ぶと、Claude Codeがagents/aws-quiz-agent/session.yamlを書いてセッションを作成し、最初のメッセージを送ります。ant beta:sessions connectでターミナルを接続してやり取りを確認しましょう。

6. セキュリティ設定をチェックする(任意)

Section titled “6. セキュリティ設定をチェックする(任意)”

作ったエージェントが本番運用に向いた設定になっているか、公式のセキュリティガイドに照らしてチェックできます。

/claude-api managed-agents-secure agent_ここにエージェントID

エージェントの設定・最近のセッション・環境・ボールトを読み取り、変更すべき設定とその推奨値をレポートします。読み取り専用なので、何も変更されません。

  • Claude Codeのclaude-apiスキルは、Managed Agentsの最新リファレンスと、エージェント作成の対話フロー(managed-agents-onboard)、セキュリティチェック(managed-agents-secure)を提供します。
  • 一覧・セッション作成・メッセージ送信といった日常の操作は、日本語で頼むだけでClaude Codeがantコマンドを組み立てて実行してくれます。中身は2. CLIでエージェントを作成で手で打ったコマンドと同じです。
  • エージェントと環境はagents/配下のファイルとant applyで管理するのが推奨の流れです。IDはclaude-lock.jsonに記録され、アプリケーションのコード(SDK)はそのIDでセッションを作ります。

おつかれさまでした!ここまでの感想を、ぜひXにポストしてください。

感想をXにポストする