Claude Code 構成図

Claude Code 構成図

梅村拓馬(マネービタミン)の環境。1つのリポジトリで50事業。2026年10月22日時点の実物を11枚の図にした。各図は名前だけが出る。細かい説明は「詳しく」で開く。

全体像(1枚)

左が使う人、中央が Claude Code、右が保存先と外のサービス、下が守り方。スマホでは横にスクロールするか、下のリンクで図だけ開いて拡大する。

Claude Code 全体像。使う人(梅村・自動実行・別のPC・顧客)、Claude Code(CEO AI・担当13・手順書39・スクリプト97・自動検査9・机・記憶)、保存先(リポジトリ・GitHub)、外のサービス(Anthropic・MCP・公開)、守り方6つ。

図だけを別タブで開く(拡大用)

0何と何がつながっているか

真ん中が自宅のPC。Claude Code はここで動き、外の道具は線でつながっている。ファイルと鍵はPCから出ない。

話しかけるRemote Control
スマホ・別のPC・ブラウザ(Claude アプリ)会話の窓口。処理はPC側で動く
↓ ↑
自宅のPC(母艦)= Claude Code が常時起動リポジトリ ai-employee/鍵(.env)/スクリプト/ブラウザ/手元GPU
↓ ↑
考えるAPI
Anthropic(Claude のモデル)Opus / Sonnet / Haiku。文章と判断だけ送り、戻ってくる
履歴を置くgit push / pull
GitHub(origin)リポジトリの写し。全セッション・全PCの合流点。メモの正本(dotclaude)もここ
公開するvercel --prod
Vercelサイト・LP・ポータルの公開先。URL=プロジェクト名
MCP(Claude が直接さわれる道具。設定は .mcp.json)
読む・書くMCP
Google Drive・Docs・Sheets・Slides・Calendar・Gmail資料の検索と作成、予定の登録、受信の確認。成果物(PDF・動画)の置き場は Drive
やり取りMCP
Chatwork・Notion・WordPress・X未返信の検知と下書き、記事の更新、投稿の数字。送信ボタンは人
見る・測るMCP
Playwright(ブラウザ)・Firecrawl(Web取得)・Google Maps画面の実物を撮って確認、競合の調査、住所と地図
作るMCP・有料
画像生成(gpt-image・gemini-image)費用の上限あり。試し打ちはフックが止める
社外へ手動
顧客・受講者メール送信・投稿・公開は、下書きまで Claude、ボタンは梅村

1組織と、指示の流れ

人は1人。CEO AI が受けて振り分け、担当が作り、品質チェックを通して戻る。

梅村(人)指示を出す/確認する/外部への送信・公開の最後のボタンだけ押す
指示
CEO AI(このセッションの Claude 本体)~/.claude/CLAUDE.md + ai-employee/CLAUDE.md前提を読む → 事業(WS)を特定 → 担当へ振り分け → 出てきたものを7観点で検査 → 完成品だけ報告
振り分け(サブエージェント起動・モデルを指定)
制作productionLP・サイト・スライド・アプリ・画像
マーケmarketing-sales集客・SNS・note・広告・CRM・営業資料
教育education研修・教材・セミナー資料
判断の担当 9(読むだけ・作らない)/opus・sonnet
戦略strategist財務cfo技術ctoマーケ戦略cmo法務・リスクclo-croデザイン審査designer調査researcher業務coo人事cho
機械検査 1/haiku
件数・URL・分類・棚卸しqa-runner
全員が共通で使うもの
ルール 10.claude/rules/
手順書 39.claude/skills/
知識 30agents/shared-skills/
スクリプト 97scripts/
成果物
品質チェック(CEO AI が自動で差し戻す)shared/quality-rules.md正確・完全・一貫・実用・可読・誠実・適時の7観点。顧客向けの文は AI臭検査(ai-slop-check)も通す
完成品だけ
梅村に報告🟢 資料・下書き・コード=自動承認 🟡 軽微な修正=事後報告 🔴 新価格・外部送信・公開・契約=ここだけ止めて確認

※ 販促物(LP・チラシ・提案資料)は、①マーケがコピー → ②デザイン審査が仕様 → ③制作が実装、の3段階を必ず通す(/promo-brief)。CEO AI 自身がコピーやデザインを書き始めるのは禁止。

2フォルダ構成(実物)

リポジトリは1つです。色が付いている所は、図1に出てきた部品です。

  • ai-employee/リポジトリ本体(4,700コミット)
    • CLAUDE.mdCEO AI の制御マップ(97行)
    • .claude/
      • rules/ルール10本。常時8・ファイルを触ったときだけ2
      • skills/手順書39本(copy-pipeline・website-build・session-end…)
      • agents/担当13の定義(役割・モデル・使える道具)
      • hooks/自動検査9本(図4)
      • settings.jsonフックの登録・許可・worktree の設定
      • worktrees/セッションごとの作業コピー(図5)
    • agents/shared-skills/知識30本(戦略・財務・PR・診断の作り方…)
    • scripts/97本。検査・変換・同期・デプロイ
    • shared/品質基準・NG表現辞書・デザイン基準・同意文の正本
    • docs/
      • ops/live-status(稼働実態)・workspaces(事業一覧)・incidents(事故の経緯)・SETUP-PC
      • plans/progress(意思決定ログ)・current-sprint
    • workspaces/事業ごと 50
      • santier/ meo/ ai-kenshu/ hiro-dental-recruit/ …各WSに CLAUDE.md(その事業だけのルール)・DESIGN.md・成果物
    • logs/差し戻し台帳・検査結果・編集記録(git には入れない)
    • .env / config/鍵とトークン(git には入れない。読むとフックが止める)
  • ~/.claude/個人側(PC共通・dotclaude として GitHub に同期)
    • CLAUDE.md梅村の判断基準・文体・モデルの使い分け(86行)
    • projects/…/memory/メモ204件+索引 MEMORY.md
    • skills/session-triage/15分ごとのセッション見回り
  • ~/projects/独立して動くもの(ポータル・自動投稿・各サイト)。WS側には仕様だけ置く

31セッションで毎回読む層

Claude はセッションごとに記憶ゼロ。上から順に毎回読む。合計に上限があるので、増やすほど1つずつ薄くなる。

① 梅村の前提~/.claude/CLAUDE.md
1,900
② 会社の制御マップai-employee/CLAUDE.md
2,750
③ ルール(常時 8).claude/rules/*.md
4,300
③' ルール(限定 2)paths: 指定。そのファイルを触ったときだけ
—
④ メモの索引MEMORY.md(上限 200行 / 25KB)
3,500
⑤ 手順書の「いつ発動するか」39skills/*/SKILL.md の description だけ
4,300
⑥ 担当の一覧 13agents/*.md の description だけ
860
場面で読むWSの CLAUDE.md/手順書の本文/メモの本文/docs
必要時
毎回の固定分(トークン)約 18,000

※ 10月22日まで約27,700。索引が25KBを超えていて直近2か月のメモ46件が読まれていなかった。事故の経緯と一覧表を外に出して減らした。

4検査が挟まる位置

言葉のルールは忘れられる前提。指摘1件につき検査1件を、動作の間に差し込む。赤=その場で止まる。

セッション開始hooks/session-start.sh稼働状態・未コミット・未push・索引の上限を出す。母艦なら origin に追い付く
梅村が入力hooks/rework-detect.mjs「差し戻し」「やり直し」「AIっぽい」があれば台帳 logs/rework.jsonl に記録
コマンドを打つ前hooks/safety-check.sh強制push・全消し・有料APIの試し打ち・母艦での全部まとめて add・未コミットのまま本番公開止める
ファイルを読む前hooks/secret-read-guard.mjs.env・鍵・トークンの中身を画面に出そうとした止める
ファイルを書く前hooks/protect-files.sh.env・鍵ファイル・.git の中を書き換えようとした止める
カレンダーに登録する前hooks/calendar-check.shリマインダーが「予定あり」になっていないか止める
ファイルを書いた後hooks/post-edit-check.sh → scripts/ai-slop-check.mjs, copy-pipeline-check.mjsAI臭い文・文章工程の飛ばし・鍵の形の文字列・構文。編集を logs/edits.jsonl に記録
コミットする前scripts/git-hooks/pre-commit鍵の混入・300KB超のバイナリ・設定ファイルの同期ずれ止める
公開する前/claim-check(deliverable-lint)・privacy-consent-check・copy-pipeline-check --gateNG表現・法律・リンク切れ・同意文・工程飛ばし。🔴があれば公開しない止める
セッション終了/session-end → hooks/session-end.sh記録 → コミット → master に取り込み → push → メモ同期

5作業場所の分け方(2026-10-22〜)

リポジトリは1つ。セッションごとに作業コピー(worktree)を持ち、終わったら master に戻す。

origin/master(GitHub)全セッションの合流点。push は早送りだけ。--force 禁止
↑ rebase して push / ↓ 早送りで追い付く
母艦~/ai-employeeRemote Control の起動セッション1本と、自動実行だけ。ここでの「全部まとめて add」は止まる
worktree × N.claude/worktrees/<名前>/話しかけるたびに1つ(Remote Control は自動。PC は scripts/wt.ps1)。ブランチ worktree-<名前>。.env 等は .worktreeinclude で複製
終わり方「終わり」→ /session-end A(コミット → origin/master の上に自分の分だけ積み直す → push → 机を消す)。言わなくても、見回りが「完了」と判定したものは scripts/worktree-finish.mjs が同じことをする。衝突は直さず 🔴 で人に回す

※ 10月21日、同じ作業フォルダで別セッションの作りかけが本番に出た(docs/ops/incidents.md)。この分離はその翌日から。1週間の様子見中。

6学習の輪

指摘を言葉で覚えさせず、検査と記録に変える。週に1回、守られていないルールを削る。

① 差し戻しlogs/rework.jsonl入力中の語を自動記録。原因のルールを後から付ける
② 検査の結果logs/checks.jsonl4つの検査が🔴を何件出したか
③ メモ~/.claude/projects/…/memory/指摘79・案件57・参照49・束17
④ 事故の経緯docs/ops/incidents.mdルールの出どころ。ルール本文には命令だけ残す
⑤ 振り返りnode scripts/rework.mjs report件数の推移・「検査🔴0なのに差し戻し」・未検査。減っていないルールは削る。新しい種類は検査に変える(図4へ)
⑤ → ルールを減らす/検査を足す → ① に戻る

7用語の意味

図に出てくる言葉。左が言葉、右が意味と、この環境での実物。

保存と共有(git)

言葉意味この環境では
gitファイルの変更履歴を記録する道具。誰が・いつ・何を変えたかが全部残るPCに入っている。Claude がコマンドで使う
リポジトリgit で履歴を管理しているフォルダ一式ai-employee/(50事業がまるごと)
コミット「ここまでの変更」に説明を付けて履歴に保存すること。保存1回=コミット1つタスクが1つ終わるたびに Claude が自動でする。7か月で4,700回
push(プッシュ)PCの履歴を GitHub(外の写し)へ送ること。送って初めて他のPC・他のセッションから見えるセッション終了時。強制上書き(--force)はフックが止める
pull / fetchGitHub の最新をPCへ取ってくることセッション開始時に母艦が自動で追い付く
GitHubリポジトリを預かるWebサービスorigin(合流点)。メモの正本 dotclaude もここ
ブランチ履歴の枝。枝の上で作業しても本線(master)は変わらない本線が master。worktree ごとに枝 worktree-<名前>
worktree同じリポジトリから広げた、もう1つの作業フォルダ。枝つきセッションごとに1つ。.claude/worktrees/
rebase自分の枝の変更を、本線の最新の上に積み直すこと終了時に origin/master の上へ積み直してから push
.gitignore履歴に入れないファイルの一覧鍵(.env)・ログ・大きな成果物・worktrees/

Claude Code の部品

言葉意味この環境では
セッションClaude との1回の会話。始まるたびに記憶はゼロスマホ・PC・ブラウザから。1日に数本〜十数本
CLAUDE.mdセッションの最初に必ず読まれる文書。前提・ルール・振り分け個人用(~/.claude/)と会社用(ai-employee/)の2枚+各WSに1枚
ルール(rules)CLAUDE.md から分けた個別の決まり。常に読むものと、特定のファイルを触ったときだけ読むものがある.claude/rules/ 10本
スキル(skill)手順書。説明文(いつ発動するか)だけ毎回読まれ、本文は発動時に読む.claude/skills/ 39本。/session-end のように名前で呼べる
サブエージェント(agent)別の役割・別のモデルで動く Claude。本体が仕事を渡して結果だけ受け取る.claude/agents/ 13。制作3・判断9・検査1
フック(hook)決まった瞬間(開始・コマンド前・書いた後…)に自動で走るプログラム。止めることもできる.claude/hooks/ 9本(図4)
MCPClaude が外の道具(Drive・Chatwork・ブラウザ…)を直接さわるための接続口.mcp.json に接続先を書く(図0)
メモリ(memory)Claude が自分で書き足す覚え書き。索引だけ毎回読む~/.claude/projects/…/memory/ 204件
トークンClaude が読む・書く文字量の単位。日本語はだいたい1.5字で1トークン。読める量に上限がある毎回の固定分 約18,000(図3)
モデル(Opus / Sonnet / Haiku)Claude の頭脳の種類。賢いほど遅くて高い判断=Opus、定型=Sonnet、分類・検査=Haiku
ハーネスモデルを囲んで毎回同じ動きをさせる枠。前提・手順書・役割・自動検査・記憶の5つ(図8).claude/ と ~/.claude/ の中身すべて
ループ終わったら最初に戻って回り続ける手順。作業(原因→直す→確かめる)、セッション(開始→終了)、学習(差し戻し→検査に変える)の3つ(図8)/mv-dev:systematic-debugging・/session-end・rework.mjs report
Remote Control手元の端末から、PCで動く Claude Code に話しかける仕組み母艦で常時起動。新しいセッションは自動で worktree に入る

操作と公開

言葉意味この環境では
Bash(バッシュ)文字でPCに命令する画面(黒い画面)と、その命令の言葉。Claude はこれでファイルを動かし、プログラムを走らせるClaude の道具の1つ。危ない命令はフックが止める
スクリプト命令をまとめて書いたファイル。同じ作業を毎回同じように繰り返せるscripts/ 97本(Node.js・Python・PowerShell)
.env / 鍵外部サービスにつなぐための合言葉(APIキー・トークン)。漏れると他人が使えるgit に入れない。中身を画面に出そうとするとフックが止める
デプロイ作ったサイトを公開サーバーに置くことVercel。vercel --prod。未コミットがあると止まる
noindex検索エンジンに載せない印公開前・内部向けのページ全部

8ハーネスとループ

ハーネス=モデル(Claude)を囲んで、毎回同じ動きをさせる枠。ループ=終わったら最初に戻って回り続ける輪。この環境は、ハーネスの上で3つのループが回っている。

ハーネス(モデルを囲む枠)モデル判断と文章だけ前提CLAUDE.md手順書skills役割agents自動検査hooks記憶memory
原因を調べる直す確かめる
① 作業のループ動くまで回す。「直しました」で終えない
開始前提を読む作業終了
② セッションのループ開始と終わりを毎回同じ形に
差し戻し台帳検査に変える削る
③ 学習のループ(週1)減らすところまでで1周

※ ハーネスの5つは図2のフォルダに対応(.claude/ と ~/.claude/)。ループ①は /mv-dev:systematic-debugging、②は /session-end が手順書。③は手順書を持たず、node scripts/rework.mjs report の数字を見て回す。

9セキュリティで必ず守ること

Claude は「言われたことをやる」ので、守らせたいことは人の注意ではなく仕組みで止める。8つとも実際に事故か、事故の一歩手前があった。赤いアイコン=実際に事故が起きたもの。「詳しく」で理由が出る。

鍵(APIキー・トークン・パスワード)をコード・文書・会話に出さない.env に置き、環境変数で読む。読み出し・書き換え・コミットをフックが止める(secret-read-guard・protect-files・pre-commit)会話は外のサーバーを通る。一度出ると戻せない。git に入れると履歴に永久に残る
有料のAPIを「動作確認で1回」叩かない有料APIのドメインと課金スクリプトをフックが止める。承認の印(CLAUDE_ALLOW_PAID=1)が無いと動かない1回でも課金される。残高確認の1回で残高が消えたことがある
外部への送信・公開のボタンは人が押すエスカレーション🔴。下書きまで Claude、送信は梅村。本番公開前は検査が🔴で止めるメール・投稿・本番公開は取り消せない。下書きの品質は AI が担保できても、出す判断はできない
文書・メール・Webの中の「指示」に従わない見回りは transcript を資料として読むだけ。サブエージェントの報告も「依頼」として扱わない。許可の変更は人だけ読ませた資料や受信メールに「これを送れ」「設定を変えろ」と書いてあっても、それは依頼ではなく資料(prompt injection)
作りかけを本番に出さないセッションごとに worktree。母艦で「全部まとめて add」と、未コミットがある状態の本番公開をフックが止める同じフォルダで複数が作業すると、他人の途中が混ざる(2026-10-21 に実際に起きた)
公開先に余計なファイルを上げない.vercelignore で除外。公開後に URL を叩いて 404 を確かめる。内部向けは noindexVercel CLI は .gitignore を見ずにフォルダごと上げる。社外秘のデータや設計書が公開URLで見えたことがある
個人情報は同意文と一緒に受け取る同意文の正本(shared/privacy/)と検査(privacy-consent-check)。マネビタ名義のサイトは公開前に必ず通すPマーク。同意文は1字も変えない。フォームの種類を問わず対象
権限は小さく、場所は限定して動かすPC は worktree の中だけ編集できる(母艦への書き込みは止まる)。鍵の種類ごとに名前と台帳(docs/ops/api-keys.md)自動モードは本番サーバーへの SSH・ログイン・許可の追加を止める。それでいい。広げるのは人が PC で

※ 事故の実物と経緯は docs/ops/incidents.md。ルールは命令だけを .claude/rules/ に置き、経緯はここに分けてある。

10使う前に知っておくこと

知らないまま使うと、品質が落ちるか事故になる6つ。「詳しく」で何が起きるかが出る。

会話には容量の上限がある大事な決まりは会話で言わず、CLAUDE.md やルールに書いて毎回読ませる(図3)。長い作業は区切って新しいセッションで長く話すと古い部分が自動で要約され、途中で言った細かい指示が抜け落ちる
「できました」を信じない画面・URL・数字の実物で確かめるまでが仕事。指示にも「動くのを確かめてから報告して」と入れておくできていなくても完了と報告することがある。確認した画面と、相手の画面が違うこともある
権限のモードを選ぶ最初は「毎回聞く」。止める仕組み(図4)を入れてから自動に広げる「毎回聞く」「編集だけ自動」「全部自動」がある。自動ほど速いが、止める仕組みが無いと何でもできてしまう
使用量に上限がある重い判断だけ Opus、定型は Sonnet、分類や検査は Haiku に振る。集計や変換はスクリプトに任せるサブスクには時間あたりの上限があり、超えると止まる。自動で回している作業も止まる
読ませたものは外に送られる顧客の個人情報・契約上の秘密を読ませてよい範囲を、先に決めておく。鍵は読ませない(図9)Claude に読ませた内容は Anthropic のサーバーに送られて処理される
git が最後の安全網1つの作業が終わるたびにコミットさせる。ここでは CLAUDE.md の決まりとして毎回自動コミットしてあれば、Claude が壊しても前の状態に戻せる。コミットしていない変更は戻せない

※ この環境で実際にあったこと: 長い会話の途中で要約が入った/確認した画面と相手の画面でフォントが違い文字がはみ出した/7月に使用量の上限で記事の自動生成が何度も止まった。