#Claude Code

長時間タスクの完了・テスト失敗・自動実行の終了など、Claude Codeのイベントを外部に通知したい場面は多い。Stop / StopFailure / Notification フックで Webhook を叩けば、Discord や Slack に流せる。実装例と通知疲労を避ける設計まで整理する。

Claude Codeの結果の質は、指示の質でほぼ決まる。対象特定・期待結果・制約・背景・検証の5原則で「通る指示」を設計する方法を、NG例と改善例のビフォーアフターで整理する。

Claude Codeが思ったように動かないとき、原因の多くはコンテキスト・指示・権限の問題にある。ツール拒否・無限ループ・的外れな修正など、よくある5つの失敗パターンを症状別に整理し、即座に立て直す手順をまとめる。

Agent toolで並列実行しても「同じファイルへの書き込みコンフリクト」という壁がある。git worktreeと組み合わせると各エージェントが独立したブランチで作業できる。設計パターンとマージ戦略を実例で整理する。

長いセッションで精度が落ちる原因はコンテキストの汚染と肥大化にある。/clearと/compactの使い分け・CLAUDE.mdへの書き戻し・サブエージェントでの分離など、トークンを無駄にしない戦略を整理する。

Claude Codeのスキル機能で、設計・生成・レビューの3サブエージェントが連携するCloudFormationパイプラインを構築した。5スタック構成のVPC環境を実際にデプロイし、踏んだ6つのエラーをSKILL.mdのルールとして書き込むまでの記録。

Claude Codeのスキル機能でオリジナルのスラッシュコマンドを作る方法を解説。SKILL.mdの構造・フロントマターの書き方・サブエージェントの呼び出し方から、実際にClaude Codeと対話しながら育てていく過程まで記録する。

GitHub ActionsにClaude Codeを組み込んでPRレビューを自動化する方法を解説。最小構成で動かしてから推奨構成（サイズスキップ・CLAUDE.mdレビュー指示）に育てる手順を実装コード付きで説明する。

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

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

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

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の動作を確実に制御する方法を解説する。

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専用のフック。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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