这篇只讲一条路:从零装好,跑完第一次复刻,看懂它给你的东西。不涉及写 Prompt 的技巧,那部分放下一篇。

第一步,选装法

有两条路,装官方包和从源码编。

官方包最省事,不需要装 Rust。Windows 有 MSI 安装器和便携 zip,x64、arm64、x86 三种架构,有代码签名;macOS 是通用 dmg,Apple Silicon 与 Intel 同一个包,已签名并公证;Linux 给 AppImage、Flatpak、deb、rpm、tar.gz,覆盖 x86_64、aarch64,甚至还有 riscv64 的压缩包;FreeBSD 有 tar.gz。下载去 GitHub 的 Releases 页,官网的独立包列表有时会滞后。

从源码编要注意版本要求:Rust 1.97 或更新,因为工作区用了 edition 2024 和一批新依赖。Debian 与 Ubuntu 上跑桌面端还要先补系统库:libxkbcommon-dev、libwayland-dev、libx11-dev、libxrandr-dev、libxi-dev、libgl1-mesa-dev、libgtk-3-dev。

克隆之后两条命令,一条跑桌面端,一条装命令行:

cargo run --release -p craft-anything

cargo install --path apps/craft-anything-cli

如果想省时间,只装命令行就够,图形界面不是必需的。

第二步,自检

装完先别急着建项目,跑一次:

craft-anything-cli doctor

它检查三件事:安装是否完整、本机有没有可用的编码 Agent、引擎依赖是否齐。输出里会明确说出缺什么。自检通过再往下走。

顺手可以看一眼工具清单,craft-anything-cli commands。它会列出所有探针,每一个都是命令行的子命令,也同时是 MCP 工具。想把这些工具喂给任意支持 MCP 的客户端,用 craft-anything-cli mcp。

第三步,接一个构建方

工具装好不等于有人替你写代码。craft-anything 自己不带模型,构建这一步调用你本机已登录的 Agent。

Claude Code 是首选,也是唯一被反复验证过的路径。一条命令可以把它接上:

craft-anything-cli setup --client claude_code --yes

之后用 ai list 看本机认得的构建方,ai test 试一次连通性,ai add 加新的。用 Claude Code 时它跑的是你自己装的、没改过的 claude 程序,用的是你的登录态。

其他可选构建方包括 OpenCode、Copilot CLI、Grok Build,以及任何说 ACP 协议的命令行工具。内置名单里没有的,会落到一个 Plain 适配器,规则只有一条:任意命令行程序,把参数加 Prompt 作为最后的入参,输出按纯文本读。写命令时用绝对路径,因为双击启动的应用继承的是最小 PATH。

第四步,建第一个项目

图形界面里就是 Make 页:左边选网站、应用还是游戏,填地址,选净室或深度,写一句需求,比如"照着这个做一个",按开始。

命令行等价物:

craft-anything-cli rebuild https://example.com "Recreate this website"

新项目默认落在 Documents/Craft Anything 下,每个项目一个文件夹,结构是固定的。craft.json 记请求、目标、状态和历史;capture 目录放从原版记录的证据;app 放生成的工程;checks 放每一轮和原版的比对;inbox 放等待你回答的问题;还有一个 investigation.cany 是证据库。也可以指定自己的目录,如果目录里已经有文件,它会问你那是要就地改的应用,还是起始素材。

第五步,看结果

跑完四步,项目页会给你两样东西:每页的相似度,和一处一处列出"还不像"的清单。底部输入框继续提要求,它接着改。

中文界面的一个坑

从源码编译的版本,界面默认可能是方块。原因不复杂:中日韩字体不是运行时从系统取的,是构建期的可选输入,来自单独的字体仓库,官方发布版才带。要么按文档注入字体目录重新编译,要么直接换成英文界面:

craft-anything-cli settings-set language en

最后一句

第一次别拿商业产品练手。找一个你自己拥有、或者明确获准研究的小网站,把四步走完一遍,你对它的判断会比读十篇评测准。