learn-likecc

这是什么

learn-likecc 不是一个单纯的“Claude Code 使用笔记”仓库。它把四条线放在同一个可发布工程里：

这个仓库的定位是学习、研究、复刻和产品化实验。涉及 Claude Code 的源码快照与分析均以教育研究为目的，原始产品与相关源码权利归原权利方所有。

推荐先打开

学习地图

flowchart LR
    A["源码快照<br>ccsource/sourcecode"] --> B["课程拆解<br>S01-S12 / D01-D12"]
    B --> C["可视化专题<br>Source Map / CC Unpacked"]
    C --> D["Loop Lab 仿真器<br>Agent Loop / Script / Trace"]
    D --> E["LikeCode 实验<br>模型路由 / Web 工作台 / Loop"]
    E --> F["可复用方法<br>Agent CLI / Harness / Workflow"]

Loop Lab 仿真专题

仿真专题是这个仓库最适合“边看边理解”的入口：它把抽象的 Agent 运行链路拆成可以点击、回放和对照的页面。

本地快速开始

如果你之前是从 GitHub 页面点 Download ZIP，解压目录没有 .git，无法提交和推送。建议正式开发时 clone 仓库：

git clone https://github.com/Harzva/learn-likecc.git
cd learn-likecc

安装根目录校验工具：

npm ci
npm run lint:md
python tools/check_site_md_parity.py
python tools/check_cc_loop_steps.py
python tools/gen_cc_overview.py --check
python tools/gen_cc_arch_treemap.py --verify-in-sync

本地预览站点：

cd site
python -m http.server 8080

然后打开：

http://127.0.0.1:8080/
http://127.0.0.1:8080/topic-cc-loop-lab.html

运行复刻 CLI

当前正式 clone 中可用的学习版 CLI 基线在 ccsource/claude-code-rebuild。

cd ccsource/claude-code-rebuild
bun install
bun run src/entrypoints/cli.tsx

根目录脚本 bin/likecode 会优先寻找 ccsource/like-code-main，如果该本地主开发线不存在，则回退到 ccsource/claude-code-rebuild。

chmod +x bin/likecode
./bin/likecode --help

这是学习版复刻环境，不建议把它当作生产 CLI 使用。真实项目中请优先使用官方 Claude Code 或你明确审计过的分支。

自由换模型实验

LikeCode 当前最重要的产品化实验，是把“模型选择”从固定列表变成可配置路由。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.provider.example",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5-20250929"
  },
  "modelRoutes": {
    "minimax/minimax-m2.5": {
      "baseURL": "https://api.provider.example",
      "authToken": "sk-provider-route-example",
      "headers": {
        "x-provider": "minimax"
      }
    }
  },
  "model": "minimax/minimax-m2.5"
}

已经验证过的关键点：

• SiliconFlow MiniMax 路由可跑通 Pro/MiniMaxAI/MiniMax-M2.5[1m]。
• baseURL 应写到 provider 根地址，例如 https://api.siliconflow.cn，不要直接写到 /v1/messages。
• 非官方兼容网关需要对 thinking、headers 和 provider 语义做兼容处理。

课程内容

课程正文在 course/docs/zh，站点镜像在 site/s01.html 到 site/s12.html。

仓库结构

learn-likecc/
├─ site/                         # GitHub Pages 静态站点与仿真器入口
│  ├─ agent-loop-simulator/       # Agent Loop 动态模拟器
│  ├─ agent-script-insight/       # 脚本启示仿真器
│  ├─ agent-trace-simulator/      # Trace Prompt 仿真器
│  ├─ images/claude-pets/         # Claude Pet SVG 墙素材
│  └─ md/                         # HTML 对应 Markdown 镜像
├─ course/                        # 源码学习课程
├─ ccsource/
│  ├─ claude-code-rebuild/        # 可运行重建基线
│  └─ sourcecode/claude-code-main # 源码学习快照
├─ tools/                         # 站点校验、生成、抓取与联调脚本
├─ docs/                          # 设计说明、运行记录、提交台账
└─ .github/workflows/             # Pages 部署与站点校验

维护命令

当前路线图

• 源码课程主线：S01-S12 基础完成
• GitHub Pages 站点与专题导航
• Loop Lab 三类仿真器入口
• 模型路由实验记录与 MiniMax/SiliconFlow 验证
• README、站点与仿真器继续做产品级信息架构
• 多窗口 / tab / subagent 工作视图继续推进
• localhost Web 工作台继续补 transcript、tool chain、workflow replay

资源链接

• GitHub Pages: https://harzva.github.io/learn-likecc/
• Repository: https://github.com/Harzva/learn-likecc
• Codex Loop Skill: https://github.com/Harzva/codex-loop-skill
• Claude Code 官方文档: https://docs.anthropic.com/en/docs/claude-code
• Anthropic Claude Code: https://github.com/anthropics/claude-code

使用边界

本仓库仅供学习、研究、教学和复刻实验。请不要把未审计的复刻代码、私有 token、真实业务凭据或第三方源码权利不明的内容用于生产环境或公开分发。