Configuration

.claude/settings.json

Hooks and permissions for Claude Code.

What this file controls

  • Hooks, shell commands that run on Claude events (UserPromptSubmit, PreToolUse, etc.)
  • Permissions, auto-allow/deny rules for tools and commands
  • Additional directories, folders outside the workspace Claude is allowed to access

Example written by larkx init

json
{
  "hooks": {
    "UserPromptSubmit": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "echo 'IMPORTANT: For any code navigation in this project, always use larkx MCP tools first...'",
            "shell": "bash"
          }
        ]
      }
    ]
  },
  "permissions": {
    "allow": ["mcp__larkx__search_symbol"]
  }
}

See: UserPromptSubmit hook explained