先把 README 警告当作边界
ultraworkers/claw-code 是一个 claw CLI agent harness 的 Rust 实现，但首先要看的不是 quick start，而是它前面的警告。README 说 Claw Code 不是这个项目族里的严肃生产项目。它更接近公开展品，而不是产品推介，并把真正想跑工作的用户指向 code-yeongyu/lazycodex 和 Yeachan-Heo/gajae-code。
这不是 top GitHub 仓库的常规定位。截至 2026-06，本地快照显示它超过 193,000 stars 和 109,000 forks，但项目文本反复提醒读者不要把关注度等同于稳定性。这个页面也应按这个口径读：Claw Code 值得看，是因为它展示了 agent 管理代码工作的某种方式，而不是因为它显然应该成为默认 CLI。
仓库没有归档，并且 2026 年 6 月仍有 push。同期 pull requests 包括 provider 修复、Windows 设置、路径校验、setup 命令、本地 provider 行为，以及 session_id 路径遍历修复。这些都是真实活动。它们也说明这个表面还在快速移动，并且有不少锋利边缘。
仓库里有什么
当前仓库形状写得很清楚。主运行时在 rust/ 下，那里有 Rust workspace 和 claw CLI binary。顶层文档包括 USAGE.md、PARITY.md、ROADMAP.md、PHILOSOPHY.md、SECURITY.md 和 Windows 设置说明。旧的 src/ 与 tests/ 区域是配套或参考材料，不是主要运行面。
Rust workspace 里有 API、runtime、commands、tools、plugins、telemetry、mock Anthropic-compatible service、compatibility harness 和 rusty-claude-cli binary。workspace package 版本是 0.1.3，使用 Rust edition 2021，并且标记为 publish = false。这个细节和 README 一致：这个仓库走源码构建，不是一个打磨好的 crates.io 包。
功能面很宽。Rust README 列出 Anthropic 与 OpenAI-compatible provider flows、streaming、bearer-token auth、interactive REPL、bash 和 file tools、web tools、agent surfaces、todo tracking、notebook editing、project memory files、config hierarchy、permission system、MCP server lifecycle and inspection、session persistence、cost and usage surfaces、git integration、slash commands、hooks、plugin management 和 skills inventory。
也正因为面宽，页面必须写清限制。agent CLI 会碰到很多集成点：凭证、本地文件、shell 命令、provider routing、plugin 行为、MCP servers、hooks 和 session storage。普通安装说明不足以覆盖这些风险。
安装和设置：先避开这个坑
README 里最具体的警告是包名。它说 cargo install claw-code 会装错东西。crates.io 上名为 claw-code 的包是废弃 stub，只会放一个废弃 binary，并提示项目已改名。不要用这个路径安装当前仓库。
对这个仓库来说，路径是 clone 源码，进入 Rust workspace，用 Cargo 构建 workspace，设置 Anthropic API key 或 bearer token，然后从构建输出里运行 claw，并先跑 doctor 检查。Windows 上 binary 是 claw.exe，文档给了 PowerShell 优先的说明。
仓库也支持 OpenAI-compatible 本地 provider，包括 Ollama 类路由，但这些流程依赖 provider 配置，不是一条通用命令。如果你要测试它，把凭证放在环境变量里，并先使用 health check。安全策略明确提醒：不要在报告里包含真实 API keys、私有 prompts 或带 secrets 的 session transcripts。
还有一个当前状态限制：ACP 和 Zed。README 说 claw acp 会报告状态，claw acp serve 只是 discoverability alias。它还没有真正发布 ACP 或 Zed daemon，也没有 JSON-RPC entrypoint。如果你搜索的是 “claw-code zed” 或 “claw-code acp”，诚实答案是这个表面还没落地。
哪些是已存在的，哪些仍在路上
仓库有可读的 CLI 文档和很大的 Rust workspace。它也有像运行中 parity ledger 的文档。PARITY.md 描述 mock parity harness、tool surface、permission enforcement、MCP 和 LSP registry bridges、project memory loading、config precedence、plugin flows，以及仍有限的部分。它有用，但不等同于稳定用户手册。
PHILOSOPHY.md 说，真正值得研究的是生成这个仓库的系统：人给方向，agent 协调、验证、review、retry，并把通知路由放到 coding agent 的 context window 外面。这解释了 README 的奇怪语气。这个仓库既是软件，也是自动化开发流程的公开记录。
对普通开发者来说，需要把两个问题分开：
- 它是否适合研究 agent CLI 和协调系统？
- 它是否适合当作日常 coding agent 依赖？
第一个问题，如果你研究 terminal coding agents、Rust agent runtimes、provider routing、permission systems、MCP surfaces 和 project memory behavior，答案是可以看。第二个问题需要谨慎。把它放到重要仓库前，应先在一次性 workspace 里测试 provider flows、file permissions、session storage、shell behavior 和 Windows path handling。
Issues 和 PRs 暴露真实边缘
近期 issues 和 pull requests 比 README 更能说明现状。OpenAI-compatible provider 路径曾因 bad merge 造成 build broken，后来用 evidence 和 green CI 关闭。DeepSeek routing 曾因 provider-prefixed model names 出问题，后来标记为 provider prefix stripping 修复。Gemini reasoning signature 问题被关闭为 architectural gap。多个旧 parity issue 被关闭，是因为它们被记录在 ROADMAP.md，不是当作普通 bug 长期开着。
安全也不是抽象问题。近期有一个 open pull request 是防止 session_id 在 session_store 中路径遍历。另一个近期 merged PR 校验 attached redirection paths。安全策略把 path traversal、symlink escapes、permission bypasses、sandbox misreporting、unsafe tool execution、credential disclosure、plugin behavior、hooks、MCP、provider config 和 unexpected code execution 都列为范围内问题。
这不代表仓库默认不安全。它说明威胁模型和工具类别匹配。coding agent CLI 会访问你的文件系统和 shell。对快速移动的 agent harness，应当按安全敏感工具处理，特别是 README 自己已经说它不是严肃生产项目。
和附近 agent 工具对比
| Repository | Stars | Language | License | How to read it |
|---|---|---|---|---|
| ultraworkers/claw-code | 193,624 | Rust | MIT | 带强限制说明的 agent CLI 展品和 Rust workspace |
| openai/codex | 90,388 | Rust | Apache-2.0 | OpenAI 的终端 coding agent |
| anthropics/claude-code | 131,730 | Python | 本地数据未列出 | 围绕 Claude Code 工作流的 agentic coding tool |
| code-yeongyu/lazycodex | 889 | TypeScript | MIT | Claw Code README 指向的相关 harness 项目 |
| Yeachan-Heo/gajae-code | 511 | TypeScript | MIT | Claw Code README 指向的相关 MVP 项目 |
截至 2026-06，ultraworkers/claw-code 的 star 和 fork 数相对仓库年龄、以及它指向的两个 harness 项目都异常高。这不足以说数据错误，但足以避免天真地按人气排序理解。上表应该被当作当前仓库元数据，而不是成熟度排名。
怎么读 star 曲线
本地 star-history 只有两个抽样点：2026-03-31 约 39,900 stars，2026-06-11 为 193,624 stars。它能说明增长很大，但不能解释原因。只有两个抽样点时，把增长归因于某次发布、帖子、benchmark 或 release 都不严谨。
更稳妥的读法很简单。Claw Code 在很早期就有了巨大 GitHub 关注。这让它值得为搜索者记录，但仓库文本自己仍然要求读者把它当展品看。star 数不能替代 release history、安全审查或稳定安装渠道。
相关仓库
- anomalyco/opencode 是另一条 terminal coding agent 路线。
- voideditor/void 是编辑器形态的开源 coding assistant。
- anthropics/skills 对应 agent workflows 里的 skill packaging。
- microsoft/vscode 是很多 agent integration 会落地的编辑器平台。
FAQ
ultraworkers/claw-code 适合生产使用吗？
README 自己说它更像展品，不是严肃生产项目。你可以研究和测试它，但不应该把 star 数当成生产可用性的信号。
应该运行 cargo install claw-code 吗？
不应该。README 说这会从 crates.io 装到错误内容。这个仓库走源码构建，应按它的 Rust workspace 说明操作，并用 doctor 检查验证。
claw-code 支持 ACP 或 Zed 吗？
还没有真正的 daemon。README 说 claw acp 只报告当前状态，claw acp serve 只是 discoverability alias，真实 protocol support 还没落地。
它需要什么凭证？
文档路径使用 ANTHROPIC_API_KEY 或 ANTHROPIC_AUTH_TOKEN，proxy 或本地 provider 场景可配 base URL。凭证应放在环境变量里，不要贴进 issue 或日志。
为什么 stars 和 forks 这么高？
数据确实显示关注度很高，但抽样 star-history 只有两个点，无法解释原因。诚实读法是：它很快有了高可见度，但自己的文档仍提醒读者不要把它当普通生产工具。