by shareAI-lab · shareAI-lab/learn-claude-code
Reverse-engineered, readable harness for Claude Code in bash — the 'nand2tetris' version of an AI coding agent.
Learn Claude Code is a teaching artifact: a working bash-implemented agent harness that mimics Claude Code's loop. The skill packages it so you can install, run, and read along inside Claude itself.
When to use: You want to know what really happens between user prompts and tool calls.
Outcome: Real understanding of agent loops.
Bash harness for learning; Nanobot for a Python version of the same idea
| Tool | Inputs | When to call | Cost |
|---|---|---|---|
| run / trace | (see docs) | Two flows | 1 call |
Run with API keys you don't want to lose if the harness misbehavesBash agent loops infinitelyIt's educational — add a step cap at the top of main.sh
| Alternative | When to use it instead | Tradeoff |
|---|---|---|
| Read Claude Code source (not OSS) | Hypothetical | Not actually available |