Settings

Access settings via the gear icon in the header.

Settings Tabs

Conta e Uso (Account & Usage)

• Claude.ai account info (email, organization, plan)
• Rate limit tier
• Fetched from local Claude credentials

Custo e Agentes (Cost & Agents)

• Cost dashboard: total USD, turns, tokens, per-agent breakdown
• Model: default model and fallback model
• Max turns: limit per agent session (1-500)
• Max budget USD: auto-stop threshold
• Subagents: enable/disable, limit count, max prompt chars

Limites Internos (Internal Limits)

• Context max characters (1KB-100KB)
• Context window size (10K-1M tokens)

Geral (General)

• Data directory: where workspace data is stored
• Maintenance: clean raw debug logs (freed space shown)
• Auto-update: check and install new versions from npm
• System info: version, Claude CLI path, port

Seguranca (Security)

• PIN: set 4-8 character PIN to protect the web interface
• Authentication via bearer token
• Localhost requests bypass auth (for agent-to-agent delegation)

Notificacoes (Notifications)

• Sound alerts: play sound when agent completes
• Push notifications: browser push when app is minimized/closed

Git Sync

• Manual sync: commit and push data directory
• Auto sync: every 5 minutes (toggle)
• Requires data directory to be a git repo

Runtime Config

All runtime settings are stored in ~/.claudecontrol/config.json and can be changed via API:

# Get current config
GET /api/settings/runtime

# Update config
PUT /api/settings/runtime
{
  "maxTurns": 50,
  "maxBudgetUsd": 5.0,
  "model": "claude-sonnet-4-6",
  "fallbackModel": "claude-haiku-4-5-20251001",
  "enableSubagents": true,
  "subagentLimit": 3,
  "contextMaxChars": 8000,
  "contextWindowSize": 200000
}

Clean Raw Logs

Raw debug logs (JSONL files in raw/ directories) can grow large over time. The "Limpar raw logs" button in Settings → Geral deletes all raw logs across workspaces, showing how many files and MB were freed.

This does NOT affect:

• Agent chat history (stored in logs/)
• Agent sessions (agents.json)
• Attachments