前提:執筆者の担当業務
執筆者の市野は、当社のデータ戦略部に所属するデータエンジニアです。データ戦略部では、自社プロダクト3つのデータを横断して担当しています。
主な業務は次のとおりです。
- 各システムのデータ基盤の構築とメンテナンス
- BigQuery でのデータ集計と分析
- 契約企業向けのダッシュボードやレポートの作成
- 法人ユーザーのアカウントの追加・停止
- アプリのイベントや通知の対象者の抽出
- クラウド費用の確認と見直し
- 社内のAI活用の基盤づくり
今回の事例で獲得した成果
- Claude Code が Backlog の依頼文を読み、要所で承認を求めながら、作業を自分で進めるようになりました。人は決められた場面で承認するだけになり、作業の進み具合の管理と安全面の確認に集中できます。
- 新しい案件も、フォルダを作って CLAUDE.md の冒頭ブロックを書けば同じ流れに乗ります。案件が増えても、担当が変わっても、同じ手順で再現できます。
- ガードレールを3つの層で作ったため、AIに任せる作業を増やしても、事故につながる操作は止まるか、人の承認を通ります。
取り組んだ課題
上に挙げた業務の依頼は、社内の各部署から Backlog の課題としてデータ戦略部に集まります。Claude Code に作業を任せるにあたって、課題は2つありました。
- 実行:依頼の種類がばらばらで、案件ごとに読ませる手順書も違う。案件が増えると、どの依頼にどの手順を使うかを人が覚えておく必要があった。
- ガードレール:本番のデータや法人ユーザーのアカウントを扱うので、AIが誤って実行したときの影響が大きい。どこまで任せるかを毎回その場で決めていて、止める場所が人の記憶に頼っていた。
実施内容の概要
Backlog の課題を入口にして、実行とガードレールの2つの面から仕組みを作りました。
利用環境
- Claude Code(ターミナル)、macOS
- Backlog と BigQuery は MCP で接続
- データ業務のフォルダは GitHub のリポジトリで管理
実行:種類の違う依頼を同じ手順で回す
依頼から記録までの流れ
朝に「タスクを整理して」と頼むと、仕分けのスキルが動きます。
- 取得:Backlog から未完了の課題を取得する
- 仕分け:課題のタイトルと案件の keywords を照らして、読む CLAUDE.md を決める。当たる案件がなければ、フォルダを作るよう人に提案する
- 承認:AIが行う課題を、作るものと読む CLAUDE.md を並べて一覧にし、人が承認する
- 実行:課題ごとに別のエージェントを立てて並行して進める。各エージェントは担当する案件の CLAUDE.md だけを読む
- 記録:結果を Backlog にコメントし、承認を得てステータスを更新する
起票先や期限日の入れ方など、Backlog を扱うときの決まりもこのスキルにまとめ、CLAUDE.md を短く保っています。
フォルダの構成
CLAUDE.md は、Claude Code が起動時に読む指示書です。起動したフォルダと、その上のフォルダにある CLAUDE.md がすべて読み込まれます。スキルは決まった手順をまとめたもので、.claude/skills/ に置きます。
作業フォルダ/
├── CLAUDE.md … 全員共通の決まり
├── 日々の業務/
│ └── .claude/skills/ … 朝の仕分け、週報などのスキル
└── データ業務/ … GitHub のリポジトリ
├── CLAUDE.md … 全体のルール、案件に書く項目、チェックの仕組み
├── .gitignore … 認証情報や実行時のログを除外
├── tools/
│ └── check_claude_md.py … 案件の CLAUDE.md のチェック
├── .claude/
│ ├── 個人用の設定ファイル … 許可の設定と hook(ガードレールの節で説明)
│ └── skills/ … データ業務で繰り返す作業のスキル
└── projects/
├── 202611_費用の見直し/
│ ├── CLAUDE.md … 冒頭ブロックと手順
│ └── sql/ python/ shell/ data/ docs/
└── 法人アカウント/
├── CLAUDE.md … 取引先に共通の決まり
├── .claude/skills/ … 取引先に共通の手順のスキル
└── 取引先A/CLAUDE.md
フォルダの作り方
- 案件や、Backlog で起票した課題の単位でフォルダを作り、CLAUDE.md を置きます。
- アカウント改廃のように繰り返し行う作業は、依頼のたびに新しいフォルダを作りません。決まったフォルダの CLAUDE.md とスキルで処理します。
CLAUDE.md に書く決まり
CLAUDE.md は3つの階層に分けています。上の階層ほど、すべてのセッションで読み込まれるので、短く、全体に共通することだけを書きます。
| 階層 | 書くこと |
|---|---|
| 作業フォルダ(全員共通) | 資料の書式、本番作業の役割分担、設定ファイルの効く範囲、MCP の接続 |
| データ業務 | 全体のルール(作業の3段階など)、案件の CLAUDE.md に書く項目、チェックの仕組み。個別の案件のことは書かない |
| 案件 | 冒頭ブロック、概要、確定した手順、着手前に確認すること、成果物の一覧 |
案件の CLAUDE.md の先頭には、次の冒頭ブロックを置きます。
---
keywords: [費用の見直し, コスト]
ai_scope: 通常
ai_scope_note: "自動:請求の集計・分析。人:リソースの変更"
status: 進行中
---
keywords は課題のタイトルに出てくる言葉で、仕分けのときに課題と案件を結び付けます。ai_scope と ai_scope_note は、その案件でAIを止める場所を決めます(ガードレールの節で説明)。status を「完了」にすると、仕分けの対象から外れます。
git での管理
- CLAUDE.md、スキル、SQL、スクリプト、チェック用のスクリプトを git で管理し、決まりを変えた履歴を追えるようにしています。
- 認証情報、実行時のログ、個人用の設定ファイルは
.gitignoreで除外しています。push は毎回確認で止めています。
ガードレール:3つの層で止める
ここまでの流れで動く Claude Code を、どう止めているかを説明します。土台は、データ業務の CLAUDE.md に書いた全案件共通の「作業の3段階」です。
- Claude が自分で進めてよい:読み取り、クエリ・スクリプト・資料の作成、試しの実行
- 承認を得てから Claude が実行する:Backlog の更新、git の push、手順が確立した本番作業(アカウントの停止、マスタの更新など)、許可した有料 API
- 人が実行する:社外への送信、手順が確立していない本番への反映、削除、クラウドのリソースの変更
この3段階を、次の3つの層で守っています。
| 層 | 役割 |
|---|---|
| 1. 設定ファイル(settings.json) | 仕組みで止める。AIが何を判断しても破れない |
| 2. CLAUDE.md | 設定ファイルで止めきれない部分を、ルールで補う |
| 3. チェック | 案件の CLAUDE.md が決まった形から外れないようにする |
1. 設定ファイル(settings.json)で止める
Claude Code は、.claude/settings.json で、操作ごとに3つの区分を決められます。
- deny(禁止):承認があっても実行できない
- ask(毎回確認):実行の前に毎回止まり、人が承認したら実行する
- allow(許可):確認なしで実行する
deny と ask は自動で進めるモードでも効き、deny、ask、allow の順に優先されます。
settings.json は、置く場所によって読まれる条件が違います。今回、次の2か所に分けて置きました。
ホームフォルダ/
└── .claude/
└── settings.json … ユーザー全体の設定。どこで起動しても読まれる
deny と ask:送信、秘密情報、本番、削除、push など
作業フォルダ/
└── データ業務/ … GitHub のリポジトリ
└── .claude/
└── 個人用の settings … リポジトリの中のどこで起動しても読まれる
allow と ask:データ業務だけで使う操作、hook
置き場所を分けたのは、Claude Code の読み込み方に理由があります。
- 共有用の
.claude/settings.jsonは、起動したフォルダのものしか読まれません。上のフォルダまですべて読まれる CLAUDE.md とは違い、案件のフォルダで起動すると効きません。 - 個人用の settings(settings と .json の間に local を挟んだ名前のファイル)は、リポジトリの中で起動すると、リポジトリ直下のものが読まれます。そのため、データ業務の設定はここに置き、git からは除外しています。
ホームフォルダの settings.json の書き方は、たとえば次のとおりです(一部を抜き出しています)。
{
"permissions": {
"deny": [
"mcp__claude_ai_Gmail__send_message",
"Read(~/.ssh/**)",
"Bash(mysql *)"
],
"ask": [
"Bash(git push *)",
"Bash(bq query*INSERT *)"
]
}
}
データ業務の個人用の settings には、BigQuery の参照や管理サーバーでの確認など、データ業務でだけ使う操作を allow に、アカウント停止やマスタ更新のスクリプトを ask に書いています。
2つのファイルは組み合わせて働きます。BigQuery のクエリはデータ業務の設定で allow ですが、INSERT などを含むクエリはホームフォルダの設定で ask です。ask が優先されるので、書き込みのときだけ止まります。
3段階との対応は、段階1が allow かどこにも書かない、段階2が ask、段階3が deny です。ただし、本番サーバーへの接続などは段階3でも ask にしています。段階2の本番作業と同じ形のコマンドなので、deny にすると段階2の作業までできなくなるためです。
設定を変えるのは人です。Claude Code が自分で deny や ask を外そうとすると、その操作自体が止められます。
2. CLAUDE.md で補う
設定ファイルは、コマンドの文字列で判断します。そのため、次のような経路や区別は、文字列だけでは止めきれません。
- サーバーに接続してから、サーバーの上でデータベースを操作する
- スクリプトの中からデータベースに接続する
- BigQuery への書き込みを、判定に引っかからない書き方で実行する
- ask で止まる操作のうち、承認してよい作業と、人が実行すべき作業の区別
この部分は CLAUDE.md のルールで補います。本番データベースへの書き込みは人が行うこと、BigQuery への書き込みは実行前に会話で承認を取ること、ブラウザの操作は始める前にどこまで進めるかを確かめることを決めています。
さらに、案件の CLAUDE.md の冒頭ブロックで、その案件の扱いを決めます。
- 通常:作業の3段階どおりに進める
- 慎重:段階1の作業も、1つ進めるたびに承認を取る
- 停止:作業しない
この区分は、3段階を厳しくする方向にだけ使います。2026年11月19日時点で、動いている案件27件のうち、通常が14件、慎重が13件です。慎重にしているのは、法人アカウントの改廃など、取り違えると影響が大きい案件です。
3. チェックで形を保つ
- スクリプトが、すべての案件の CLAUDE.md の冒頭ブロックと章立てを確かめます。
- 案件の CLAUDE.md を書き換えると、データ業務の個人用の settings に書いた hook が同じチェックを自動で行い、エラーがあれば Claude Code がその場で直します。
取り違えを防ぐ手順
法人アカウントの停止では、取り違えると在籍者を誤って停止してしまいます。取引先ごとに、在籍者の全件と突き合わせるか、依頼された分だけを処理するかを CLAUDE.md に書き、停止の件数が想定より多いときは依頼元に確かめてから進めます。
結果と検証条件
| 項目 | 内容 |
|---|---|
| 実施企業 | 株式会社アリストル |
| 対象 | データ戦略部に Backlog で集まる依頼 |
| 期間 | 2026年6月〜(運用中) |
| 作業時間(法人アカウントの改廃) | 1社あたり約2時間 → ほぼ0(人は承認するだけ)。改廃は月に7件ほど |
作業時間は、効果がわかりやすい法人アカウントの改廃を例に集計しました。値は担当者の実感によるもので、作業ごとに計測したものではありません。この結果は当社の取り組みの記録です。同じ方法で同じ結果が得られることを示すものではありません。
うまくいかなかったこと・適用上の限界
- 設定ファイルはコマンドの文字列で判断するため、サーバーやスクリプトを経由した操作は止めきれません。この部分は CLAUDE.md のルールと、ask で止まったときの人の判断に頼っています。
- データ業務の設定と hook は、git で管理しない個人用の settings に置いているため、PCごとに入れる必要があります。
- 作業フォルダの一番上の CLAUDE.md と日々の業務のスキルは、まだ git で管理していません。PCが壊れると失われます。
他の企業で検討する際のポイント
- 全体の CLAUDE.md には個別の案件の情報を書かず、案件ごとの CLAUDE.md に分ける。全体の CLAUDE.md はすべてのセッションで読み込まれます。
- AIに任せる範囲と、課題と結び付ける言葉は、案件の CLAUDE.md の冒頭に決まった形で書く。スクリプトで集めて仕分けに使え、チェックもできます。
- 「Claude が自分で進めてよい」「承認を得てから Claude が実行する」「人が実行する」の3段階を、settings.json と CLAUDE.md の両方に書く。設定だけでは止めきれない経路があり、文章だけでは読み違えたときに止まりません。
- どこで起動しても止めたい操作は、ホームフォルダの settings.json の deny と ask に書く。上のフォルダに置いた共有用の settings.json は、下のフォルダで起動すると読まれません。
