Claude Token Efficient — Drop-in CLAUDE.md for Terse Output
A single CLAUDE.md file that reduces Claude Code output verbosity by 63%. Includes 5 specialized profiles for coding, benchmarks, agents, and analysis workflows.
What it is
Claude Token Efficient is a CLAUDE.md configuration file that reduces Claude Code output verbosity by 63%. It includes 5 specialized profiles for different workflows: coding, benchmarks, agents, and analysis. You drop it into your project root and Claude Code automatically follows the terse output instructions.
It is designed for developers who want Claude Code to be concise and efficient rather than verbose, saving tokens and reducing noise in the output.
How it saves time or tokens
The primary purpose is token reduction. By instructing Claude Code to prefer editing over rewriting, avoid re-reading files, and be concise in output, the CLAUDE.md reduces token consumption by approximately 63% according to the author's benchmarks. Less verbose output also means faster reading and less scrolling for developers.
How to use
- Download the CLAUDE.md file to your project root
- Claude Code automatically reads CLAUDE.md when starting a session
- Choose a profile by mentioning it in your prompt, or use the default terse mode
Example
# Download and add to your project root
curl -o CLAUDE.md https://raw.githubusercontent.com/drona23/claude-token-efficient/main/CLAUDE.md
The CLAUDE.md includes directives like:
Approach
- Think before acting. Read existing files before writing code.
- Be concise in output but thorough in reasoning.
- Prefer editing over rewriting whole files.
- Do not re-read files you have already read unless the file may have changed.
- Use precise, minimal diffs when editing.
Output Rules
- No preamble. No summary unless asked.
- Code only when code is the answer.
- One-line answers when a one-line answer suffices.
Related on TokRepo
- AI Tools for Coding -- Developer tools for AI-assisted programming
- Prompt Library -- Curated prompts and configuration templates
Common pitfalls
- The terse mode can be too concise for complex tasks where you need Claude to explain its reasoning; switch to the analysis profile for those cases
- If your project already has a CLAUDE.md, you need to merge the directives rather than overwriting
- The 63% reduction claim is based on the author's benchmarks and may vary depending on your task types
Frequently Asked Questions
Yes. CLAUDE.md is a standard Claude Code feature. Any version of Claude Code that reads project-level CLAUDE.md files will pick up these directives automatically when you start a session in the project directory.
Yes. The CLAUDE.md is a plain Markdown file. Edit the directives, add new profiles, or remove ones you do not need. The file is self-documenting with comments explaining each section.
No. The directives control output verbosity, not reasoning depth. Claude Code still thinks thoroughly but expresses results concisely. Code quality and correctness are not impacted.
Mention the profile name in your prompt, such as 'use the benchmarks profile for this task'. The CLAUDE.md defines profile-specific behavior that activates based on context.
CLAUDE.md is specific to Claude Code. Other tools like Cursor use different configuration mechanisms. However, you can adapt the principles to .cursorrules or similar tool-specific config files.
Citations (3)
- Claude Token Efficient GitHub— CLAUDE.md file that reduces output verbosity by 63%
- Anthropic Documentation— CLAUDE.md is read automatically by Claude Code
- Claude Token Efficient README— 5 specialized profiles for different workflows
Related on TokRepo
Source & Thanks
Created by Drona Gangarapu. Licensed under MIT.
claude-token-efficient — ⭐ 3,100+
Thank you for helping developers save tokens and get more concise AI responses.
Discussion
Related Assets
Conda — Cross-Platform Package and Environment Manager
Install, update, and manage packages and isolated environments for Python, R, C/C++, and hundreds of other languages from a single tool.
Sphinx — Python Documentation Generator
Generate professional documentation from reStructuredText and Markdown with cross-references, API autodoc, and multiple output formats.
Neutralinojs — Lightweight Cross-Platform Desktop Apps
Build desktop applications with HTML, CSS, and JavaScript using a tiny native runtime instead of bundling Chromium.