クロードコード – ドキュメントに書かれていない設定可能なすべてのこと

2026年5月29日原文(buildingbetter.tech)

概要

Claude Code の内部許可システム「YOLO Classifier」の詳細解説
ドキュメント未記載の 設定・フック・スキル・エージェント の拡張機能
hooks によるリアルタイム動作変更と自動化例
frontmatter やmemoryなど、公式未公開のパラメータ紹介
バージョン依存性 と実装時の注意点

Claude CodeのYOLO Classifierと未公開機能

内部で YOLO Classifier と呼ばれる自動許可判定システム（yoloClassifier.ts）
設定ファイルで 英語の説明文 を記述するだけで、環境や許容操作を柔軟に指定可能
- 例：「this is a staging server, destructive operations are acceptable」
npmパッケージ としてnode_modulesにソースが含まれ、誰でも中身を確認可能
公式ドキュメント未掲載の フィールド・レスポンス形式・設定項目 が多数存在

バージョン注意

本内容は @anthropic-ai/claude-code@2.1.87 時点の情報
未公開機能は 将来のバージョンで変更・削除される可能性 あり
EXPERIMENTAL付きフィールドは特に不安定扱い

設定ファイル配置・構成

個人設定 ：~/.claude/settings.json
プロジェクト設定 ：.claude/settings.json（git共有可）
スキル ：~/.claude/skills/<name>/SKILL.md または .claude/skills/
エージェント ：~/.claude/agents/<name>.md
フックスクリプト ：~/.claude/hooks/
- スクリプトはchmod +xで実行権限付与

フック（hooks）による高度な自動化

公式ドキュメント未記載 のフックレスポンスフィールド多数
PreToolUse フックでコマンド入力書き換え・自動許可判定などが可能
- 例：updatedInputでgit pushコマンドに--dry-run自動付与
SessionStart フックでファイル監視や初期文脈注入
- 例：現在のgitブランチ・未コミットファイル数を自動取得
PostToolUse フックでツール実行後の出力加工や追加文脈注入
PermissionRequest フックでプログラム的な許可・拒否判定

hooks設定例

PreToolUseでgit pushをdry-run化

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Bash",
      "hooks": [{
        "type": "command",
        "command": "~/.claude/hooks/dry-run-pushes.sh"
      }]
    }]
  }
}

シェルスクリプト例（dry-run-pushes.sh）：

#!/bin/bash
INPUT=$(jq -r '.tool_input.command' < /dev/stdin)
if echo "$INPUT" | grep -q 'git push'; then
  jq -n --arg cmd "$INPUT --dry-run" '{"updatedInput": {"command": $cmd}}'
fi

SessionStartでgit情報・ファイル監視を注入

{
  "hooks": {
    "SessionStart": [{
      "hooks": [{
        "type": "command",
        "command": "~/.claude/hooks/session-context.sh",
        "statusMessage": "Loading project context..."
      }]
    }]
  }
}

シェルスクリプト例（session-context.sh）：

#!/bin/bash
BRANCH=$(git branch --show-current 2>/dev/null)
CHANGES=$(git status --porcelain 2>/dev/null | wc -l | tr -d ' ')
jq -n \
  --arg branch "$BRANCH" \
  --arg changes "$CHANGES" \
  '{ "watchPaths": ["package.json", ".env", "tsconfig.json"], "additionalContext": "Current branch: \($branch). Uncommitted changes: \($changes) files." }'

PreToolUseで読み取り専用コマンドを自動許可

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Bash",
      "hooks": [{
        "type": "command",
        "command": "~/.claude/hooks/auto-approve-readonly.sh"
      }]
    }]
  }
}

シェルスクリプト例（auto-approve-readonly.sh）：

#!/bin/bash
CMD=$(jq -r '.tool_input.command' < /dev/stdin)
if echo "$CMD" | grep -qE '^(ls|cat|echo|pwd|whoami|date|git status|git log|git diff)'; then
  echo '{"permissionDecision": "allow", "permissionDecisionReason": "Safe read-only command"}'
fi

hooks追加プロパティ

once ：一度だけ実行し自動解除（初回セットアップ等に最適）
async ：バックグラウンド実行で処理をブロックしない
asyncRewake ：通常は非同期だが、exit code 2時のみ処理をブロック

スキル・エージェントの未公開frontmatterパラメータ

model ：利用モデル（例：haiku, opus）を指定
effort ：推論深度（low, medium, high, max）
hooks ：スキル有効時のみ作用するフック
agent ：カスタムエージェントへの委譲
disable-model-invocation ：自動起動禁止（/skill-nameのみ有効）
shell ：実行シェル指定（例：bash）

agent用frontmatter追加項目

color ：UIでの色分け（red, orange, yellow, green, blue, purple, pink, gray）
memory ：永続メモリ（user, project, local）
- 例：プロジェクトごとの知識ベース構築
omitClaudeMd ：CLAUDE.mdの指示階層を読み込まない
criticalSystemReminder_EXPERIMENTAL ：毎ターン注入されるシステムリマインダー（実験的）
requiredMcpServers ：必須MCPサーバーパターン指定

まとめ

Claude Code は 公式ドキュメント未掲載 の強力な拡張機能を多数搭載
ソースコード解析 で新たな設定や自動化が可能
hooks・frontmatter を活用することで、 独自のワークフローや安全対策 を実装可能
バージョンアップ時の互換性 に注意しつつ、積極的な活用で開発効率と安全性を大幅向上

ハクソク

クロードコード – ドキュメントに書かれていない設定可能なすべてのこと

概要

Claude CodeのYOLO Classifierと未公開機能

バージョン注意

設定ファイル配置・構成

フック（hooks）による高度な自動化

hooks設定例

hooks追加プロパティ

スキル・エージェントの未公開frontmatterパラメータ

agent用frontmatter追加項目

まとめ

Hackerたちの意見