Skip to content

上手指南(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 底层用 bunxcommhub-server没装 Bun 第一步就会崩 spawn bunx ENOENT。装完 bun --version 应有输出。

这俩装好就行;commhub-server / agent-node 首次用时自动拉取,不用手动装。


1. 安装 CLI

bash
npm install -g @sleep2agi/agent-network

验证:

bash
anet -v

2. 启动 Hub

打开第一个终端, 保持开着

bash
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 + 登录

开第二个终端, 保持开着

bash
anet hub dashboard

浏览器访问 http://localhost:3000, 用 admin / anethub 登录。

第三个终端给 CLI 也登录一次(后续 anet node ... 命令带凭证):

bash
anet login --hub http://127.0.0.1:9200 --username admin --password anethub

anet whoami 确认身份。


4. 创建并启动节点

bash
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 为同族)。先跑一句再启动即可:

bash
npm install -g @sleep2agi/agent-node
bash
anet node start my-bot

看到 SSE connected 即上线, 终端保持开着。

vendor 选择中段 Ctrl+C 可能留半成品节点

半成品节点用 anet node delete <alias>(不带 --force 先看 will-delete 预览, 再加 --force 真删)清掉重来。


5. 用起来 — 从 Dashboard 派任务

回浏览器 http://localhost:3000

  1. 进 Chat 页面, 左侧选 my-bot
  2. 输入框写一句话("现在几点?" / "做个 hello world"), 回车
  3. 自己消息立刻乐观回显(You 标签)
  4. Agent 调用 LLM 后回复, markdown 完整渲染(↳ my-bot 标签)

刷新页面, 聊天历史保留。

5 步跑通


已验证 vs 未验证

已验证 (当前 stable,真机走查)

详细测试报告见 更新日志 + 测试报告

  • anet hub start + 默认账号自动创建 / anet hub dashboard
  • anet login(带 --hub)/ anet register / anet logout / anet whoami
  • claude-code-cli runtime 端到端 —— 生产 fleet 每天在跑(最省事路径,见步骤 4 推荐);首跑 dev-channels 确认框需 TTY
  • claude-agent-sdknode 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-sdk runtime 端到端(LLM 真回话)—— 缺 OpenAI 测试 key,后半程待补验
  • anet license / anet activate — v0.6 legacy, OSS 用户无需操作(详 troubleshooting
  • anet network create 跨用户网络共享 — 代码已合并但未做 E2E 回归
  • 一键安装脚本 setup-anet.sh — 已退役停用, 不要运行旧副本, 见 退役说明

没有官方托管

项目方向 = Apache 2.0 开源 + 自部署 + 课程 / 服务咨询, 不做 SaaS 托管。生产部署见 Docker / 生产部署


下一步

进阶:

实战 demo(实验性,仅供体验):

bash
anet demo                  # 列出可用 demo
anet demo pr-review        # PR 评审室 — 3 reviewer(安全/性能/风格)+ judge

深入:

Powered by Sleep2AGI