上手指南(5 步跑通)
新用户首次跑通的最小路径——5 步, 5 分钟。每步一条命令 + 一句验证。
最快路径(推荐)— 有 Claude 订阅就 0 配置
最省事的走法:本机装好 Claude Code CLI(npm i -g @anthropic-ai/claude-code)并 claude auth login 后,第 4 步选 claude-code-cli runtime——全程不用填 API key、不用选模型,一条命令就上线一个"能干活、手机也能指挥"的私人 AI 员工。这是最稳、最少踩坑的路径。
没有 Claude 订阅?走 claude-agent-sdk + 一个模型 API key(MiniMax / DeepSeek / 书生 / 小米),见第 4 步。
已经装过 anet?
跳过本页, 走 升级指南(通常 anet upgrade 一键 + anet project restart 重启 cwd 节点)。
前置(两个都要装):
- Node.js ≥ 22.13.0
- Bun ≥ 1.2.0 —— 装法
npm i -g bun(或curl -fsSL https://bun.sh/install | bash)。第 2 步anet hub start底层用bunx起commhub-server,没装 Bun 第一步就会崩spawn bunx ENOENT。装完bun --version应有输出。
这俩装好就行;commhub-server / agent-node 首次用时自动拉取,不用手动装。
1. 安装 CLI
npm install -g @sleep2agi/agent-network验证:
anet -v2. 启动 Hub
打开第一个终端, 保持开着:
anet hub start启动后默认监听 http://127.0.0.1:9200, SQLite 数据库在 ~/.commhub/commhub.db, 自动创建默认管理员 admin / anethub。
公网部署立刻改密
默认 admin / anethub 仅本机用。任何 --host 0.0.0.0 公网部署立刻 anet passwd 改强密码。
停止 / 查看状态
anet hub status / anet hub stop(不用 lsof + kill)。
3. 启动 Dashboard + 登录
开第二个终端, 保持开着:
anet hub dashboard浏览器访问 http://localhost:3000, 用 admin / anethub 登录。
第三个终端给 CLI 也登录一次(后续 anet node ... 命令带凭证):
anet login --hub http://127.0.0.1:9200 --username admin --password anethubanet whoami 确认身份。
4. 创建并启动节点
anet node create my-bot向导按这个顺序问你:runtime → (仅 claude-agent-sdk) vendor → model → API Key。
新手最省事 — 手动选 claude-code-cli
向导默认高亮 claude-agent-sdk, 一路 Enter 会落到要填 vendor + API Key 的复杂路径。如果已经 claude auth login, 手动选 claude-code-cli = 零配置最快路径。
stable 版 anet node create 列出正式版的 runtime(claude-agent-sdk / claude-code-cli / codex-sdk / grok-build-acp);完整对照(含预览版 opencode-cli,stable 选择器暂不含)见 Runtime 对比。
启动节点:
全新安装选了 claude-agent-sdk / codex-sdk?先装 agent-node
这两个 runtime 依赖 agent-node 包。首次 node start 的 npx 自动拉取需要约 1 分钟,当前版本的启动检查不等它拉完就报 agent-node is not installed or cannot report a version 退出(真机复现,#450 精确立案,#237 为同族)。先跑一句再启动即可:
npm install -g @sleep2agi/agent-nodeanet node start my-bot看到 SSE connected 即上线, 终端保持开着。
vendor 选择中段 Ctrl+C 可能留半成品节点
半成品节点用 anet node delete <alias>(不带 --force 先看 will-delete 预览, 再加 --force 真删)清掉重来。
5. 用起来 — 从 Dashboard 派任务
回浏览器 http://localhost:3000:
- 进 Chat 页面, 左侧选
my-bot - 输入框写一句话("现在几点?" / "做个 hello world"), 回车
- 自己消息立刻乐观回显(
You标签) - Agent 调用 LLM 后回复, markdown 完整渲染(
↳ my-bot标签)
刷新页面, 聊天历史保留。
✅ 5 步跑通。
已验证 vs 未验证
已验证 (当前 stable,真机走查)
anet hub start+ 默认账号自动创建 /anet hub dashboardanet login(带--hub)/anet register/anet logout/anet whoamiclaude-code-cliruntime 端到端 —— 生产 fleet 每天在跑(最省事路径,见步骤 4 推荐);首跑 dev-channels 确认框需 TTYclaude-agent-sdk的node create(含 vendor 路径:Anthropic / MiniMax / 书生 Intern / 小米 MiMo — verified-with-real-call)+node ls / delete- Dashboard Chat(markdown / Enter 发 / 乐观回显 / 来源标签 / 错误兜底 / 历史持久)
带坑 / 未验证 (请自行评估)
claude-agent-sdk/codex-sdk的首次node start:latest 上agent-node懒加载没拉完就退(agent-node is not installed...,#450)。先npm i -g @sleep2agi/agent-node再启动即可(见上方步骤 4 提示)。codex-sdkruntime 端到端(LLM 真回话)—— 缺 OpenAI 测试 key,后半程待补验anet license/anet activate— v0.6 legacy, OSS 用户无需操作(详 troubleshooting)anet network create跨用户网络共享 — 代码已合并但未做 E2E 回归- 一键安装脚本
setup-anet.sh— 已退役停用, 不要运行旧副本, 见 退役说明
下一步
进阶:
- 多 Agent 协作 — peer agents 通过
get_all_status/send_task/get_task自治协调 - 批量节点管理
anet project up/restart/down— cwd 下所有节点一键起停, reboot 后零键盘恢复 - 局域网共用 Hub —
anet hub start --host 0.0.0.0让其他机器加入
实战 demo(实验性,仅供体验):
anet demo # 列出可用 demo
anet demo pr-review # PR 评审室 — 3 reviewer(安全/性能/风格)+ judge深入:
- CLI 命令清单
- Agent Node 配置 — config.json 字段 + ANet 循环任务
/aloop - 多模型配置 — DeepSeek / Kimi / Claude / MiniMax / 自部署
- 架构概览
- 升级指南 — 任意旧版 → latest 一键
anet upgrade