🤖 Claude Code 機能ガイド（〜2026年4月版）¶

{
  "effortLevel": "low|medium|high|xhigh",
  "alwaysThinkingEnabled": true,
  "showThinkingSummaries": true,
  "availableModels": ["sonnet", "haiku"],
  "modelOverrides": {
    "claude-opus-4-7": "arn:aws:bedrock:..."
  }
}

{
  "viewMode": "default|verbose|focus",
  "tui": "fullscreen|default",
  "autoScrollEnabled": false,
  "showTurnDuration": true,
  "spinnerTipsEnabled": true,
  "awaySummaryEnabled": true,
  "prefersReducedMotion": false,
  "terminalProgressBarEnabled": true
}

{
  "autoMemoryEnabled": true,
  "autoMemoryDirectory": "~/my-custom-memory-dir"
}

{
  "worktree": {
    "symlinkDirectories": ["node_modules", ".cache"],
    "sparsePaths": ["packages/my-app"]
  },
  "plansDirectory": "./plans",
  "claudeMdExcludes": ["**/other-team/CLAUDE.md"],
  "cleanupPeriodDays": 30
}

{
  "sandbox": {
    "network": {
      "allowedDomains": ["github.com", "*.npmjs.org"],
      "deniedDomains": ["sensitive.internal.com"]
    },
    "filesystem": {
      "allowWrite": ["/tmp/build"],
      "denyRead": ["~/.aws/credentials"]
    }
  }
}

{
  "permissions": {
    "allow": ["Bash(git:*)", "Read"],
    "ask": ["Bash(git push *)"],
    "deny": ["Bash(rm -rf *)"],
    "defaultMode": "acceptEdits",
    "additionalDirectories": ["../docs/"]
  }
}

{
  "autoUpdatesChannel": "stable|latest",
  "minimumVersion": "2.1.100"
}

// コマンド実行（従来）
{ "type": "command", "command": "./hooks/my-script.sh" }

// MCPツールを直接呼び出し
{
  "type": "mcp_tool",
  "server": "my-server",
  "tool": "security_scan",
  "input": {"file_path": "${tool_input.file_path}"}
}

// HTTPリクエスト
{
  "type": "http",
  "url": "http://validator:8080/check",
  "headers": {"Authorization": "Bearer $TOKEN"},
  "allowedEnvVars": ["TOKEN"]
}

// サブエージェントに委譲
{
  "type": "agent",
  "prompt": "このファイル変更を検証: $ARGUMENTS"
}

{
  "matcher": "Bash",
  "hooks": [{
    "type": "command",
    "if": "Bash(rm *)",
    "command": "./hooks/block-rm.sh"
  }]
}

✅ PostToolUse (Bash) → コマンドのプレフィックスを自動で allowlist に追加
✅ PreToolUse (Write) → 機密ファイルへの書き込みをブロック
✅ PostCompact → コンパクション後に要約をSlack通知
✅ FileChanged (.envrc) → 環境変数変更を検知して自動リロード
✅ PermissionRequest → CIでの自動承認（危険なコマンドは除外）

{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "@my-org/my-mcp-server"],
      "alwaysLoad": true,
      "env": {
        "API_TOKEN": "${MY_API_TOKEN}"
      }
    }
  }
}

---
name: researcher
description: Webリサーチと情報収集を担当するエージェント
model: claude-haiku-4-5
tools: [WebFetch, WebSearch, Read]
---
調査担当エージェントです。リサーチ要件を受け取り、
情報を収集して要約します。

---
name: secure-agent
description: セキュリティ検査専門エージェント
model: claude-sonnet-4-6
mcpServers:
  - security-scanner
hooks:
  - type: "prompt"
    handler: "audit_log"
---

# スラッシュコマンドで自然言語指定
/schedule daily PR review at 9am

# または claude.ai/code/routines で管理

✅ 毎朝：GitHubの未解決Issueをスキャンして優先度付けしSlack通知
✅ PR作成時：自動コードレビューを実行してコメント投稿
✅ 毎週月曜：依存ライブラリの脆弱性チェックレポート生成
✅ One-off：リリース2週間後にフィーチャーフラグ削除PRを自動作成

~/.claude/projects/<project-path>/memory/
├── MEMORY.md          # インデックス（先頭200行がセッション開始時に自動ロード）
├── user_profile.md    # ユーザー情報
├── feedback_*.md      # フィードバック記録
├── project_*.md       # プロジェクト状況
└── reference_*.md     # 外部リソースへのポインタ

{
  "autoMemoryEnabled": true,
  "autoMemoryDirectory": "~/.claude/projects/custom-memory"
}

{
  "permissions": {
    "allow": ["Bash(git:*)", "Read", "Write"],
    "ask": ["Bash(git push *)", "Bash(npm publish *)"],
    "deny": ["Bash(rm -rf *)"]
  }
}

# セッション内で切り替え
/effort
# ↑ 矢印キーでinteractiveに選択

<!-- このコメントはAIのコンテキストに注入されない（人間向けメモに使える） -->

# プロジェクトルール

@path/to/shared-rules.md  <!-- 別ファイルをインクルード -->

# .claude/rules/python.md のフロントマター
---
paths: ["**/*.py", "**/*.pyi"]
---
Pythonコードには型ヒントを必ず付けること。

OTEL_LOG_RAW_API_BODIES=1  # APIボディ全体をデバッグ出力

✅ .claude/rules/ でルールをファイル別に分割
✅ paths フロントマターでファイルタイプ別に適用
✅ HTMLコメントで人間向けメモを残す
✅ @インクルードで共通ルールを再利用
✅ claudeMdExcludes でモノレポの不要なCLAUDE.mdを除外

✅ PostToolUse(Bash) でコマンドを自動 allowlist 追加（このプロジェクトで実装済み）
✅ PreToolUse で危険な操作をブロック
✅ PermissionRequest で CI での自動承認を実装
✅ FileChanged で .env 変更を検知して通知

✅ 単純タスクには Haiku を指定してコスト削減
✅ ツールアクセスを必要最小限に制限（セキュリティ）
✅ description を具体的に書いてルーティング精度を上げる
✅ 独立タスクは並列サブエージェントで分散処理

✅ MEMORY.md のインデックスを200行以内に保つ
✅ 記憶タイプを正しく分類（user/feedback/project/reference）
✅ feedback 記憶には Why: と How to apply: を必ず記述
✅ 古くなった記憶は定期的に /memory で整理

✅ 単純タスクは effort: low に下げる
✅ MCP の alwaysLoad は使用頻度の高いサーバーのみに絞る
✅ /usage で定期的にコスト確認
✅ サブエージェントで重いタスクをコンテキスト保護しながら処理
✅ Routines でオフピーク時間帯に重い処理をバッチ実行

✅ permissions.ask で重要な操作（push, publish）は必ず確認
✅ sandbox.network で allowedDomains を明示
✅ 認証情報は Credentials/ に集約し Git 管理外に（このプロジェクト設定済み）
✅ disableBypassPermissionsMode でバイパスを封鎖（エンタープライズ向け）