nanocoderagent 0.1.0__tar.gz

nanocoderagent-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,27 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python-version: ["3.10", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Run tests
+        run: python -m pytest tests/ -v

nanocoderagent-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,27 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

nanocoderagent-0.1.0/.gitignore

@@ -0,0 +1,17 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.env
+.venv/
+venv/
+.mypy_cache/
+.ruff_cache/
+.nanocoder_history
+.DS_Store
+dist/
+.pytest_cache/

nanocoderagent-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yufeng He
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

nanocoderagent-0.1.0/PKG-INFO

@@ -0,0 +1,194 @@
+Metadata-Version: 2.4
+Name: nanocoderagent
+Version: 0.1.0
+Summary: Minimal AI coding agent (~1300 LoC) inspired by Claude Code. Works with any LLM.
+Project-URL: Homepage, https://github.com/he-yufeng/NanoCoder
+Project-URL: Repository, https://github.com/he-yufeng/NanoCoder
+Project-URL: Issues, https://github.com/he-yufeng/NanoCoder/issues
+Author-email: Yufeng He <40085740+he-yufeng@users.noreply.github.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent,ai,claude-code,cli,coding,llm
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development
+Requires-Python: >=3.10
+Requires-Dist: openai>=1.0
+Requires-Dist: prompt-toolkit>=3.0
+Requires-Dist: rich>=13.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# NanoCoder
+
+[![PyPI](https://img.shields.io/pypi/v/nanocoderagent)](https://pypi.org/project/nanocoderagent/)
+[![Python](https://img.shields.io/badge/python-3.10+-blue)](https://python.org)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![Tests](https://github.com/he-yufeng/NanoCoder/actions/workflows/ci.yml/badge.svg)](https://github.com/he-yufeng/NanoCoder/actions)
+
+[中文](README_CN.md) | [English](README.md) | [Claude Code Architecture Deep Dive (7 articles)](article/)
+
+**512,000 lines of TypeScript → 1,300 lines of Python.**
+
+I spent a weekend reverse-engineering the leaked Claude Code source — all half a million lines. Then I stripped it down to the load-bearing walls and rebuilt them in Python. The result: **every key architectural pattern from Claude Code, in a codebase you can read in one sitting.**
+
+NanoCoder is not another AI coding tool. It's a **blueprint** — the [nanoGPT](https://github.com/karpathy/nanoGPT) of coding agents. Read it, fork it, build your own.
+
+---
+
+```
+$ nanocoder -m kimi-k2.5
+
+You > read main.py and fix the broken import
+
+  > read_file(file_path='main.py')
+  > edit_file(file_path='main.py', ...)
+
+--- a/main.py
++++ b/main.py
+@@ -1 +1 @@
+-from utils import halper
++from utils import helper
+
+Fixed: halper → helper.
+```
+
+## What You Get
+
+Claude Code's 512K lines distilled to 7 patterns that actually matter:
+
+| Pattern | Claude Code | NanoCoder |
+|---|---|---|
+| Search-and-replace editing (unique match + diff) | FileEditTool | `tools/edit.py` — 70 lines |
+| Parallel tool execution | StreamingToolExecutor (530 lines) | `agent.py` — ThreadPool |
+| 3-layer context compression | HISTORY_SNIP → Microcompact → CONTEXT_COLLAPSE | `context.py` — 145 lines |
+| Sub-agent with isolated context | AgentTool (1,397 lines) | `tools/agent.py` — 50 lines |
+| Dangerous command blocking | BashTool (1,143 lines) | `tools/bash.py` — 95 lines |
+| Session persistence | QueryEngine (1,295 lines) | `session.py` — 65 lines |
+| Dynamic system prompt | prompts.ts (914 lines) | `prompt.py` — 35 lines |
+
+Every pattern is a real, runnable implementation — not a diagram or a blog post.
+
+## Install
+
+```bash
+pip install nanocoderagent
+```
+
+Pick your model — any OpenAI-compatible API works:
+
+```bash
+# Kimi K2.5
+export OPENAI_API_KEY=your-key OPENAI_BASE_URL=https://api.moonshot.ai/v1
+nanocoder -m kimi-k2.5
+
+# Claude Opus 4.6 (via OpenRouter)
+export OPENAI_API_KEY=your-key OPENAI_BASE_URL=https://openrouter.ai/api/v1
+nanocoder -m anthropic/claude-opus-4-6
+
+# OpenAI GPT-5
+export OPENAI_API_KEY=sk-...
+nanocoder -m gpt-5
+
+# DeepSeek V3
+export OPENAI_API_KEY=sk-... OPENAI_BASE_URL=https://api.deepseek.com
+nanocoder -m deepseek-chat
+
+# Qwen 3.5
+export OPENAI_API_KEY=sk-... OPENAI_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
+nanocoder -m qwen-max
+
+# Ollama (local)
+export OPENAI_API_KEY=ollama OPENAI_BASE_URL=http://localhost:11434/v1
+nanocoder -m qwen3:32b
+
+# One-shot mode
+nanocoder -p "add error handling to parse_config()"
+```
+
+## Architecture
+
+The whole thing fits in your head:
+
+```
+nanocoder/
+├── cli.py            REPL + commands               160 lines
+├── agent.py          Agent loop + parallel tools    120 lines
+├── llm.py            Streaming client + retry       150 lines
+├── context.py        3-layer compression            145 lines
+├── session.py        Save/resume                     65 lines
+├── prompt.py         System prompt                   35 lines
+├── config.py         Env config                      30 lines
+└── tools/
+    ├── bash.py       Shell + safety + cd tracking    95 lines
+    ├── edit.py       Search-replace + diff            70 lines
+    ├── read.py       File reading                     40 lines
+    ├── write.py      File writing                     30 lines
+    ├── glob_tool.py  File search                      35 lines
+    ├── grep.py       Content search                   65 lines
+    └── agent.py      Sub-agent spawning               50 lines
+```
+
+## Use as a Library
+
+```python
+from nanocoder import Agent, LLM
+
+llm = LLM(model="kimi-k2.5", api_key="your-key", base_url="https://api.moonshot.ai/v1")
+agent = Agent(llm=llm)
+response = agent.chat("find all TODO comments in this project and list them")
+```
+
+## Add Your Own Tools (~20 lines)
+
+```python
+from nanocoder.tools.base import Tool
+
+class HttpTool(Tool):
+    name = "http"
+    description = "Fetch a URL."
+    parameters = {"type": "object", "properties": {"url": {"type": "string"}}, "required": ["url"]}
+
+    def execute(self, url: str) -> str:
+        import urllib.request
+        return urllib.request.urlopen(url).read().decode()[:5000]
+```
+
+## Commands
+
+```
+/model <name>    Switch model mid-conversation
+/compact         Compress context (like Claude Code's /compact)
+/tokens          Token usage
+/save            Save session to disk
+/sessions        List saved sessions
+/reset           Clear history
+quit             Exit
+```
+
+## How It Compares
+
+|  | Claude Code | Claw-Code | Aider | NanoCoder |
+|---|---|---|---|---|
+| Code | 512K lines (closed) | 100K+ lines | 50K+ lines | **1,300 lines** |
+| Models | Anthropic only | Multi | Multi | **Any OpenAI-compatible** |
+| Readable? | No | Hard | Medium | **One afternoon** |
+| Purpose | Use it | Use it | Use it | **Understand it, build yours** |
+
+## The Deep Dive
+
+I wrote [7 articles](article/) breaking down Claude Code's architecture — the agent loop, tool system, context compression, streaming executor, multi-agent, and 44 hidden feature flags. If you want to understand *why* NanoCoder is designed this way, start there.
+
+## License
+
+MIT. Fork it, learn from it, ship something better. A mention of this project is appreciated.
+
+---
+
+Built by **[Yufeng He](https://github.com/he-yufeng)** · Agentic AI Researcher @ Moonshot AI (Kimi)
+
+[Claude Code Source Analysis — 170K+ reads, 6000 bookmarks on Zhihu](https://zhuanlan.zhihu.com/p/1898797658343862272)

nanocoderagent-0.1.0/README.md

@@ -0,0 +1,169 @@
+# NanoCoder
+
+[![PyPI](https://img.shields.io/pypi/v/nanocoderagent)](https://pypi.org/project/nanocoderagent/)
+[![Python](https://img.shields.io/badge/python-3.10+-blue)](https://python.org)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![Tests](https://github.com/he-yufeng/NanoCoder/actions/workflows/ci.yml/badge.svg)](https://github.com/he-yufeng/NanoCoder/actions)
+
+[中文](README_CN.md) | [English](README.md) | [Claude Code Architecture Deep Dive (7 articles)](article/)
+
+**512,000 lines of TypeScript → 1,300 lines of Python.**
+
+I spent a weekend reverse-engineering the leaked Claude Code source — all half a million lines. Then I stripped it down to the load-bearing walls and rebuilt them in Python. The result: **every key architectural pattern from Claude Code, in a codebase you can read in one sitting.**
+
+NanoCoder is not another AI coding tool. It's a **blueprint** — the [nanoGPT](https://github.com/karpathy/nanoGPT) of coding agents. Read it, fork it, build your own.
+
+---
+
+```
+$ nanocoder -m kimi-k2.5
+
+You > read main.py and fix the broken import
+
+  > read_file(file_path='main.py')
+  > edit_file(file_path='main.py', ...)
+
+--- a/main.py
++++ b/main.py
+@@ -1 +1 @@
+-from utils import halper
++from utils import helper
+
+Fixed: halper → helper.
+```
+
+## What You Get
+
+Claude Code's 512K lines distilled to 7 patterns that actually matter:
+
+| Pattern | Claude Code | NanoCoder |
+|---|---|---|
+| Search-and-replace editing (unique match + diff) | FileEditTool | `tools/edit.py` — 70 lines |
+| Parallel tool execution | StreamingToolExecutor (530 lines) | `agent.py` — ThreadPool |
+| 3-layer context compression | HISTORY_SNIP → Microcompact → CONTEXT_COLLAPSE | `context.py` — 145 lines |
+| Sub-agent with isolated context | AgentTool (1,397 lines) | `tools/agent.py` — 50 lines |
+| Dangerous command blocking | BashTool (1,143 lines) | `tools/bash.py` — 95 lines |
+| Session persistence | QueryEngine (1,295 lines) | `session.py` — 65 lines |
+| Dynamic system prompt | prompts.ts (914 lines) | `prompt.py` — 35 lines |
+
+Every pattern is a real, runnable implementation — not a diagram or a blog post.
+
+## Install
+
+```bash
+pip install nanocoderagent
+```
+
+Pick your model — any OpenAI-compatible API works:
+
+```bash
+# Kimi K2.5
+export OPENAI_API_KEY=your-key OPENAI_BASE_URL=https://api.moonshot.ai/v1
+nanocoder -m kimi-k2.5
+
+# Claude Opus 4.6 (via OpenRouter)
+export OPENAI_API_KEY=your-key OPENAI_BASE_URL=https://openrouter.ai/api/v1
+nanocoder -m anthropic/claude-opus-4-6
+
+# OpenAI GPT-5
+export OPENAI_API_KEY=sk-...
+nanocoder -m gpt-5
+
+# DeepSeek V3
+export OPENAI_API_KEY=sk-... OPENAI_BASE_URL=https://api.deepseek.com
+nanocoder -m deepseek-chat
+
+# Qwen 3.5
+export OPENAI_API_KEY=sk-... OPENAI_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
+nanocoder -m qwen-max
+
+# Ollama (local)
+export OPENAI_API_KEY=ollama OPENAI_BASE_URL=http://localhost:11434/v1
+nanocoder -m qwen3:32b
+
+# One-shot mode
+nanocoder -p "add error handling to parse_config()"
+```
+
+## Architecture
+
+The whole thing fits in your head:
+
+```
+nanocoder/
+├── cli.py            REPL + commands               160 lines
+├── agent.py          Agent loop + parallel tools    120 lines
+├── llm.py            Streaming client + retry       150 lines
+├── context.py        3-layer compression            145 lines
+├── session.py        Save/resume                     65 lines
+├── prompt.py         System prompt                   35 lines
+├── config.py         Env config                      30 lines
+└── tools/
+    ├── bash.py       Shell + safety + cd tracking    95 lines
+    ├── edit.py       Search-replace + diff            70 lines
+    ├── read.py       File reading                     40 lines
+    ├── write.py      File writing                     30 lines
+    ├── glob_tool.py  File search                      35 lines
+    ├── grep.py       Content search                   65 lines
+    └── agent.py      Sub-agent spawning               50 lines
+```
+
+## Use as a Library
+
+```python
+from nanocoder import Agent, LLM
+
+llm = LLM(model="kimi-k2.5", api_key="your-key", base_url="https://api.moonshot.ai/v1")
+agent = Agent(llm=llm)
+response = agent.chat("find all TODO comments in this project and list them")
+```
+
+## Add Your Own Tools (~20 lines)
+
+```python
+from nanocoder.tools.base import Tool
+
+class HttpTool(Tool):
+    name = "http"
+    description = "Fetch a URL."
+    parameters = {"type": "object", "properties": {"url": {"type": "string"}}, "required": ["url"]}
+
+    def execute(self, url: str) -> str:
+        import urllib.request
+        return urllib.request.urlopen(url).read().decode()[:5000]
+```
+
+## Commands
+
+```
+/model <name>    Switch model mid-conversation
+/compact         Compress context (like Claude Code's /compact)
+/tokens          Token usage
+/save            Save session to disk
+/sessions        List saved sessions
+/reset           Clear history
+quit             Exit
+```
+
+## How It Compares
+
+|  | Claude Code | Claw-Code | Aider | NanoCoder |
+|---|---|---|---|---|
+| Code | 512K lines (closed) | 100K+ lines | 50K+ lines | **1,300 lines** |
+| Models | Anthropic only | Multi | Multi | **Any OpenAI-compatible** |
+| Readable? | No | Hard | Medium | **One afternoon** |
+| Purpose | Use it | Use it | Use it | **Understand it, build yours** |
+
+## The Deep Dive
+
+I wrote [7 articles](article/) breaking down Claude Code's architecture — the agent loop, tool system, context compression, streaming executor, multi-agent, and 44 hidden feature flags. If you want to understand *why* NanoCoder is designed this way, start there.
+
+## License
+
+MIT. Fork it, learn from it, ship something better. A mention of this project is appreciated.
+
+---
+
+Built by **[Yufeng He](https://github.com/he-yufeng)** · Agentic AI Researcher @ Moonshot AI (Kimi)
+
+[Claude Code Source Analysis — 170K+ reads, 6000 bookmarks on Zhihu](https://zhuanlan.zhihu.com/p/1898797658343862272)

nanocoderagent-0.1.0/README_CN.md

@@ -0,0 +1,169 @@
+# NanoCoder
+
+[English](README.md) | [中文](README_CN.md) | [Claude Code 源码深度导读（7 篇）](article/)
+
+[![PyPI](https://img.shields.io/pypi/v/nanocoderagent)](https://pypi.org/project/nanocoderagent/)
+[![Python](https://img.shields.io/badge/python-3.10+-blue)](https://python.org)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![Tests](https://github.com/he-yufeng/NanoCoder/actions/workflows/ci.yml/badge.svg)](https://github.com/he-yufeng/NanoCoder/actions)
+
+**51万行 TypeScript → 1300 行 Python。**
+
+我花了一个周末逆向 Claude Code 泄露的全部源码，然后把不承重的部分全扔掉，用 Python 重建了核心。结果：**Claude Code 的每一个关键架构模式，浓缩在一个下午能读完的代码库里。**
+
+NanoCoder 不是又一个 AI 编程工具。它是一份**蓝图**，编程 Agent 领域的 [nanoGPT](https://github.com/karpathy/nanoGPT)。读懂它，fork 它，然后造你自己的。
+
+---
+
+```
+$ nanocoder -m kimi-k2.5
+
+You > 读一下 main.py，修掉拼错的 import
+
+  > read_file(file_path='main.py')
+  > edit_file(file_path='main.py', ...)
+
+--- a/main.py
++++ b/main.py
+@@ -1 +1 @@
+-from utils import halper
++from utils import helper
+
+修好了：halper → helper。
+```
+
+## 你能得到什么
+
+Claude Code 51 万行源码提炼出来的 7 个核心模式：
+
+| 设计模式 | Claude Code | NanoCoder |
+|---|---|---|
+| 搜索替换编辑（唯一匹配 + diff） | FileEditTool | `tools/edit.py` — 70 行 |
+| 并行工具执行 | StreamingToolExecutor（530行） | `agent.py` — ThreadPool |
+| 三层上下文压缩 | HISTORY_SNIP → Microcompact → CONTEXT_COLLAPSE | `context.py` — 145 行 |
+| 子代理隔离上下文 | AgentTool（1,397行） | `tools/agent.py` — 50 行 |
+| 危险命令拦截 | BashTool（1,143行） | `tools/bash.py` — 95 行 |
+| 会话持久化 | QueryEngine（1,295行） | `session.py` — 65 行 |
+| 动态系统提示词 | prompts.ts（914行） | `prompt.py` — 35 行 |
+
+每个模式都是可运行的实现，不是流程图，不是博客文章。
+
+## 安装
+
+```bash
+pip install nanocoderagent
+```
+
+选你的模型，任何 OpenAI 兼容 API 都行：
+
+```bash
+# Kimi K2.5
+export OPENAI_API_KEY=你的key OPENAI_BASE_URL=https://api.moonshot.ai/v1
+nanocoder -m kimi-k2.5
+
+# Claude Opus 4.6（通过 OpenRouter）
+export OPENAI_API_KEY=你的key OPENAI_BASE_URL=https://openrouter.ai/api/v1
+nanocoder -m anthropic/claude-opus-4-6
+
+# OpenAI GPT-5
+export OPENAI_API_KEY=sk-...
+nanocoder -m gpt-5
+
+# DeepSeek V3
+export OPENAI_API_KEY=sk-... OPENAI_BASE_URL=https://api.deepseek.com
+nanocoder -m deepseek-chat
+
+# Qwen 3.5
+export OPENAI_API_KEY=sk-... OPENAI_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
+nanocoder -m qwen-max
+
+# Ollama（本地）
+export OPENAI_API_KEY=ollama OPENAI_BASE_URL=http://localhost:11434/v1
+nanocoder -m qwen3:32b
+
+# 单次模式
+nanocoder -p "给 parse_config() 加上错误处理"
+```
+
+## 架构
+
+整个项目一目了然：
+
+```
+nanocoder/
+├── cli.py            REPL + 命令                   160 行
+├── agent.py          Agent 循环 + 并行执行          120 行
+├── llm.py            流式客户端 + 重试              150 行
+├── context.py        三层压缩                       145 行
+├── session.py        会话保存/恢复                   65 行
+├── prompt.py         系统提示词                      35 行
+├── config.py         环境变量配置                    30 行
+└── tools/
+    ├── bash.py       Shell + 安全 + cd 追踪          95 行
+    ├── edit.py       搜索替换 + diff                  70 行
+    ├── read.py       文件读取                         40 行
+    ├── write.py      文件写入                         30 行
+    ├── glob_tool.py  文件搜索                         35 行
+    ├── grep.py       内容搜索                         65 行
+    └── agent.py      子代理生成                       50 行
+```
+
+## 当库用
+
+```python
+from nanocoder import Agent, LLM
+
+llm = LLM(model="kimi-k2.5", api_key="your-key", base_url="https://api.moonshot.ai/v1")
+agent = Agent(llm=llm)
+response = agent.chat("找出项目里所有 TODO 注释并列出来")
+```
+
+## 加自定义工具（约 20 行）
+
+```python
+from nanocoder.tools.base import Tool
+
+class HttpTool(Tool):
+    name = "http"
+    description = "请求一个 URL。"
+    parameters = {"type": "object", "properties": {"url": {"type": "string"}}, "required": ["url"]}
+
+    def execute(self, url: str) -> str:
+        import urllib.request
+        return urllib.request.urlopen(url).read().decode()[:5000]
+```
+
+## 命令
+
+```
+/model <名称>    切换模型
+/compact         压缩上下文（对标 Claude Code 的 /compact）
+/tokens          查看 token 用量
+/save            保存会话
+/sessions        列出已保存的会话
+/reset           清空历史
+quit             退出
+```
+
+## 对比
+
+|  | Claude Code | Claw-Code | Aider | NanoCoder |
+|---|---|---|---|---|
+| 代码量 | 51万行（闭源） | 10万+行 | 5万+行 | **1300 行** |
+| 模型 | 仅 Anthropic | 多模型 | 多模型 | **任意 OpenAI 兼容** |
+| 能通读吗？ | 不能 | 很难 | 有点费劲 | **一个下午** |
+| 适合 | 直接用 | 直接用 | 直接用 | **先看懂，再造自己的** |
+
+## 源码导读
+
+我还写了 [7 篇 Claude Code 架构深度导读](article/)：Agent 循环、工具系统、上下文压缩、流式执行、多 Agent、隐藏功能。想知道 NanoCoder 为什么这样设计，从那里开始。
+
+## License
+
+MIT。Fork，然后拿去造更好的东西，如果能标注此出处就更好了。
+
+---
+
+作者 **[何宇峰](https://github.com/he-yufeng)** · Agentic AI Researcher @ Moonshot AI (Kimi)
+
+[Claude Code 源码分析（知乎 17 万阅读，6000收藏）](https://zhuanlan.zhihu.com/p/1898797658343862272)

nanocoderagent-0.1.0/article/00-index.md

@@ -0,0 +1,29 @@
+# Claude Code 源码导读
+
+2026 年 3 月 31 日，Anthropic 的 npm 包里残留的 `.map` 文件泄露了 Claude Code 的全部源码。1903 个文件，512,664 行 TypeScript。
+
+这是我读完全部源码后写的系列文章。不是面面俱到的文档（那个有 16 万字的完整版），而是我认为最值得开发者了解的 7 个切面。每篇都围绕一个核心问题展开，代码引用精确到行号。
+
+如果你在做 AI Agent 相关的工作，这些设计模式迟早会用到。
+
+## 目录
+
+1. **[从 51 万行说起](01-architecture-overview.md)** — Claude Code 的技术栈、目录结构、十大设计哲学。建立全局心智模型。
+2. **[1729 行的 while(true)](02-agent-loop.md)** — AI Agent 的核心循环：query.ts 如何驱动工具调用、消息编排、中断恢复。
+3. **[让 AI 安全地改你的代码](03-tool-system.md)** — 工具系统的接口设计、两阶段门控、搜索替换编辑的精妙之处。
+4. **[有限窗口，无限任务](04-context-compression.md)** — 四层上下文压缩策略的工程细节，以及它为什么不是简单的"截断旧消息"。
+5. **[边想边做](05-streaming-executor.md)** — StreamingToolExecutor 如何在模型还没说完的时候就开始执行工具。
+6. **[当一个 Claude 不够用](06-multi-agent.md)** — 多 Agent 协作系统：子代理生成、Worktree 隔离、团队编排。
+7. **[Feature Flag 背后的秘密](07-hidden-features.md)** — 44 个未发布功能的技术细节：KAIROS 永驻模式、Buddy 宠物系统、Voice Mode、Bridge Mode。
+
+## 配套项目
+
+这些文章中讨论的核心架构模式，我用 1300 行 Python 做了一个可运行的参考实现：[NanoCoder](https://github.com/he-yufeng/NanoCoder)。代码和文章可以对照着看。
+
+## 完整版
+
+如果你想要更详尽的版本（16 篇、16 万字、覆盖构建系统到 MCP 协议的每个子系统），完整导读在[这里](https://github.com/he-yufeng/NanoCoder/tree/main/docs)。
+
+---
+
+作者：[何宇峰](https://github.com/he-yufeng) · [知乎：Claude Code 源码分析（17万+ 阅读）](https://zhuanlan.zhihu.com/p/1898797658343862272)