ブログ

CCA Foundations試験のDomain 1「エージェント・ワークフロー設計」の直前対策まとめ。ツール設計・エージェントループ・マルチエージェント・エスカレーション・エラー伝播の判断軸を表とリストで整理。

CCA Foundations試験のDomain 2「Claude API・SDK実装」の直前対策まとめ。Messages API・ストリーミング・構造化出力・Batch APIの使い分けと判断軸を表とリストで整理。

CCA Foundations試験のDomain 3「Claude Code開発ワークフロー」の直前対策まとめ。CLAUDE.md階層・rules/skills/commands・Hooks・MCP設定・CLIフラグの判断軸を表とリストで整理。

CCA Foundations試験のDomain 4「プロンプト設計・信頼性・パフォーマンス」の直前対策まとめ。few-shot設計・明確な基準・ツール説明文・一貫性向上の手法を表とリストで整理。

CCA Foundations試験のDomain 5「評価・改善・品質計測」の直前対策まとめ。Eval設計・false positive削減・confidence scoring・coverage注釈・self-evaluationの判断軸を表とリストで整理。

Message Batches APIの50%コスト削減は魅力的だが、すべてのワークフローに使えるわけではない。fire-and-forgetモデルがツール呼び出しループを壊す理由と、latency-tolerantなタスクとの正しい対応関係を整理する。

エージェントの信頼性を高める2つの設計パターンを整理。プログラム的前提条件はプロンプト指示より確実にワークフローを強制する。few-shotの「理由付き例」は宣言的ルールより曖昧ケースのツール選択を改善する。

Skillsフロントマターの3つのキー（context:fork・argument-hint・allowed-tools）が解決する問題を整理。「量の問題」ではなく「推論汚染」がcontext:forkの本質。3つの設定を組み合わせて複数の問題を同時に解決するパターンを解説する。

`claude mcp add`（ユーザースコープ）と`.mcp.json`（プロジェクトスコープ）の違いを整理。${GITHUB_TOKEN}のような環境変数展開でシークレットをコミットせずにチーム全員が同じMCP設定を使う方法を解説する。

ClaudeのTool Useを実際に動かす実装を解説。マルチブロックレスポンスの読み方・tool_resultの返し方・stop_reasonでループを制御するエージェントループの実装まで、気象情報取得ツールを例に追う。

Tool Useの応用を解説。複数ツールのルーター設計・ツール過多が選択信頼性を下げる理由・tool_choice の3つのモード・ストリーミング時のfine-grainedオプション・テキスト編集・Web検索の組み込みツールまで網羅。

Claude APIでワークフローを設計する4つのパターンを解説。並列化・直列（チェーニング）・評価ループ（Evaluator-Optimizer）・ルーティングの仕組みと使い分けを具体的なユースケースとともに整理する。

Claude APIでエージェントを設計する考え方を解説。抽象的なツール設計の原則・環境観察の重要性・ワークフローとの使い分け判断軸を整理。CCA試験で頻出のcoordinator-subagentパターンとコンテキスト継承の落とし穴も解説。

エージェントがいつ自律解決してよくいつ人間にエスカレーションすべきかの判断基準を解説。ポリシーギャップを唯一の確実なエスカレーション基準として捉え、evaluator-optimizerパターンによる自己評価と複数懸念事項の並列処理設計まで。CCA試験Domain 1をカバー。

マルチエージェントシステムの信頼性を高める2つの設計パターンを解説。lost-in-the-middle対策（primacy effect・verbose output削減）と情報のprovenance管理（conflict annotation・coverage注釈・構造化エラー伝播）。CCA試験Domain 1・Domain 5をカバー。

Claude Codeのセッション管理（--resume・fork_session・named sessions・context isolation）とconfidence scoringの設計パターンを解説。長期タスクの中断・再開、並行探索、信頼スコアのキャリブレーションとstratified samplingによるエラーレート計測。CCA試験Domain 3・Domain 5をカバー。

Claude Codeがなぜ「コードを読み書きできる」のかをTool Useの仕組みから解説。/initコマンドでCLAUDE.mdを生成し、3層の設定階層（user/project/directory）と@importパターンを整理する。CCA試験Domain 3の基礎をカバー。

Claude CodeのPlanning ModeとThinking Modeの使い分けを解説。スクリーンショットでの視覚的指示・Escapeによる会話制御・/compact vs /clearの判断基準まで、CCA試験Domain 3 Task 3.1とDomain 5をカバー。

Claude Codeの拡張機能を整理。.claude/commands/（カスタムコマンド）・.claude/rules/（パス別ルール）・.claude/skills/（スキル）の使い分けとスコープ、MCPサーバーの追加方法、GitHub Actions連携のセットアップまで。CCA試験Domain 3をカバー。

Claude CodeのHooksをPreToolUse/PostToolUseに分けて解説。exit codeによる制御・.envファイル保護の実装例・TypeScript型チェックフック・クエリ重複防止フック・絶対パスのセキュリティ考慮まで。CCA試験Domain 1 Task 1.5をカバー。

Claude Code SDKをTypeScript/Python/CLIの3形態で解説。-p/--printフラグでCI/CDに組み込む方法・--output-format json・read-onlyデフォルトとallowedTools設定・独立レビューインスタンスの優位性まで。CCA試験Domain 3 Task 3.6をカバー。

CLAUDE.mdに書いても守られない——その理由と解決策。Hooks・ルールファイル・フィードバックループを組み合わせた「ハーネスエンジニアリング」で、Claude Codeの動作を確実に制御する方法を解説する。

Model Context Protocolの概念・アーキテクチャ・通信フローを解説。MCPがなぜ必要か、Tool Useとの違い、プロジェクト/ユーザースコープの設定方法、複数サーバーの同時接続まで、CCA試験のDomain 2を横断して押さえる。

PythonでMCPサーバーを実装する手順を解説。@mcp.toolデコレータによるツール定義・Pydantic Fieldでのスキーマ自動生成・Server Inspectorデバッグ・クライアント実装まで。ツール記述の質と選択信頼性、isErrorフラグの設計もカバー。

MCPの3つのプリミティブを整理し、ResourcesとPromptsの実装を解説。Direct/Templated URIの使い分け・content catalogによるツール呼び出し削減・@mcp.promptによるサーバーサイドテンプレート管理まで、CCA試験のDomain 2をカバーする。

プロンプトエンジニアリングの基本2テクニックを解説。「明確・直接的に書く」「具体的に指示する」の2つを適用するだけで、スコアが3.1から8.3まで改善する過程をコードと数値で追う。

プロンプトエンジニアリングの残り2テクニックを解説。XMLタグで構造を明示し、few-shotで曖昧なケースの判断を伝える——2テクニックを加えてスコアが8.3から9.1まで改善する過程を追う。

ClaudeのTool Useの仕組みを基礎から解説。ツール関数の書き方・JSON schemaの設計・descriptionが選択信頼性を左右する理由まで、株価取得ツールを例に実装を追う。

Claude APIをPythonで動かすまでの全ステップを解説。Opus・Sonnet・Haikuの選び方、APIキーの安全な管理、レスポンス取得まで——初心者がつまずくポイントと注意点も含めて理解できる。

Claude APIでマルチターン会話を実装する方法を解説。ステートレスなAPIで会話履歴を管理する仕組み、システムプロンプトの設計原則、Temperatureの使い分けまで——よくある落とし穴も含めて理解できる。

Claude APIのレスポンスをストリーミングで即時表示する方法、プリフィル＋ストップシーケンスによるJSON生成、tool_useによる確実な構造化出力の違いまで解説。

プロンプトの品質を「勘」ではなくスコアで測るEvalパイプラインの考え方を解説。5ステップのEvalワークフロー、グレーダー設計の落とし穴、独立評価インスタンスの重要性まで踏み込んで理解できる。

Evalパイプラインをコードで実装する。Claudeでテストデータを自動生成し、モデルベース採点のfew-shot活用、バリデーション失敗時のリトライパターン、コードベース採点を組み合わせた実践的なEvalを解説。

Claude Code Hooksを初めて使う人向けの入門記事。Pythonなし・シェルスクリプト1行から始めて、5分で最初のフックを動かす手順をコピペで解説。

v2.1.85で追加されたHooksのifフィールドを使えば、Bash(git *)のようなpermission rule構文で発火条件を絞り込める。実測済みの正しい構造と実用例を解説する。

Claude Code Hooksの全イベント・条件絞り込み・ブロック設計を実測済みコードで総整理。よくある間違いと正しい書き方を一枚で理解できるガイド。

Claude Code HooksのStopFailureとPermissionDeniedを解説。StopFailureはAPIエラー時に発火し、ログ・通知・リトライ自動化に使える。PermissionDeniedはauto mode専用のフック。

Amazon BedrockはClaude 4.6・Amazon Nova・Llama 4など多数のモデルを提供する。コスト・精度・用途別の選び方をモデルID・アクセス申請まで含めて整理する。

v2.1.83で追加されたCwdChanged Hookイベント。ディレクトリ移動を検知してCLAUDE_ENV_FILEに書き込むことで、AWSプロファイルなどの環境変数を自動で切り替えられる。

rm -rf・git push --forceなどの危険なコマンドをHooksでブロックする方法を解説。allowed-toolsの粒度設定やSkillsとの組み合わせによる二段構えのセキュリティ設計も実例付きで紹介。Claude Codeを安全に使いたい人向け。

Claude Codeのマルチエージェント構成はどう設計するか。オーケストレーターとワーカーの役割分担、ファンアウト・パイプライン・階層の3パターン、タスクの境界の引き方を実例で解説。

GenUのRAGとAgentCore Runtimeは何が違うのか。「検索して答える」と「ツールを呼び出して行動する」の違いを比較表と判断フローで整理。どちらを選ぶかの基準がわかる。

Claude CodeのAgent toolを使うと、サブエージェントにタスクを委譲して並列実行できる。コンテキスト分離・高速化・役割分担の仕組みと、向いている場面・向いていない場面を実例付きで解説。

GenUのRAG機能をゼロから理解する。Bedrock Knowledge Baseの構成要素・データソースの種類・チャンク設計・検索の仕組みを整理し、GenUからRAGを呼び出す流れまでを解説する。

AgentCore RuntimeのStateful MCPをコマンド集ではなく仕組みから理解する。MCPのJSON-RPCプロトコル・SSEストリーム・SigV4署名の動作を順を追って解説し、Elicitation・Sampling・Progress notificationsを動かす。

Claude CodeのPlan Modeを使うと、AIが実行前に計画を提示して承認を待つようになる。大規模な変更・破壊的な操作を安全に進める方法と、使うべき場面・使わなくていい場面を実例付きで解説。

AgentCore RuntimeにFastMCPサーバーをデプロイし、Elicitation・Sampling・Progress notificationsの3機能を実際に動かすまでの手順を解説する。ARM64パッケージングや認証まわりのはまりどころも記録する。

Claude Codeが使う.claudeフォルダには何が入っているのか。settings.json・hooks・commandsの役割と使い方を、実際の構成例をもとに解説。

Claude CodeのHooksを実際に使い倒す実装例3本立て。lint自動実行・危険コマンドのブロック・作業ログ収集を、実際に検証したコードとともに解説。

GenUをデプロイすると何が立ち上がるのか。CloudFront・Cognito・Lambda・Bedrockがどう繋がっているか、RAGとAgentでデータフローがどう変わるかを整理する。

Claude Code × AWSでSaaSを作るシリーズ第2回。CDKへの依頼の仕方・生成されたコードのどこを修正したか・なぜその判断をしたかを通じて、Claude CodeでAWSインフラを作る感覚をつかむ。

Claude Code × AWSでSaaSを作るシリーズ第3回。Bedrockを呼び出すLambdaの実装と、AIにWell-Architectedレビュアーとして振る舞わせるシステムプロンプトの設計プロセスを記録する。

AgentCore RuntimeがStateful MCP（Model Context Protocol）に対応した。Elicitation・Sampling・Progress notificationsの3機能とmicroVMによるセッション分離の仕組みを解説する。

Claude Codeの動作にスクリプトを自動で割り込ませるHooks機能を解説。lint自動実行・通知・危険なコマンドのブロックなど、Claudeへの指示なしに自動化できる仕組みをsettings.jsonの書き方から実装例まで紹介。

Claude Code × AWSでSaaSを作るシリーズ第1回。AWSアーキテクチャレビューAIを作る理由、技術スタックの選定、全体構成、Claude Codeで開発する意義を整理する。

AWSアーキテクチャレビューAIの料金プランをClaude Codeと壁打ちしながら決めた記録。課金ポイントの探し方・損益分岐点の計算・英語展開の判断まで、個人SaaSの料金設計プロセスをそのまま公開する。

AgentCore RuntimeのStateful MCPを理解するために必要な前提知識を整理する。MCPとは何か、AIエージェントとの関係、Stateless MCPの限界、AgentCore Runtimeの役割をまとめる。

Amazon Bedrockとは何か、何ができるのかを入門者向けに整理する。SageMakerとの使い分けやAWSとの統合、Pythonから実際にモデルを呼び出す最小コードまでカバー。

個人用CLAUDE.mdをチームで使えるレベルに育てる方法。セクション設計・良い書き方と悪い書き方の比較・育て方のサイクル・階層構造の活用まで、実例を交えて解説する。

Claudeのアップデートを追うのが大変だったので、Google News RSSとGitHub ReleasesをAI要約して自動表示するページを作った。実装の仕組みと工夫したポイントをまとめる。

AWSが公式に提供するOSSの生成AIプラットフォーム「GenU」とは何か。BedrockとGenUの関係、RAGとAgentの違い、ゼロから自作する場合との比較まで、入門者向けに整理する。

Bedrock Knowledge Baseのメタデータフィルタリングの仕組みを解説する。S3へのmetadata.json配置からフィルター構文・ingestionの動作まで、部署別アクセス制御の実装に必要な知識をまとめた。

Bedrock Knowledge BaseのRAGに使うretrieve_and_generate APIの構造を解説する。retrieve との違い、modelArnの指定方法、レスポンスのcitations処理まで、実装コードをベースにまとめた。

Claude CodeはMCP（Model Context Protocol）を使って外部ツールと連携できる。設定方法からGemini連携の実例まで、MCPサーバーを追加して機能を拡張する方法をまとめた。

Claude Codeはデフォルトでセッションをまたぐと記憶がリセットされる。自動メモリ機能とMEMORY.mdを使えば、名前・好み・プロジェクト背景を会話をまたいで保持できる。

Claude Codeはどこで起動するかで「見える範囲」が変わる。CLAUDE.mdの置き場所・起動場所・ディレクトリ構成のパターンを理解すれば、複数プロジェクトでも迷わなくなる。

GenU標準のRAGは全ユーザーが全ドキュメントを参照できる。カスタムLambdaとBedrockのメタデータフィルタリングを使って、Cognitoの部署情報に基づいたアクセス制御を実装した。

CLAUDE.mdはClaude Codeが起動時に自動で読む指示書ファイル。毎回同じ説明をしなくて済むようになり、チームで使う場合は共有の前提知識として機能する。書き方と育て方を解説する。

Claude CodeをオーケストレーターにしてKiro CLIをMCP Server経由で自動呼び出しする環境を構築した。diffレビュー・テスト生成・IaC生成をKiroに委譲することで、Claudeのトークン消費を抑えながら質の高い出力を得られるようになった話。

GenUを閉域モード（closedNetworkMode）でCDKデプロイし、インターネット接続なしのVPC内でGenUを動かす手順をまとめた。ハマりポイントも合わせて紹介する。

Claude Codeのスキル（/コマンド）は繰り返す作業を一発で呼び出せる仕組み。組み込みコマンドの使い方から、やった作業をそのままスキルに育てる方法まで解説する。

Claude Codeに「このファイルを読んで」「この関数を直して」と言うだけでいい。裏で何が動いているかを知っておくと、指示の精度がぐっと上がる。Read/Write/Grep/Bashの基本をまとめた。

古いIntel MacにOllamaとGemma3を入れてみた。動くことは動く。ただし回答速度は0.25 tokens/secだった。ローカルLLMを試すなら何が必要か、実測値をもとにまとめた。

Claude Codeを使い始めるまでの手順と、最初に覚えておくべき基本の使い方をまとめた。インストール方法は3通り。起動後に何をすればいいかも一緒に解説する。

VSCodeを開くたびに「今どのアカウントでログインしてるんだっけ」と思っていた。Claude Codeの認証状態をステータスバーに表示するVSCode拡張機能を作ってMarketplaceに公開した話。

AWS公式のOSS生成AIプラットフォームGenUをCDKでデプロイし、メールドメイン制限・IP制限（WAF）によるアクセス制御を検証した。

仕事用と個人用でClaudeアカウントを分けたくてZedを試した。Claude Codeとのネイティブ統合を試した手順と感想、そして結局VSCodeに戻った理由をまとめた。

Amazon Bedrockのモデル選定やPoC前のコスト感をつかむために作ったツール「Bedrock Cost Calculator」の使い方を紹介する。トークン数直接入力とプロンプト文からの自動推定、2つのモードがある。

サイトを公開しただけでは検索に出ない。Claude Codeに次にやることを聞きながら、Google Search Consoleへのドメイン登録・サイトマップ送信までをやってみた話。

「AWSの最新情報を日本語でまとめたい」という動機から、Claude Codeと一緒にゼロから個人サイトを作った。技術スタックの選定から自動収集スクリプト、SEO対策まで、やったことを全部まとめる。

「Claude使ってるよ」と言う人の2パターン——ブラウザ派とターミナル派。同じ「Claude」でもまったく別物のClaude.aiとClaude Codeの違いをまとめた。

Nano Banana（Gemini 2.5 Flash Image）でLINEスタンプを作って販売できるか試してみた。LINEのAIルールや収益の現実もまとめた。

「コードを書くツールでしょ？」と思って触り始めたClaude Code。実際に使ってみたら、コーディング支援だけでなく調査・設計・文章作成まで何でも対応してくれた話。