インターン・新入社員向けセットアップ

適用面: コーディングアシスタントフック 対応モード: Local Hosted Hybrid プラン: Free Solo Teams

対象読者

新しく参加した方、つまりインターン、新入社員、またはコードベースを学んでいる方が対象です。AI ツールを使って素早く進めたい一方で、慣れるまでの間に、本番環境を誤って壊したり、間違ったものを削除したり、シークレットを漏らしたりすることがないと確信したい方に向けています。

通常統制したい対象

• 破壊的な操作は一切なし。 削除も、force-push も、本番への書き込みもできません。
• 読み取りは自由。 コードやデータは好きなだけ調べられます。
• ミスは咎められず、捕捉される。 ブロックされた操作はガードレールであり、失敗ではありません。

インストールする適用面

AI コーディングアシスタントの前段に置くコーディングフックです。Claude Code、Gemini CLI、Cursor IDE、Kiro CLI では、拒否によってツール呼び出しが実行前に停止されます。チームですでにポリシーを一元管理している場合は、代わりに管理者にノート PC の登録を依頼してください。チームのポリシーが自動的に適用されます。

controlzero install claude-code

スターターポリシー

すべてを読み取れる一方で、危険な変更はできないサンドボックスです。フックはアシスタントの呼び出しを正規名に正規化します。ファイルの読み取りは file_read:read、検索は file_search:search、シェルコマンドは Bash:<command> になります。このポリシーは安全なものを許可し、破壊的なものをブロックします。~/.controlzero/policy.yaml に置いてください（インストーラーに作成させて、中身を置き換えても構いません）。

version: '1'
settings:
  default_action: deny
  default_on_missing: deny
  default_on_tamper: warn
rules:
  - id: allow-file-read
    allow: 'file_read:read'
    reason: 'Reading and exploring files is always fine.'
  - id: allow-file-search
    allow: 'file_search:search'
    reason: 'Searching the codebase is safe.'
  - id: allow-safe-shell
    allow:
      - 'Bash:ls'
      - 'Bash:cat'
      - 'Bash:grep'
      - 'Bash:git'
    reason: 'Read-only shell commands are fine for learning.'
  - id: allow-db-read
    allow: 'database:read'
    reason: 'SELECT queries are fine for learning.'
  - id: deny-rm
    deny: 'Bash:rm'
    reason: 'Deletes are blocked while you learn the ropes.'
  - id: deny-db-changes
    deny: 'database:write'
    reason: 'No data changes from a learning sandbox.'
  - id: deny-db-admin
    deny: 'database:admin'
    reason: 'No schema or permission changes.'

英語の原文 -- 翻訳は技術レビュー待ちです

This policy denies anything not explicitly allowed, so it is safe by default.

許可ルールにはフックが出力する正規名そのものを使っているので、読み取りや検索は実際に通ります。慣れてきたら、チームからより広いポリシーを渡してもらえます。

確認できる内容

• ご自身（またはアシスタント）がブロックされた操作を試みると、「Deletes are blocked while you learn the ropes.」のような明確な理由とともに停止します。悪いことは何も起きません。それがガードレールの働きです。

英語の原文 -- 翻訳は技術レビュー待ちです

• Every decision and its coverage is logged. The trail distinguishes a blocked action that did not run from an allowed action that ran and found nothing. Watch it live to learn what your tools actually do:

  controlzero tail

ブロックされた操作が、あなたの評価に影響することはありません。ガードレールが役目を果たしたということです。ポリシーによってブロックされる正当な必要が生じたときは、チームにポリシーを広げてもらうよう依頼してください。

次のステップ

• Claude Code、Cursor、Codex CLI、Gemini CLI を統制する -- コーディングフックの完全なガイドです。
• 読み取り専用データベース -- 読み取り/書き込み/管理の区分を理解します。
• クイックスタート -- Control Zero が最初から最後までどのように動作するかを説明します。
• 監視のみのセットアップ -- 何もブロックせず、最初は観測したい場合に。