【保存版】Claude Codeを800時間回して到達した、「指示」ではなく「共犯」関係になるための設定ファイル全公開

2025年11月29日 22:01

先日公開した『Claude Code作者の「Boris流」』の記事が大きな反響を呼びました。しかし、概念は分かっても「で、具体的にどう設定すればいいの？」という疑問を持った方も多いはずです。

正直に言います。デフォルトのClaude Codeは「優秀な新人」ですが、そのままでは「指示待ち人間」です。
私がこの800時間で行ったのは、彼を「指示待ち」から、阿吽の呼吸で動く「共犯者」へと変えるための「洗脳（コンテキスト設計）」でした。

今回は、私が実際の開発現場で使っている.claudercの設定、カスタムコマンド、そしてエージェント分割の定義を、生々しいコメント付きで公開します。精神論は抜きです。コピペして使ってください。

【章1】記憶の「外部化」：.clauderc で教育コストをゼロにする

毎回「TypeScriptで書いて」「テストはJestで」と指示していませんか？それは人生の浪費です。
私はプロジェクトルートの記憶領域（Memory）に、以下の「絶対遵守ルール」を叩き込んでいます。これを一度設定すれば、Claudeは二度と過ちを犯しません。

▼ project_instructions.md （記憶用プロンプト実例）

# 開発者の「思想」定義（絶対遵守）

1. **拒否権の発動**:
   - 私が非効率な実装を指示した場合、必ず「より良い代替案」を提示してから実装すること。イエスマンは不要。

2. **コード品質の基準**:
   - `any`型を見つけたらビルドを落とす覚悟で修正せよ。
   - 関数は20行を超えたら分割を提案せよ。
   - コメントは「何をしているか」ではなく「なぜそうしたか（Why）」を書け。

3. **出力形式**:
   - 説明は箇条書きで3行以内。長文の解説は求めていない限り禁止。
   - コードブロックのファイルパスは必ず相対パスで記述すること。

これで、Claudeは「ただのツール」から「口うるさいテックリード」に変わります。

【章2】手足の「拡張」：カスタムコマンドで定型業務を瞬殺する

「認証機能を追加して」「エラーハンドリングを入れて」……そんな定型文を打つのは今日で終わりにしましょう。
私が愛用している「開発加速用カスタムコマンド（Slash Commands）」の定義ファイルです。

▼ commands.json （抜粋）

{
  "/feat-api": {
    "description": "堅牢なAPIエンドポイントを生成する",
    "prompt": "新しいAPIを作成します。以下の要件を必須とします：\n1. Zodによるバリデーション\n2. カスタムエラークラスの使用\n3. OpenTelemetryによるログ埋め込み\n4. 正常系・異常系のJestテストケース作成\n対象機能名: {{argument}}"
  },
  "/refactor-dry": {
    "description": "DRY原則に基づきコードを圧縮する",
    "prompt": "現在開いているファイルの重複ロジックを検出し、共通関数として切り出してください。機能を変えずに、行数を削減することに命をかけてください。"
  }
}

これで、/feat-api UserLogin と打つだけで、私のこだわりが詰まった完璧なボイラープレートが生成されます。

【章3】脳の「分散」：Sub-Agentは「役割」ではなく「タスク」で切れ

ここが最大の落とし穴です。多くの人が「フロントエンド担当」「バックエンド担当」という曖昧な役割（Role）でエージェントを作りますが、これは失敗します。コンテキストが混ざるからです。

800時間の結論。エージェントは**「単一タスク（Task）」**で切ってください。

❌ 失敗するエージェント分割

@FrontEnd （範囲が広すぎて記憶が溢れる）
@BackEnd

⭕️ 成功するエージェント分割（私の構成）

@Reviewer （コードレビューとセキュリティチェックのみを行う）
@TestGen （渡されたコードに対するテスト作成のみを行う）
@DocWriter （JSDocとREADMEの更新のみを行う）

メインの私は「指揮官」として要件だけを伝え、実装はメインスレッド、テストは @TestGen、ドキュメントは @DocWriter に並列で投げます。これが、1人で3人分の出力を出すための「分業の正解」です。

【章4】外部脳との接続：MCPサーバー選定の「ファイナルアンサー」

MCP（Model Context Protocol）は数あれど、実務で本当に使えるのはこの3つだけでした。これ以外はノイズになります。

Filesystem MCP: ローカルファイルを読み書きする基本のキ。
PostgreSQL MCP: DBスキーマを直接覗かせる。ER図を渡す必要がなくなります。
Browser (Playwright): 「今の画面、崩れてない？」と聞くだけで、AIがブラウザを開いて確認してくれます。

【結論】それは「指示」ではない。「共犯関係」だ。

これらの設定を終えたとき、あなたは気づくはずです。
Claude Codeはもはや「チャットボット」ではありません。あなたの思考を先読みし、裏側で勝手にテストを書き、ドキュメントを整備してくれる「共犯者」になっています。

「AIに仕事を奪われる」と怯えるのはやめましょう。
この設定ファイルを使いこなし、「AIという最強の部下を率いるプレイングマネージャー」として、2026年をサバイブしてください。

あわせて読みたい
[【個人開発】Claude Code作者の「Boris流」を最小構成で完全再現する —— 魔法の設定ではなく“運用”で勝つ]

📚 学びを深める：AI時代に「再評価」されるべき3冊

Claude Codeのような強力なAIを使いこなすとき、ボトルネックになるのは「AIの性能」ではなく、**「人（あなた）の言語化能力と設計力」**です。
「AIに指示する言葉が出てこない」「AIが書いたコードの良し悪しが即座に判断できない」という壁を感じたときに、立ち返るべき3冊を紹介します。

1. 『スタッフエンジニア　マネジメントを超えるリーダーシップ』
この記事で「AIを部下にする」「指揮官になる」と書きましたが、まさにその立ち振る舞いを学べる本です。コードを書く時間よりも、全体俯瞰、意思決定、技術的な方向付けに時間を使う「スタッフエンジニア」という働き方は、AI時代の全エンジニアが目指すべき姿です。

2. 『クリーンアーキテクチャ　達人に学ぶソフトウェアの構造と設計』
なぜあなたのClaudeは混乱する（コンテキスト汚染を起こす）のか？それはコードの依存関係が整理されていないからです。「AIに読ませやすいコード」とは、すなわち「疎結合で美しいアーキテクチャ」のこと。本書の「依存性のルール」を守ることは、そのままAIの回答精度を上げることに直結します。
Kindle版がお得

3. 『ドメイン駆動設計入門ボトムアップでわかる！ドメイン駆動設計の基本』
AIと「共犯関係」になるために最も必要なのは、共通言語です。DDD（ドメイン駆動設計）で提唱される「ユビキタス言語（開発者とビジネス側が共通して使う言葉）」の概念は、そのままプロンプトエンジニアリングの極意に通じます。ビジネスの言葉をそのままコードに落とし込めるようになれば、Claudeとの対話は劇的にスムーズになります。

まとめ

AIINFOの歩き方

この他にも、開発効率を上げるためのツール設定や、2026年以降の未来予測など、目的別に情報を整理しています。
「何から読めばいいかわからない」という方は、まずはこちらのガイド記事をご覧ください。

より実践的な内容は下記が面白そうでした。
▼ AI時代の収益設計｜ビジネスモデル×副業×自動化
副業で月5万→30万の階段を、テンプレとチェックリストで仕組み化するためのガイドです。👇

【保存版】Claude Codeを800時間回して到達した、「指示」ではなく「共犯」関係になるための設定ファイル全公開

【章1】 記憶の「外部化」：.clauderc で教育コストをゼロにする

【章2】 手足の「拡張」：カスタムコマンドで定型業務を瞬殺する

【章3】 脳の「分散」：Sub-Agentは「役割」ではなく「タスク」で切れ

【章4】 外部脳との接続：MCPサーバー選定の「ファイナルアンサー」

【結論】 それは「指示」ではない。「共犯関係」だ。