1
2

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

@4q_sano(貴信 佐野)in株式会社フォー・クオリア

Claude Codeを暴走させず、実務の仕組みにするまでの全体地図【9ステップ・全39記事】

1
Last updated at Posted at 2026-07-04

はじめに

この1年ほどで、Claude Code / Codex 関連の記事を70本以上書いてきました。いちばん読まれたのは18万スター超のCLAUDE.mdに学ぶ、Claude Codeを暴走させない運用術で、ありがたいことに200いいねを超えています。

ただ、本数が増えるほど「結局どれから読めばいいのか」が分かりにくくなりました。安全設定の話、CLAUDE.mdの分割、6体のレビューチーム、Fable 5での棚卸し——単発で読むと、つながりが見えません。

そこで、実務運用に関わる記事を選び直し、9つのSTEPに並べ替えました。この記事はその地図です。

シリーズ名は「Claude Code実務運用シリーズ」。合言葉は「暴走させない、から仕組みにするまで。」です。

全部読む必要はありません。 いまの症状に合うSTEPから入ってください。

この記事で分かること

  • Claude Code / Codex を「たまに使うAIツール」から「業務の仕組み」に育てる9ステップ
  • 自分がどのSTEPから読み始めるべきか(症状別の入口)
  • 各記事の役割と読む順番

対象読者

  • Claude Codeを使い始めたエンジニア
  • CLAUDE.md / AGENTS.md が長くなって困っている人
  • カスタムコマンドを作りたい人
  • MCP連携を実務で使いたい人
  • Fable 5やSkillを実務でどう使うか知りたい人
  • AIエージェントを安全に業務導入したい人

このシリーズの方針:プロンプト集は配らない

このシリーズで配るのは「便利なプロンプト」ではなく、設定ファイル・指示ファイル・コマンド定義・エージェント定義という成果物です。

プロンプトは会話が終われば消えます。ファイルはリポジトリに残り、チームで共有でき、レビューでき、Fable 5に棚卸しさせることもできます。「AIの運用をファイルで管理する」が全STEPに共通する考え方です。

流れは4フェーズです。

フェーズ やること STEP
止める 危険な操作を最初に封じる 1
整える 指示ファイルとガードレールを整備する 2〜3
任せる 定型作業をコマンド・レビュー・エージェントに任せる 4〜6
仕組みにする 外部ツールと接続し、棚卸しし、Skillとして固定する 7〜9

あなたはどこから読むべきか

いまの症状 入口
昨日Claude Codeをインストールした STEP 1 から順に
CLAUDE.md / AGENTS.md が100行を超えて、メンバーに無視され始めた STEP 2
「勝手にgit pushされないか」が不安で自動化に踏み切れない STEP 1 → 3
コードレビューをAIに任せたいが、1体だと見落としが多い STEP 5
毎週・毎日、同じ作業を同じ指示でAIにやらせている STEP 6 → 9
RedmineやCrashlyticsなど業務システムとつなぎたい STEP 7
Fable 5を何に使えばいいか分からない STEP 8

コース別の読む順

初心者コース(7本) — まず安全に、最初の自動化まで

STEP 1(安全設定 → 運用術) → STEP 4(標準Skill) → STEP 9(document-skills)
→ STEP 4(レビュー自動化 第1弾 → 第2弾) → STEP 7(Playwright導入)

実務者コース(9本) — チームで運用に乗せる

STEP 2(分割基準 → 自衛策) → STEP 3(安全ルール → セキュリティ常駐)
→ STEP 5(6体チーム → 3層振り分け) → STEP 7(MCP比較 → Chrome接続)
→ STEP 8(Fable 5で棚卸し)

上級者コース(8本) — エージェント組織を設計する

STEP 6(思想 → チケット駆動 → 競合分析 → 週報) → STEP 5(3層 → 企画レビュー)
→ STEP 8(設計調査AI → 棚卸し)

Codexユーザーは、STEP 3のAGENTS.md回とSTEP 5のCodex Skill回を並走してください。考え方はClaude Codeと共通です。

STEP 1: 安全に使う

自動化の話は、止める仕組みを入れてからです。最初の1時間でやることは2つ:settings.jsonで機械的に拒否する(設定)、CLAUDE.mdで行動原則を渡す(指示)。

STEP 2: 指示ファイルを整理する

CLAUDE.md / AGENTS.md は運用すると必ず膨らみます。膨らんだ指示ファイルはAIにもチームにも無視される、が実感です。

STEP 3: ガードレールを作る

STEP 1が「止める」なら、ここは「事故りにくくする」です。静的なルール追記と、動的なレビュー役の常駐を組み合わせます。

STEP 4: カスタムコマンド化する

毎回チャットで指示している定型作業は、コマンドにすると再現性が出ます。自作の前に、公式が用意しているものを知っておくと近道です。

STEP 5: レビュー自動化する

シリーズの中核です。1体のAIに全部レビューさせると観点が混ざって見落とします。責務を分割し、リスクに応じて方式を切り替えます。

STEP 6: サブエージェント化する

レビューだけでなく、開発フロー全体を役割分担させる段階です。テクニックより先に、思想編から読んでください。

STEP 7: MCPで外部ツールと接続する

エージェントの手足を増やす段階です。ブラウザ系と業務システム系に分けて読んでください。接続を増やすほど、STEP 1の安全設定が効いてきます。

ブラウザ系:

業務システム系:

STEP 8: Fable 5で運用を棚卸しする

ここは新モデルの紹介ではありません。STEP 1〜7を実践すると、設定・指示ファイル・コマンドが必ず増えて矛盾が出ます。Fable 5の使い所は、その運用資産の棚卸しと再設計だと考えています。

棚卸しで「毎回同じ指示をしている」と分かった作業が、次のSTEP 9でSkillになります。

STEP 9: Skill化して再利用可能にする

仕組みの最終形です。ワークフローをSkillとして固定すれば、指示ゼロで再実行でき、他人にも配れます。

番外編:シリーズを支える土台

よくある質問

Q1. CLAUDE.mdとAGENTS.md、どちらを書けばいいですか?
両方使うなら中身を共通化して、置き場所だけツールに合わせるのが現実解です。対応関係はCodex版の回に表でまとめています。

Q2. チーム導入は何から始めるべきですか?
個人の安全設定(STEP 1)→ 指示ファイルの分割(STEP 2)→ レビュー自動化(STEP 5)の順をすすめます。いきなりエージェント組織(STEP 6)から入ると、事故ったときに原因が切り分けられません。

Q3. どこまで自動化しても安全ですか?
基本線は「読む系は自動、書く系・外に送る系は確認を挟む」です。具体的な権限設計はSTEP 1の安全設定と、STEP 7のChrome操作の回で扱っています。

Q4. Fable 5と普段のモデルはどう使い分けていますか?
日常の実装はOpus/Sonnet、大規模な調査・設計・運用の棚卸しはFable 5です。理由はSTEP 8の1本目に書きました。

Q5. Codexユーザーです。どう読めばいいですか?
考え方は全STEP共通です。Codex固有の実装はAGENTS.md運用術とCodex Skill回の2本にまとめています。

まとめ

  • Claude Codeの実務運用は「止める → 整える → 任せる → 仕組みにする」の順で進めると事故が少ない
  • 配るべきはプロンプトではなく、設定・指示ファイル・コマンド・エージェント定義という成果物
  • この記事は入口です。症状に合うSTEPから読み始めて、迷ったらここに戻ってきてください
1
2
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
1
2

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?