32 lines
1.7 KiB
Markdown
32 lines
1.7 KiB
Markdown
---
|
||
summary: Claude Code's non-deferred built-in tool schemas cost ~18k tokens/session; the Workflow schema alone is ~6k, and a permissions.deny block in settings.json removes unused tools' schemas entirely (measured −6.5k for four never-used tools).
|
||
tags:
|
||
- type/reference
|
||
- tool/claude-code
|
||
scope: global
|
||
type: reference
|
||
source: cc-os docs/plans/b2-profile-overlays.md (follow-on section, 2026-07-08)
|
||
date: 2026-07-08
|
||
last_updated: 2026-07-08
|
||
---
|
||
|
||
# Claude Code tool schemas: where the ~18k goes, and the YAGNI deny lever
|
||
|
||
Measured 2026-07-08 (headless haiku, `--output-format json` usage totals).
|
||
|
||
- The ~29k empty-dir context floor = ~6.3k system-prompt text + **~18k built-in tool
|
||
schemas** + ~4.8k user stack. ToolSearch deferral only covers the optional tier
|
||
(Cron, LSP, NotebookEdit, Monitor, web tools…) — core schemas ship every request.
|
||
- **Workflow's schema alone is ~6k tokens** (−5,982 when disallowed) — about the size
|
||
of the entire system-prompt text.
|
||
- `"permissions": {"deny": ["Workflow", ...]}` in `~/.claude/settings.json` removes the
|
||
denied tools' schemas from context, identical to `--disallowedTools` (22,532 vs
|
||
22,536 measured) — so a global deny needs no wrapper or flags.
|
||
- Ground truth for "which tools do I actually use": count `tool_use` names across
|
||
`~/.claude/projects/**/*.jsonl` transcripts. Five weeks of data (2026-06→07) showed
|
||
zero-or-one lifetime calls to Workflow, Artifact, SendUserFile, ReportFindings →
|
||
denied globally (−6.5k/session). Revert by removing the deny entry if Workflow
|
||
("ultracode" multi-agent orchestration) is ever wanted.
|
||
|
||
Related: [[claude-code-setting-sources-silent-plugin-drop]], [[cc-os-hub]]
|