Agent Loop
主线 + 深挖:循环边界与错误恢复
从源码分析到实战应用,系统学习 AI 编程助手
1900+ 文件 · 51万+ 行代码 · ✅ 编译通过
一句话:Claude Code CLI 的正式发布包中,误带了本应仅供调试使用的 Source Map(约 57MB 的 cli.js.map),里面能还原出大量 TypeScript 源码路径与内容——属于构建/发布流程疏漏,不是用户侧「破解」。
sourcesContent 等字段时,相当于把约 1900+ 个源文件、五十余万行量级的实现细节一并放进 npm 包,任何人下载安装包都能读到。sourcemap: true、CI 未剔除 *.map、紧急发版未做产物检查等。主打 Source Map 源码专题(24 讲 + 事件 + Awesome 源码);其余为官方文档整理、手册与 RAG / Agent 扩展专题
整合 24 讲源码课程 与 Source Map 事件:专题导读、十二章 S/D 列表、源码反推与 Awesome 源码汇总 入口。
基于官方文档整理的完整教程,涵盖安装、快速开始、Memory、Skills 等核心内容
从入门到精通的学习路线图,包含新手、进阶、高级三阶段路径
50+ 高频面试题,覆盖概念、实践、对比、场景四大类型
论文分析 + 技术热点;体系教程参考 Datawhale《All-in-RAG》(专题内链 GitHub Pages)
论文分析 + 技术热点 + 生态对比(技能包 / Subagents vs Teams)
从零基础到精通的完整学习路线
安装 Claude Code,配置账户和环境
⏱️ 15 分钟掌握常用命令和基本工作流
⏱️ 1 小时配置 CLAUDE.md,让 Claude 记住你的项目
⏱️ 45 分钟创建可复用的工作流和自动化检查
⏱️ 2 小时连接 GitHub、数据库等外部工具
⏱️ 1.5 小时Subagents、Plugins、CI/CD 集成
⏱️ 3 小时12 个主题 · 24 讲(S 主线 + D 深挖交替),原有 S01–S12 链接不变
S 主线再 D 深挖,沿箭头学完即覆盖全部内核模块。
主线 + 深挖:循环边界与错误恢复
工具定义 / 注册与失败契约
权限策略与审计点
CLI 入口与模式
压缩策略与信息保留
子代理隔离与合并
协议握手与工具发现
任务依赖与调度
Bridge 与 IDE 同步
钩子生命周期
模态编辑与终端
Git 工作流与自动化
高频面试题,覆盖核心知识点
Claude Code 是 CLI 工具,直接操作本地文件和终端...
核心区别:
四步循环:获取输入 → 调用 API → 执行工具 → 输出响应...
四步循环:
while (!finished) {
1. getUserInput() // 获取用户输入
2. callClaudeAPI() // 调用 API
3. executeTools() // 执行工具
4. displayResponse() // 输出响应
}
每个循环中,Claude 决定是否需要调用工具,并处理返回结果。
MCP 是一种协议,让 Claude Code 连接外部工具和数据源...
MCP 是一种协议,让 Claude Code 连接外部工具和数据源:
.mcp.json 文件/mcp 命令查看和管理在项目根目录创建 CLAUDE.md 文件...
步骤:
# 1. 在项目根目录创建 CLAUDE.md
touch CLAUDE.md
# 2. 编辑内容
echo "# 项目规则\n\n## 代码规范\n- 使用 TypeScript\n- 遵循 ESLint 规则" > CLAUDE.md
# 3. Claude Code 自动加载
在 .claude/commands/ 目录创建 .md 文件...
步骤:
# 1. 创建命令目录
mkdir -p .claude/commands
# 2. 创建命令文件
cat > .claude/commands/optimize.md << 'EOF'
---
name: optimize
description: 性能优化分析
---
请分析当前代码的性能瓶颈,并给出优化建议:
1. 识别热点代码
2. 分析时间复杂度
3. 提供优化方案
EOF
# 3. 使用命令
# /optimize
触发方式、持久性、适用场景的对比...
| 特性 | Slash Commands | Skills | Subagents |
|---|---|---|---|
| 触发方式 | 手动 /cmd | 自动触发 | 自动委派 |
| 持久性 | 当前会话 | 文件系统级 | 独立上下文 |
| 适用场景 | 高频快捷操作 | 复用工作流 | 任务拆分 |
组合 Memory + Hook + Slash Command...
组合方案:
# CLAUDE.md
## 代码规范
- TypeScript strict mode
- 测试覆盖率 > 80%
# ~/.claude/hooks/pre-commit.sh
npm run lint && npm test
/optimize # 性能审查
/pr # PR 准备
使用 print mode 和权限配置...
CI/CD 配置示例:
# .github/workflows/claude-ci.yml
name: Claude CI
on: [push]
jobs:
review:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Run Claude Code
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
run: |
claude -p "Review the code changes" \
--permission-mode dontAsk \
--output review.md
- name: Upload Review
uses: actions/upload-artifact@v4
with:
name: code-review
path: review.md
以下为知乎专栏稿对应的 仓库 Markdown,不重复粘贴正文;点击卡片内链接在 GitHub 上查看渲染版(需网络)。与本地 wemedia/zhihu/articles/*.md 同源。个人专栏:工具链阅历、上手与踩坑(赛博档案 · 实战篇 · Agent 实战手记);待发 Markdown 稿 11 ↗、稿 12 ↗;Memory 机制长文见 本站专题页 / 稿 13 ↗;Harness 工程向深度稿 14–20(子 Agent、工具链、规则分层、写盘安全、上下文预算、RAG 三轨、幻觉治理)见下方新卡片;Superpowers 市场 vs Autoresearch见 本站专题页 / 稿 21 ↗。外文技术快讯另见 RAG · 技术热点、Agent · 技术热点;源码向综述见 Source Map 源码专题。
Qoder、Trae、反重力、VS Code、Codex、Claude Code 轮换主力;非 Cursor 固定党——CLI 与反代折腾,脱敏随笔。
阅读本站专栏 →赛博档案 · 实战篇 · Agent 实战手记——可照着做、可避坑;与「工具链阅历」姊妹篇互补,正文随项目经历增量。
阅读本站专栏 →51万行泄露源码揭示:Anthropic 的风控系统远比你想象的复杂
阅读 Markdown →51万行代码中,藏着 Anthropic 的野心
阅读 Markdown →两个开源 AI 助手的记忆架构深度对比
阅读 Markdown →当你在使用 Claude Code 时,Anthropic 正在看着你
阅读 Markdown →一个循环 + 工具集 = AI 代理的核心引擎
阅读 Markdown →一个协议,连接无限可能
阅读 Markdown →一个 AI 助手的权限哲学
阅读 Markdown →上下文压缩的秘密武器
阅读 Markdown →一个低级错误,暴露了整个帝国
阅读 Markdown →从源码看未来,AI 编程助手的战略博弈
阅读 Markdown →何时 fork、隔离什么、交接协议与锁——别抢主会话窗口。
阅读 Markdown →从 tool_use 到 tool_result:校验、超时、并行与失败语义。
阅读 Markdown →L1 规则 / L2 Memory / L3 代码真相——谁维护、谁裁判。
阅读 Markdown →全局根、canonical 路径、traversal 与 symlink——三道闸。
阅读 Markdown →在 Compact 之前先算清:谁在占 200K 的「房租」与「过路费」。
阅读 Markdown →代码事实、过程知识、文档海洋——哪条轨道回答哪类问题。
阅读 Markdown →硬流程代替软提醒:证据链、测试门禁与会话留痕。
阅读 Markdown →基于 reference/reference_agent 内快照读 marketplace.json 与 plugin.json;Mermaid 见 专题页。