
CLAUDE.md のトリセツ — 200行で Claude Code の動きが変わる
ZennCLAUDE.md は長さに関わらず全文ロードされるが、セッション進行とともにコンテキスト内で薄れるため、200行以内の推奨は「指示の遵守率を高める」ためのベストプラクティス。API仕様やリファレンスは skills / .claude/rules/ に分散し、CLAUDE.md には具体的・検証可能な指示のみを集約することで効果を最大化できる。
全 785 件 (Zenn で絞り込み) · 3 / 40 ページ

CLAUDE.md は長さに関わらず全文ロードされるが、セッション進行とともにコンテキスト内で薄れるため、200行以内の推奨は「指示の遵守率を高める」ためのベストプラクティス。API仕様やリファレンスは skills / .claude/rules/ に分散し、CLAUDE.md には具体的・検証可能な指示のみを集約することで効果を最大化できる。

GLM-5.2 がDesign Arenaのコード部門で1位を獲得したというニュースが流れているが、実際には測定対象が「見た目の投票」に限定され、Fable 5 は行政指示により無効化されて不在であり、個人ユーザーの実利用経路も限定的。数字の強さと実態の間にズレがある。


Claude Code のサブエージェント機能を使い、レビューを支援する自己成長エージェントを構築・評価した実践記。ゴールデンタスクとルーブリックで測定した結果、プロンプトの具体性、呼び出し時の明確な指示、KB の原則化が挙動に与える影響が全く異なることが判明。未知の漏れを検出する真の「賢さ」を測るには、KB に記録されていない題材での評価が必須。

AIがコードを生成する時代に、従来のIDEは「タイピング速度」の最適化に留まっており、実際のボトルネックである「AIの出力を判断する速度」を支援していない。著者は、HTMLのその場レンダリングや仕様・差分の可視化により「判断を速くする」ために設計したダッシュボード型IDEを開発・運用している。

Claude Code の Dynamic Workflows を15回実運用した際のトークンログを分析。キャッシュ読込比率は44~90%、コスト削減率は23~77%の範囲で分布し、両者は強く連動。最大の知見は「並列度(サブエージェント数)が高いほどキャッシュ読込比率・削減率も上昇する」こと。31~52体規模では読込比率79~90%・削減率65~77%を達成し、1エージェント当たり$0.68~$0.98に抑制。多数のサブエージェントが共有プレフィックス(システムプロンプト・ツール定義・親指示)を再利用するメカニズムが機能。

DifyのChatflow設計書をClaude Code Skillsで自動生成する実践ガイド。FAQボット・ITヘルプデスク・求人マッチングの3サンプルを通じて、設計判断の6原則とハマりポイント10選を解説。スキルファイル一式とともに、会話型アプリ開発の実装ノウハウを共有。

Claude Code の hooks 機能を使い、Bash コマンド完了時の通知、危険なコマンドのプレチェック、セッション開始時の環境セットアップなど、開発ワークフローを自動化する方法を紹介。~/. claude/settings.json への設定方法と実践的な設定例を解説。


Windows 11 + PowerShell 5.1 環境で Claude Code を常用する際の実装上の課題を整理。&& / || が使えない、ネイティブ exe への 2>&1 が誤った失敗判定を生む、ファイル文字コードが UTF-16 BOM になる、bash コマンドが動かない等の4つの落とし穴と、プロジェクト指示ファイルに記載して対策する方法を解説。

Claude Code v2.1.92 がリリース。forceRemoteSettingsRefresh ポリシーでリモート管理設定の鮮度を強制保証、Bedrock セットアップウィザードで AWS 連携の初期設定を対話形式で簡素化、/cost コマンドにモデル別・キャッシュ別の詳細内訳表示を追加。セキュリティとコスト管理のニーズが高いエンタープライズ利用に対応。

個人クリエイターが Claude Code・ElevenLabs・VRM・OBS を活用し、1週間で VTuber チャンネルの全インフラ(アバター制作・配信オーバーレイ・台本テンプレ・自動化パイプライン)を構築した実装記録。史実検証は人手維持しつつ、企画から動画化まで段階的に自動化を設計し、一人運用でも編集が止まらない仕組みを文書化・リポジトリ化した。

Claude.ai で記事生成指示書を設計し、Claude Code がソースコードと PROGRESS.md を参照しながら記事を生成するワークフロー。16本の記事生成を通じ、コード引用の正確性と体験談の具体性が手書きより高まり、実装とドキュメント作成の並行進行が可能になった。




複数プロジェクトを並行開発する際、品質と速度を維持するには AI の性能よりも人間側のタスクスイッチ作法とコンテキスト設計が重要。1セッション=1プロジェクトの厳格な分離、PROGRESS.md による進捗記録、CLAUDE.md での「やってほしくないこと」の明示、検証コマンドの固定化、claude.ai との役割分担(議論と実装の分離)など実証的な手法を紹介。1日に2プロジェクト以上の切り替えはオーバーヘッドが増加する。


Opus 4.8 固有のシリアライズ回帰バグにより、ツール呼び出しがプレフィックスを失ってプレーンテキスト化し、その崩れたパターンが自己強化されてカスケード的に再発生する現象を解説。長い散文の直後に単一ツールを置かない、並列呼び出しを活用するなど、振る舞いで回避可能。さらに対策ドキュメント自身がこの問題を悪化させないよう、症状の逐語例は遅延ロード別文書に分離する設計パターンも提示。

AIエージェントの普及で個人の生産性は確実に上がっているが、その恩恵が賃金・雇用・ワークライフバランスに反映されているのか問い直す記事。Opus 4.8による楽観側と懐疑側の論争を通じ、「効率化の果実は誰のものか」という構造的な問題を提示する。