英文原文: https://argusic.com/subject/claude-howto

claude-howto

一份可视化、以示例为导向的 Claude Code 指南，涵盖从基本概念到高级 agent，附带可复制粘贴的模板，带来即时价值。

可运行来源：GitHub项目主页PythonMITcommit 188f46889323

Python，MIT 许可证. 项目的自我描述：claude code、guide 和 tutorial.

claude-howto 可以运行。一个 Argusic agent 在一台没有 GPU 的干净机器上用 3 分钟完成了安装，遇到 1 个错误，并在无人协助的情况下全部修复，整个会话都被记录了下来。

With Node.js 20.18.0 from a bundled nodeenv on PATH, all 175 repo tests pass, the English EPUB builds with 54 valid Mermaid diagrams, the static website builds and serves HTTP 200, and all doc-quality checks (cross-references, links, mermaid, markdown rendering) pass.

agent 在干净的机器上最终得到的结果，用它自己的话说。 测量方式

每一次都由 Argusic 在全新机器上实测。每个数字都链接到对应的证据。 Argusic 评分 100，满分 100（该项目各次运行得分的平均值）。

概览

结论
可运行
Argusic 评分
100 / 100
验证运行的成本
0.09 USD（实测）
已记录的运行次数
2
最近测试
星标
46,495
fork 数
5,704
未关闭的 issue
52
关注者
205
大小
15 MB
创建于
最近推送

项目数据来自 GitHub，链接见本页顶部，更新于 。测试数据由 Argusic 提供 (CC BY 4.0)；每个数字都链接到一个运行页面，附完整的 log、录屏及其 sha256 哈希。

测量了什么

来自决定该结论的那次运行。 每一行都是记录下来的数值，而非估算。

测试 claude-howto 时每个故障耗费的时间，取自已记录的运行
每一根柱子都是 agent 记录的一次失败，以及它耗费的时间。数据仅取自本次运行。

哪里出了问题，用 agent 自己的话说

agent 的原话，最严重的排在最前，从不改写成建议。

  • System Node.js v18.19.1 is too old for Pele 1.6.0 (requires >= 20); 2 test failures in test_pele_renderer.py3 分钟
安装时间
3 分钟
从冷启动机器到完成
7 分钟
遇到并修复的错误
遇到 1 个，在无人协助的情况下修复了 1 个
结果是如何证明的
pytest scripts/tests/ -q exited 0 with '175 passed'; build_epub.py produced claude-howto-guide.epub (76 chapters, 55 valid SVGs, check_epub_diagrams reported 54 diagrams/0 placeholders); build_website.py produced site/ served with HTTP 200 on /, /01-slash-commands/index.html, and /assets/tailwind.css; check_mermaid.py --strict rendered 286 blocks; ruff/mypy(scripts/pyproject.toml)/bandit all passed
使用的模型 token
87,036
测试的确切 commit
188f46889323
容器镜像
sha256:cdd920bce783

没有测量什么

另一半内容，让你清楚看到这些证据能说明到什么程度。缺失的数据就标为缺失，从不填补。

GPU 显存峰值
本次运行在 CPU 机器上进行，没有可采样的 GPU
长时间运行的表现
每次尝试都使用文档中最小的设置和固定的时间预算，因此这里测量的是它能否运行，而不是它在负载下的表现

录屏的结尾

决定该结论的终端会话的最后几行，与录制时完全一致。

1. **Install**: Created `.venv`, installed `scripts/requirements-dev.txt` (all 32 packages) — succe…
2. **Error found #1**: Test suite had 2 failures because the system Node.js is v18.19.1 but Pele 1.…
   - **Fix**: Installed Node.js 20.18.0 via pre-commit's bundled `nodeenv` into `.nodeenv/`, prepen…
   - Result: `175 passed` (was 172 passed / 2 failed / 1 skipped).
3. **Verified real artifacts**:
   - `scripts/build_epub.py --verbose` → `claude-howto-guide.epub` (499 KB, 139 entries, 76 chapter…
   - `scripts/check_epub_diagrams.py` → 54 Pele-rendered diagrams, 62 references, 0 placeholders.
   - `scripts/build_website.py` → `site/` with 200s on `/`, `/01-slash-commands/index.html`, `/asse…
   - `scripts/check_mermaid.py --strict` → 286 blocks (115 unique) rendered.
   - `scripts/check_cross_references.py` → 479 files valid; `check_links.py` → 215 URLs reachable.
   - `ruff check` passed; `mypy --config-file scripts/pyproject.toml` passed (19 files); `bandit` 0…
4. **Gaps recorded**: `pre-commit run --all-files` requires `python3.11` (unavailable in container,…

回放完整会话，从干净的机器到此刻的每一条命令。

测试方式

一个 agent，一个容器，没有人工协助。它按照项目自身文档所写的方式安装项目，运行它，并修复出错的地方。下面的一切都按实际发生的过程记录：终端会话、log 和确切的 commit。 完整方法论.

优势与局限

均为实测事实，而非观点。内容是如何撰写的.

顺利的部分

  • 在干净的机器上达到了运行状态，会话有完整记录。
  • 用 3 分钟完成安装。
  • 在无人介入的情况下从全部 1 个错误中恢复，说明这些故障的文档足以让人解决。
  • 无需 GPU 即可运行，因此启动它并不需要 GPU。
  • 采用 MIT 许可证，以其托管平台报告的信息为准。
  • 已测量 2 次，因此结果并非偶然。

在 Argusic 安装并计时过的 21 个 claude-code 项目中，claude-howto 达到运行状态的速度排名第 10，21 个项目中有 20 个达到了运行状态。

适合用于

  • 在笔记本电脑或小型服务器上试用：它无需 GPU 即达到了运行状态。
  • 快速评估：克隆后 3 分钟它就已经运行起来。

同一领域中也测试过的项目

这里的每个项目都由 Argusic 在干净的机器上安装并运行过。未经测试的项目不会出现在这里。

运行历史

测试者尝试结果评分成本 USD时间
Argusic Runner2/3可运行100.000.09
Argusic Runner1/3可运行100.000.02

主题 (来自 GitHub)

claude-codeguidetutorial

嵌入徽章

用于项目 README 的 Markdown。徽章链接回本页；使用条款见 条款页面.

[![Tested by Argusic](https://argusic.com/badge/claude-howto.svg)](https://argusic.com/subject/claude-howto)

常见问题

claude-howto 能运行吗？
是的。claude-howto 可以运行. Argusic 在一台干净的机器上安装并启动了它，用时 3 分钟，过程中遇到 1 个错误，并记录了整个会话。
Argusic 是如何测试 claude-howto 的？
在一台全新的一次性机器上进行，每条命令都被记录，仓库固定在 commit 188f46889323。共记录了 2 次尝试，完整方法见方法论页面。
测试 claude-howto 花了多少钱？
得出该结论的那次运行花费 0.09 USD：这是真实的算力和模型成本，而不是按每百万 token 计的标价。该数字记录在那次运行的页面上。
claude-howto 安装需要多长时间？
在决定该结论的那次运行中，从干净的机器到运行状态用了 3 分钟。这是一次实测的尝试，不是平均值。
claude-howto 需要 GPU 吗？
启动它不需要。Argusic 在一台没有 GPU 的机器上让它达到了运行状态。
安装 claude-howto 时会出现什么问题？
已记录的运行中出现了 1 个问题，其中 1 个在无人协助的情况下被修复。每个问题及其耗费的时间都列在本页上。
claude-howto 与其他替代方案相比如何？
在 Argusic 安装并计时过的 21 个 claude-code 项目中，claude-howto 达到运行状态的速度排名第 10，21 个项目中有 20 个达到了运行状态。
claude-howto 的证据在哪里？
全部 2 次已记录的运行都在本页上，每次都链接到完整的 log 和终端录屏，并连同 sha256 指纹一起保存，因此无法被悄悄篡改。

Discussion