Learn Claude Code

Active
GitHub Python MIT

Description

A nano claude code-like agent harness built from scratch, demonstrating how to build AI coding assistants from zero to one.

Key Features

  • Agent Harness architecture teaching - Systematic coverage of Tools + Knowledge + Observation + Action + Permissions five-layer architecture
  • Build Claude Code from scratch - Implement a complete AI coding assistant in Bash, covering file ops, shell execution, and context management
  • Harness engineering methodology - Deep exploration of the core philosophy: agency comes from training, harness comes from engineering
  • Tool implementation patterns - Teaching atomic, composable tool interface design (file I/O, shell, API calls, browser control)
  • Context management techniques - Sub-agent isolation, context compaction, and task persistence to prevent context bloat

Use Cases

💡 Understand how AI coding assistants work internally, learning the full pipeline from model to engineering
💡 Build agent harnesses for your own domain by migrating design patterns beyond coding scenarios
💡 Learn tool interface design, context permission management, and trajectory data collection for model fine-tuning
💡 Train team members as AI agent engineers with a shared harness engineering mental model

Strengths & Limitations

Strengths

  • Actively maintained, recent updates
  • High community interest (75.9k stars)
  • Permissive open-source license (MIT)
  • Responsive to issues, low backlog

Quick Start

# Clone the repository
git clone https://github.com/shareAI-lab/learn-claude-code.git
cd learn-claude-code

# Read the tutorial docs and start building your Agent Harness from scratch
# Core concept: Harness = Tools + Knowledge + Observation + Action + Permissions
cat README.md

Related Projects

Qwen Code

27.6k · TypeScript
Active A

An open-source AI coding agent that lives in your terminal, built by Qwen team with support for code generation, editing, debugging and multi-file operations.

codingllmtypescript +2
  • · Multi-protocol multi-provider — supports OpenAI, Anthropic, Gemini-compatible APIs with Alibaba Cloud, OpenRouter and more
  • · Qwen3-Coder co-evolution — both framework and Qwen3-Coder model are open-source and ship together
  • · Built-in Skills and SubAgents — rich built-in tools for full agentic workflow with Claude Code-like experience

Gemini CLI

106.8k · TypeScript
Active A+

Gemini CLI is a terminal-based AI agent tool from Google that supports code generation, file operations, and multi-turn conversations with a free usage tier.

codingcliagent +2
  • · Gemini 3 model access - 1M token context window with improved reasoning capabilities
  • · Built-in tool suite - Google Search grounding, file operations, shell commands, and web fetching
  • · MCP protocol extensibility - connect custom tools and services via Model Context Protocol