Claude-Code-Hacks

A running notebook of small tricks, workarounds, and hacks for Claude Code.

⚠️ Read this first: these are temporary workarounds

Claude Code is a fast-moving product. The harness, the slash commands, the hook system, MCP wiring, the way settings are merged — all of it changes regularly, and the gaps that motivate the hacks here usually get filled in by the official harness within weeks or months.

Every entry in this repo should be assumed to have an expiry date. A workaround that was necessary on the day it was written may be obsolete (or actively wrong) by the time you read it. That is why every hack is timestamped — check the date before relying on anything here.

If a hack still works months later, great. If it doesn't, that's the expected outcome: the harness filled the gap, and the workaround is no longer needed.

What this is not

To be clear: this repo has nothing to do with "hacking" Claude Code in any security, exploit, or adversarial sense. "Hack" here means workaround / clever trick in the old hobbyist sense — the kind of thing you'd find in a tips-and-tricks notebook. No jailbreaks, no prompt-injection payloads, no attempts to bypass safety or terms of service. Just small, practical workarounds for everyday friction.

Disclaimer

These hacks may not be best practice, may not be good ideas, and may not be secure. They're things that worked for me at a moment in time. Use your own judgement before applying any of them — especially anything that touches credentials, permissions, hooks, or settings files.

Structure

Each hack lives in its own file under hacks/, named with the date and a short slug:

hacks/YYYY-MM-DD-short-slug.md

Each file contains:

• Date — when the hack was written (and the harness state it applies to)
• Problem — the gap or limitation being worked around
• Workaround — the actual trick
• Expiry signal — what to look for to know the hack is no longer needed

Index

No hacks logged yet.

Contributing (for Daniel)

Describe the procedure in plain language; the cleaned-up writeup goes into a new dated file under hacks/ and gets linked from the index above.