4. Claude Codeから操作する
ここまでは、コンソール・CLI・SDKで自分の手を動かしてエージェントを組み立てました。このページでは、その作業をClaude Codeに任せる方法を体験します。Claude Codeには、Claude APIとManaged Agentsの最新リファレンスを持つ**claude-apiスキル**がバンドルされています。2. CLIでエージェントを作成でセットアップしたantコマンドと組み合わせると、「エージェントを一覧して」「このエージェントでセッションを動かして」「新しいエージェントを作って」と日本語で頼むだけで、Claude Codeが必要なコマンドやファイルを用意して実行してくれます。
-
Claude Codeをインストールし、ログインしておきます。すでにお使いの方はそのままで構いません。最新のスキルを使うため、
claude updateで最新版にしておくことをおすすめします。 -
antのセットアップとant auth loginが済んでいることを確認します(2. CLIでエージェントを作成の手順1)。Claude Codeはantを通じてワークスペースのリソースを読み書きします。Terminal window ./ant auth statusTerminal window ant auth status -
作業用のフォルダーを作って移動し、Claude Codeを起動します。
Terminal window mkdir claude-code-agentscd claude-code-agentsclaude
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. 作成済みのエージェントを一覧する”-
Claude Codeに次のように頼みます。
このワークスペースにあるManaged Agentsのエージェント・環境・セッションを一覧して。IDと名前を表にまとめてください。 -
Claude Codeが
antコマンドを実行してよいか確認してくるので、許可します。内部では次のようなコマンドが実行されます。Terminal window ant beta:agents list --transform '{id,name,model}' --format jsonlant beta:environments list --transform '{id,name,config.networking.type}' --format jsonlant beta:sessions list --max-items 10 --transform '{id,status,agent.id}' --format jsonl -
ここまでのページで作ったエージェント(
AZ-900 Quiz Agent、AZ-900 Quiz Agent CLI、AZ-900 Quiz Agent SDKなど)が表で返ってきます。
4. 作成済みのエージェントを呼び出す
Section titled “4. 作成済みのエージェントを呼び出す”-
一覧にあったエージェントを指定して、セッションの実行を頼みます。
「AZ-900 Quiz Agent CLI」で新しいセッションを作って、「AZ-900の練習問題を1問出題してください」と送ってください。エージェントの応答が返ってきたら、問題文と選択肢をそのまま見せてください。 -
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}' -
問題が表示されたら、続けて回答を送ってもらいます。同じセッションに送るので、出題 → 回答 → 正誤判定の会話がつながります。
同じセッションに「C」と回答を送って、正誤判定と解説を見せてください。 -
確認が終わったら、セッションを停止してもらいます。
このセッションをアーカイブしてください。
5. 新しいエージェントを作成する
Section titled “5. 新しいエージェントを作成する”-
オンボーディング用のサブコマンドを実行します。
/claude-api managed-agents-onboard -
「どんなエージェントを作りたいか」を聞かれるので、作りたいものを説明します。ここでは初級3のお題3と同じ、AWS版のクイズボットを作ってみます。
AWS Knowledge MCPサーバー(https://knowledge-mcp.global.api.aws、認証不要)から最新の情報を取得して、AWS認定「Cloud Practitioner」(CLF-C02)の練習問題を1問ずつ出題するエージェント。問題文と選択肢を提示したら、ユーザーが回答するまで正解を明かさない。回答後は正誤と各選択肢の解説、参考になるAWS公式ドキュメントのURLを3つ示す。ユーザーの回答を記憶して、苦手分野を重点的に出題する。ユーザーがチャットで質問に答える形で使う。 -
Claude Codeがエージェント設定を提案してきます。モデル・ツール・MCPサーバーの設定が含まれているので、内容を確認して承認します。ツールの実行確認(「確認なしで実行」か「リスクのある操作は判定する」か)を聞かれたら、このエージェントは読み取りしかしないので「確認なしで実行」で構いません。
agents/aws-quiz-agent/agent.md(例) ---name: AWS Quiz Agentmodel: claude-sonnet-5-5mcp_servers:- name: aws-knowledgetype: urlurl: https://knowledge-mcp.global.api.awstools:- type: agent_toolset_20260401default_config: {permission_policy: {type: auto}}configs:- {name: web_fetch, enabled: false}- {name: web_search, enabled: false}- type: mcp_toolsetmcp_server_name: aws-knowledgedefault_config: {permission_policy: {type: always_allow}}---あなたはAWS Knowledge MCPサーバーを使ってAWS認定Cloud Practitioner(CLF-C02)の練習問題を作成する学習アシスタントです。... -
続いて環境を聞かれます。既存の環境(
Quiz-environment-cliなど)を選ぶか、「新しい環境を作成」を選びます。新規作成の場合はネットワークの範囲を聞かれるので、「制限付き」で進めます。 -
認証情報ボールトの確認は、MCPサーバーが認証不要なので「今はスキップ」で構いません。
-
Claude Codeが
ant apply --dry-runで反映内容(組織・ワークスペース・作成されるリソース)を表示します。問題なければ承認すると、ant apply --yesでエージェントと環境が作成され、claude-lock.jsonにIDが記録されます。 -
最後に「テストセッションを実行しますか?」と聞かれます。「セッションを開始」を選ぶと、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にポストする