
Claude Code で複数ファイル跨ぎの修正を正確に処理する
ZennClaude Code でエージェントにツールを追加する際、複数ファイル(実装・エクスポート定義・ツール定義・ディスパッチテーブル)の同時変更が必要になる。実装指示書に「作成・更新ファイル一覧」を明示することで、変更漏れをゼロにでき、Claude Code はファイル間の依存関係も自律的に把握して対応できる。
全 785 件 (Zenn で絞り込み) · 5 / 40 ページ

Claude Code でエージェントにツールを追加する際、複数ファイル(実装・エクスポート定義・ツール定義・ディスパッチテーブル)の同時変更が必要になる。実装指示書に「作成・更新ファイル一覧」を明示することで、変更漏れをゼロにでき、Claude Code はファイル間の依存関係も自律的に把握して対応できる。

2026年6月中旬以降、Claude Opus 4.8の出力品質低下が報告されている。記事では Fable 5/Mythos 5 停止、Claude Code の effort 設定変更、インフラ障害の多発を確定事実として整理し、モデル重みの変更ではなく推論設定やシステムプロンプト、インフラレイヤーの複合要因が性能低下感を生じさせた可能性を検証している。

Claude Code v2.1.178 で TeamCreate が廃止され、同時期に Plan Mode の動作が変更された。Plan Mode が独自のワークフローを優先するようになったため、スキルとの競合が発生。Agent Teams は残存しているため、既存スキルを大幅変更せず Plan Mode の使用を避ける方針に転換し、セッション振り返り機能を強化した。


Claude Pro Max ($100/月) を約5ヶ月使用した開発者が、月額コストの持続可能性と競合モデルの台頭を理由に乗り換えを検討。DeepSeek、Kimi などのオープンソース系 AI がコード生成で十分実用的になったほか、OpenRouter などのルーターを経由することで複数モデルを効率的に運用できる構成を提案。価格、コンテキスト長、ベンチマークスコア、マルチモーダル対応の4軸で比較検討した実体験を記録。




Claude Code での設計認識合わせに使える /grill-me スキル(Matt Pocock 氏公開)の使用レポート。従来の /plan よりも決定の木を1枝ずつ潰し詳細まで詰める仕様で、認識ズレが減少。セットアップ方法と実装中に直面した挙動ブレ・トラブル対応(SKILL.md への Rules セクション追記など)を報告。

Claude Code v2.1.172 で実装されたサブエージェントのネスト機能により、メインセッションから呼んだ heavy-implementer が自動的に code-explore や test-runner を孫として委譲する挙動が観察された。役割ベースのモデル使い分けルール(.claude/agents/ 配下に複数エージェント定義)が、明示的な指示なしに再帰的に活用される共通部品として機能した事例。

音読速度計測アプリで Claude Haiku を使ったコーチング機能を実装する際、計算とルール判定はコード側で完結させ、Haiku には言語化だけを担当させる「二段構え」設計を解説。システムプロンプト・API 実装・プロンプトキャッシュの検証結果、実データで確認した予想外の挙動までをまとめた開発記。

約1,591行のシステムプロンプト (CLAUDE-FABLE-5.md) を解析したエンジニアリングレポート。振る舞いポリシー、世界モデル、ルーター、ハード制約、ツール定義の5層構成として、単なる「プロンプト」ではなく「運用仕様書」として機能していることを指摘。ファイルパスの役割固定化、Skillファースト、検索・Artifact・会話の使い分け基準などが具体的に記述されており、エージェント設計時の方針決定とスキーマ定義の分離が参考になる。


anthropic SDK 0.39.0を固定していても、間接依存のhttpx 0.28で proxies 引数が廃止されたため、デプロイ再ビルド時にClient初期化エラーが発生。requirements.txtでhttpxバージョンも明示的に固定することで解決。直接依存だけでなく重要な間接依存のピン留めが必須。




Claude Code の ~/.claude 配下にある設定・メモリ・セッション・プラグイン・キャッシュ各ファイルの役割・形式・ライフサイクルを実データに基づいて解説。ローカル環境での Claude Code の動作メカニズムを理解し、設定やキャッシュの手動管理が可能になる。

Claude Code で作成したスキルが自動で呼び出されない原因は、スキルの実装ではなく description の書き方にある。本文 + トリガー語リストの二段構えで description を整備し、実際の言い回しに近い検索キーワードを含めることで呼び出し率が向上する一方、汎用語を盛りすぎると暴発するため、相互参照で似たスキル同士の棲み分けを明記する必要がある。

複数エージェントに役割を分担させるマルチエージェント体制(Orchestrator / Planner / Worker / Critic)を Claude Code プラグインとして実装。前半は対話的な Agent Teams で「何を作るか」を決め、後半は決定論的な Workflow で実装→検証を並列実行する。実装・検証役を分離する Critic ゲートが精度向上の鍵。