Settings
Claude Code harness configuration in settings.json covering tool permissions, hook wiring, environment variables, and status-line templates.
settings.json carries the Claude Code harness configuration: hook wiring,
tool permissions, environment variables, and status-line settings.
The full canonical reference lives at settings-reference.md. This page summarizes the contract and points at the deeper reference.
Sections
| Section | Purpose |
|---|---|
permissions | Tool whitelists and blacklists per matcher |
hooks | Event-keyed hook command table (the canonical wiring) |
env | Per-session environment variables |
statusLine | Status-line template the host renders |
Single-template invariant
The Claude Code adapter ships one settings.json template. Hook commands use
exec form (command plus args) instead of shell-specific command strings, so
cross-OS behavior is reviewed inside one file. New permission entries and hook
events land in that file atomically.
MCP servers
Model Context Protocol server configuration — operator-owned and registered through each tool's native MCP mechanism; Apothem syncs the inventory from the shared profile but authors no server entries.
settings.json Documentation
Configure Claude Code hook execution, permissions, events, timeouts, Python runtime, validation, and layered settings precedence for the Apothem ecosystem.