Agent Network

简体中文

English

简体中文

English

Appearance

节点 Runtime ​

每个 Agent Node 都有一个 Runtime（运行时内核），决定这个节点用什么方式调用大模型 / 跑工具。Agent Network 内置多种 Runtime（正式版 4 种，预览版另加 2 种），同一个 Hub 上可以混搭——一个 Claude Code CLI agent 调任务给 MiniMax agent，再让 Codex agent 写代码，结果汇总回来。

Runtime 对比（canonical 表） ​

本表是全站 runtime 信息的单一权威来源, 其他页面 (cli / agent-node / getting-started / clean-server) 都引用这里, 别在那些页面里重复整表.

哪些 runtime 在哪个版本可用（真机实测）

  • 正式版（npm i -g @sleep2agi/agent-network）：正式 runtime —— claude-agent-sdk / claude-code-cli / codex-sdk / grok-build-acp。具体版本以 npm latest dist-tag 为准。
  • 预览版（@preview）：在正式版之外再加 codex-app-server / opencode-cli；且对未知 runtime 会明确报错拦截（正式版会静默退化成默认 runtime，不报错）。

下表标 (preview) 的行仅预览版可用，正式版选不到。

Grok TUI 共存尚未发布

grok-build-cli / anet grok attach 不在当前 latest 或 preview 包中，因此不属于下面的可选 runtime。当前请使用 grok-build-acp；它不支持 attach。详见 Grok TUI 状态页。

Runtimenpm 包 / 内核适用场景主推模型前置 authwizard 行为 (anet node create)
claude-code-cli ⭐推荐入门spawn 本机 claude 命令想"像在终端用 Claude"那样干活, 复用 Claude 订阅 0 配置（有 Claude 订阅的首选，最稳）Claude Sonnet / Opus (订阅)已 claude auth login选完直接结束, 跳过 vendor / model / API key
claude-agent-sdk@anthropic-ai/claude-agent-sdk (随 agent-node 装)编程式调用任意 Anthropic 兼容 APIAnthropic 直连 / MiniMax / 书生 Intern / 小米 MiMo / DeepSeek / GLM / Kimi / OpenRouter / vLLM / SiliconFlow / 通义千问 ... (完整表)API Key唯一会弹 vendor 子菜单 → 选 vendor → 选 model → 填 API Key
codex-sdk@openai/codex-sdk (随 agent-node 装)写代码 / 跑命令OpenAI Codex (gpt-5 等)已 codex login (@openai/codex CLI)选完 print codex login hint, 跳过 vendor
grok-build-acpspawn 本机 grok ACP server用 xAI Grok Build 跑任务 / 协作xAI Grok (grok-build 系列)已 grok login + GROK_CODE_XAI_API_KEY env (该 runtime 另需该 env, 非 wizard 输出)选完 print grok login hint, 跳过 vendor
codex-app-server (preview)OWNED codex app-server 桥 (RFC-030)复用 codex TUI / 人机共存桥（人和 agent 共用一个 codex 会话）OpenAI Codex (gpt-5.5 等)已 codex login（该 runtime 需 codex CLI）选完 print codex login hint, 跳过 vendor
opencode-cli (preview)spawn 本机 opencode 命令 (公版 sst/opencode CLI, 固定 opencode-ai 版本 pin)用公版 opencode 做多 vendor 前端 (统一 session / auth 抽象, RFC-029)多 vendor: Anthropic 原生 / OpenAI preset装 opencode CLI (npm i -g opencode-ai@<pin>) + 选 vendor preset (Anthropic 读 ANTHROPIC_API_KEY / OpenAI 读 OPENAI_API_KEY env)选完提示装 opencode CLI → 选 vendor preset (anthropic / openai), API key 从 env 读、不 prompt

⚠️ opencode-cli 仅 preview 渠道（RFC-029 迭代中）：npm latest 尚未包含——装 latest 后 anet node create 选单只有正式版的那几个 runtime（claude-code-cli / claude-agent-sdk / codex-sdk / grok-build-acp）。稳定后再进 latest。

OpenCode 内置 Anthropic client 发送 x-api-key。只接受 Bearer 的 Anthropic 兼容网关（例如 Kimi coding）会返回 401；这类网关要使用支持对应鉴权的 OpenCode plugin 或自定义路径，不能直接套内置 Anthropic preset。

Agent Node 不读取名为 TOOLS 或 SYSTEM_PROMPT 的环境变量。工具列表请用 --tools 或配置项 tools；系统提示词请用 --prompt 或配置项 systemPrompt。

不知道怎么选?

  • 想白嫖 Claude 订阅 / 新手最省事 → claude-code-cli (claude auth login 后 0 配置)
  • 写文案 / 翻译 / 分析 (编程式) / 接国产模型 → claude-agent-sdk + 在 wizard 里选对应 vendor
  • 写代码 / 跑命令 → codex-sdk
  • 人和 Agent 共用一个 Codex TUI/thread → preview codex-app-server + anet node start <alias> --copresence（完整指南）
  • 用 xAI Grok Build → grok-build-acp (详细 runtime 指南 ↗)
  • 想用公版 sst/opencode CLI 当多 vendor 前端（统一 session/auth） → opencode-cli（需本机装 opencode CLI + Anthropic/OpenAI env key，RFC-029）
  • 接国产 / 非内置 vendor (GLM / Kimi / OpenRouter / vLLM / SiliconFlow / 通义千问 等) → claude-agent-sdk + 在 vendor 子菜单选 自定义 (custom) + ANTHROPIC_BASE_URL
  • 混搭 (推荐) → 在同一 Hub 按角色组合当前可用 runtime

wizard 顺序速览

向导真实顺序: 节点名 → runtime → (仅 claude-agent-sdk) vendor → model → API Key / 鉴权. runtime 菜单（正式版 4-way / 预览版 6-way）默认高亮第一项 claude-agent-sdk (要配 vendor + key, 复杂度最高); 新手强烈建议手动选 claude-code-cli. 完整步骤见 上手指南 §5.

claude-code-cli ​

复用你本地已经登录的 Claude CLI 订阅——不用 API Key、不用 token，跑起来就能干活。

前置 ​

@sleep2agi/agent-network 自己不会帮你装 Claude CLI——它是 spawn 你本机已有的 claude 二进制。所以你得先把 CLI 装好、登录好。

1. 安装 Claude Code CLI（npm 全局包）：

bash
npm install -g @anthropic-ai/claude-code

2. 登录 Claude.ai 订阅（OAuth 流程，浏览器一次性授权）：

bash
claude auth login        # 显式触发登录（idempotent, 脚本化首选）
# 或
claude                   # 首次启动会自动弹登录提示，按引导走完即可

3. 验证：

bash
claude --version
# 期望输出：claude-code 1.x.x（具体版本号可能不同）

which claude
# 期望输出：一个 PATH 上能找到的路径，比如 /usr/local/bin/claude 或 ~/.npm-global/bin/claude

常见坑：装完 claude: command not found。原因是 npm 全局 bin 不在 PATH 上。修复：

bash
npm config get prefix
# 把输出后面加 /bin 加进你的 PATH，比如：
# export PATH="$(npm config get prefix)/bin:$PATH"

写进 ~/.bashrc / ~/.zshrc 后 source 一下即可。

工作原理 ​

anet node start  →  spawn 本机 `claude` 二进制子进程
                 ↓
         .mcp.json 注册 commhub: { type: "stdio", command: "bun",
                                   args: [".anet/node-server.js"] }
                 ↓
         claude 二进制 spawn bun .anet/node-server.js 当 stdio MCP server
                 ↓
         node-server.ts 内部把工具调用 HTTP 转发到 CommHub /mcp
  • 节点启动时 anet CLI 在 cwd 写 .mcp.json（agent-network/bin/cli.ts ensureMcpJson）+ spawn claude 二进制
  • claude 按 .mcp.json 起一个本地 bun MCP server（.anet/node-server.js，源码 用 StdioServerTransport）
  • 本地 MCP server 内部把 commhub 工具调用 HTTP 转发到 CommHub /mcp
  • 完整 4 runtime MCP 路径对比 + tool name 命名空间差异见 架构 → MCP 接入路径

适用场景 ​

  • 你已经在用 Claude Code（claude.ai 订阅）
  • 想把日常 Claude session 接入多 Agent 协作
  • 不想为 API 单独付费

配置示例 ​

bash
anet node create my-bot --runtime claude-code-cli
anet node start my-bot

config.json：

json
{
  "runtime": "claude-code-cli",
  "session": "550e8400-e29b-41d4-a716-446655440000",
  "flags": {
    "dangerouslySkipPermissions": true,
    "teammateMode": "in-process"
  }
}

注意 ​

  • 需要本机已 claude --version 能跑（即 Claude Code CLI 已安装并登录）
  • session 字段由 anet node create 预生成。首次 anet node start 会用 claude --session-id <uuid> 绑定这个 UUID；之后只要 ~/.claude/projects/<cwd>/<uuid>.jsonl 已存在，就自动用 claude --resume <uuid> 续同一个 Claude Code 对话。
  • 与 SDK runtime 的关键差别：CLI runtime 拥有 Claude Code 的全套能力（文件操作 / Bash 执行 / MCP 工具）

claude-agent-sdk ​

编程式调用 任意 Anthropic 兼容 API —— 默认接 Anthropic，也能指 MiniMax / DeepSeek / GLM / Kimi 等国产模型的 Anthropic 兼容 endpoint。

前置 ​

这个 runtime 不需要你额外装任何二进制——@anthropic-ai/claude-agent-sdk 在 @sleep2agi/agent-node 的 dependencies 里，npm install -g @sleep2agi/agent-node 时自动一起装（不是打进 dist 里 bundle，build flag 是 --external，但 sub-dep 解析时会拉下来）。你只要装 anet 本体 + 准备好一个 API Key。

1. 安装 anet（如果还没装）：

bash
npm install -g @sleep2agi/agent-network
# 当前 latest 见 https://www.npmjs.com/package/@sleep2agi/agent-network

2. 准备 API Key（任选一家）：

Provider环境变量申请入口
AnthropicANTHROPIC_API_KEYhttps://console.anthropic.com
MiniMaxANTHROPIC_AUTH_TOKEN + ANTHROPIC_BASE_URL=https://api.minimaxi.com/anthropicMiniMax 开放平台
DeepSeek / GLM / Kimi / 书生 / 小米 MiMo / OpenRouterANTHROPIC_AUTH_TOKEN + ANTHROPIC_BASE_URL=<对应 endpoint>各家开放平台

国产模型 + OpenRouter 完整 endpoint 表见 多模型配置。

3. 验证：

bash
anet --version
# 期望输出：当前 anet 版本号（npm latest tag）

# 启起来一个节点后看进程
anet node start planner
# 期望：日志里能看到 "spawned @anthropic-ai/claude-agent-sdk"，不会因为找不到 SDK 包而崩

常见坑：节点起来后立刻报 401 Unauthorized 或 invalid x-api-key。原因是 ANTHROPIC_AUTH_TOKEN（国产 endpoint）和 ANTHROPIC_API_KEY（Anthropic 直连）这两个变量没分清。修复：

  • 接 api.anthropic.com → 用 ANTHROPIC_API_KEY
  • 接 任何第三方 Anthropic 兼容 endpoint → 用 ANTHROPIC_AUTH_TOKEN + ANTHROPIC_BASE_URL

工作原理 ​

anet node start  →  spawn agent-node 子进程
                 ↓
         @anthropic-ai/claude-agent-sdk → POST ANTHROPIC_BASE_URL
                 ↓
         commhub 工具走 in-process SDK MCP (#102 Option A):
           createSdkMcpServer({ name: "commhub" }) 注册 7 个工具
           handler 转发到 CommHub POST /mcp (JSON-RPC initialize + tools/call)
  • agent-node 进程通过 SDK 调 Anthropic 兼容 API
  • 默认 api.anthropic.com，可通过 ANTHROPIC_BASE_URL 重定向到任何兼容服务
  • settingSources: [] 完全隔离宿主机配置，不会读你本地的 ~/.claude/
  • LLM 看到的 commhub 工具名是 SDK namespace 化的 mcp__commhub__send_task 等（单 commhub 前缀；非二进制 HTTP MCP 路径）—— 完整 4 runtime MCP 路径对比见 架构 → MCP 接入路径
  • vendor adapter（针对书生 intern 等的 system-prompt bias）也在这层注入 —— 详见 Vendor 适配层

适用场景 ​

  • 用 Anthropic 直接 API（不想依赖订阅）
  • 用 MiniMax / DeepSeek / GLM / Kimi / 书生 / 小米 MiMo 等国产模型（低成本 / 高吞吐 / 国内直连；完整 provider 表）
  • 需要灵活切 model（不同任务用不同模型）

配置示例 ​

Anthropic 直连：

bash
ANTHROPIC_API_KEY=sk-ant-xxx \
anet node create planner \
  --runtime claude-agent-sdk \
  --model <anthropic-model-id>

MiniMax：

bash
anet node create translator \
  --runtime claude-agent-sdk \
  --model <minimax-model-id> \
  --env "ANTHROPIC_BASE_URL=https://api.minimaxi.com/anthropic" \
  --env "ANTHROPIC_AUTH_TOKEN=sk-cp-xxx"

config.json：

json
{
  "runtime": "claude-agent-sdk",
  "model": "<minimax-model-id>",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.minimaxi.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-cp-xxx"
  }
}

已验证模型 ​

下表是 anet node create 供应商选单（cli.ts VENDORS 列表）里 claude-agent-sdk runtime 的内置 provider —— vendor 选单只在选 claude-agent-sdk runtime 后才出现（v0.9.2 起 #133 runtime-first wizard：先选 runtime，claude-code-cli / codex-sdk 各自 print auth login hint 跳过 vendor）。每项的 baseUrl + model id 都跑通过真 API 验证：

Provider模型ANTHROPIC_BASE_URL
Anthropic当前主线 Sonnet / Opus / Haiku（具体型号查 Anthropic 官方）（Anthropic 原生，不需设 base URL）
MiniMax当前主线 M 系列（查 MiniMax 开放平台）https://api.minimaxi.com/anthropic
书生 InternLMIntern-S2-Preview（默认）/ Intern-S1-Pro（查 书生）https://chat.intern-ai.org.cn（裸域名，无 /anthropic 后缀 —— 跟 MiniMax 等不同）
小米 MiMomimo-v2.5-pro（默认）/ v2.5 / v2-pro / v2-omni（查 小米开放平台）https://token-plan-cn.xiaomimimo.com/anthropic

来源：cli.ts VENDORS。GLM / Kimi 等没跑通验证的 provider 故意不进 VENDORS 列表 —— 用「自定义」custom 供应商接入（任何 Anthropic 兼容 API 都能填 base URL + model）。

模型版本号会变

各家 LLM 厂商每隔几周升级模型，硬编码具体版本号容易过时。到对应平台拿最新 model id，填到 --model 参数即可。

国产模型 endpoint 完整列表

查看 多模型配置 — 每家厂商的 Anthropic 兼容 URL + 示例 key。

codex-sdk ​

接 OpenAI Codex CLI —— 适合写代码、跑命令，工具调用最灵活。

前置 ​

@openai/codex-sdk 在 @sleep2agi/agent-node 的 optionalDependencies 里（不是常规 deps）—— npm 7+ 默认会跟着 agent-node 一起拉下来，但 SDK 本身要 spawn 一个 codex 二进制，所以你还得把 codex CLI 全局装一遍。如果 anet node start 抛 Cannot find module '@openai/codex-sdk'，手动补一下：npm install -g @openai/codex-sdk。

1. 安装 codex CLI（npm 全局包）：

bash
npm install -g @openai/codex

2. 登录 OpenAI（任选其一）：

bash
# 方式 A：OAuth 流程（推荐，复用 ChatGPT Plus / Pro 订阅）
codex login

# 方式 B：直接走 API Key
export OPENAI_API_KEY=sk-xxx

3. 验证：

bash
codex --version
# 期望输出：codex 0.x.x（具体版本号可能不同）

codex login status
# 期望：显示当前登录的 OpenAI 账号 / API key 状态

常见坑：节点启动时报 Error: spawn codex ENOENT。原因是 codex 不在 PATH 上——@openai/codex-sdk 只是 Node 封装层，实际调用还是要找全局 codex 二进制。修复：

bash
which codex
# 如果空，说明没装或者 npm 全局 bin 没在 PATH 上
npm install -g @openai/codex
# 装完仍然找不到，参见 claude-code-cli 章节的 PATH 修复方法

工作原理 ​

anet node start  →  spawn agent-node 子进程
                 ↓
         agent-node 内调 @openai/codex-sdk 起 codex thread
                 ↓
         codex thread 用 baked-in tools (Read/Write/Edit/Bash/Grep/Glob/WebSearch)
                 ↓
         agent-node 父进程外部维持 SSE + report_status/get_inbox/send_reply
  • 通过官方 @openai/codex-sdk 包驱动 codex thread
  • 支持 Read / Write / Edit / Bash / Glob / Grep / WebSearch（codex CLI baked in）
  • 鉴权走 codex login（OAuth 流程）或 OPENAI_API_KEY
  • codex thread 不直接调 commhub MCP 工具（codexOpts 不传 mcpServers，agent-node/src/cli.ts）—— 多 Agent 派活由 agent-node 父进程外部完成，详见 架构 → MCP 接入路径

适用场景 ​

  • 用 OpenAI 官方 Codex / gpt-5 等最新模型
  • 需要让 Agent 写代码 / 跑命令 / 操作文件
  • 工具调用 / function calling 强需求

配置示例 ​

bash
codex login  # 一次性

anet node create coder \
  --runtime codex-sdk \
  --model <codex-model-id>

config.json：

json
{
  "runtime": "codex-sdk",
  "model": "<codex-model-id>"
}

codex-sdk 不吃 tools

codex-sdk runtime 静默忽略 --tools flag 和 config.json 的 tools 字段（verify agent-node/src/cli.ts codexOpts 无 tools 字段）。工具集由 codex CLI 二进制 baked in，不由 anet 配置。--tools 只对 claude-agent-sdk runtime 生效。

验证状态

codex-sdk runtime 单元测试通过，但端到端验证不全（缺真实 codex 鉴权回归）。如果你正在跑生产任务，建议先 anet node start 后用一个简单任务（"列出当前目录文件"）验证。

v0.10.0 新增 — codex-direct-stdio opt-in 路径（#141）

v0.10.0 起 agent-node 内嵌一条 bypass @openai/codex-sdk wrapper 的直 stdio JSON-RPC 客户端路径（~155 LOC，verify agent-node@2.4.0）。开启方式：

bash
ANET_CODEX_STDIO_DIRECT=1 anet node start <codex-node>

启用后 agent-node 走 spawn('codex', ['app-server']) + 67-method v2 protocol surface（thread / turn / item / realtime），绕开 @openai/codex-sdk --mcp-config HTTP transport 那条 bug 链（#102 hang root cause family），不再受 codex-sdk breaking change 牵制。

v0.10.x（含当前 stable）默认仍走 @openai/codex-sdk wrapper（先收 preview 反馈、保 backward-compat）；v0.11.0 计划 default flip 到 stdio direct，wrapper 路径进入 deprecation warning。完整背景见 v0.10.0 GitHub release notes。

codex-app-server（Codex TUI 桥, RFC-030） ​

想让人和 agent 共用同一个 Codex 会话（人机共存）？完整分步指南见 Codex TUI 人机共存 (preview)。

把一个 codex CLI 的 TUI 会话接进网络当节点 —— 节点自己起一个独立的 codex app-server，桥（bridge）作为客户端订阅同一条 codex thread。跟 codex-sdk 的关键区别：codex-sdk 是 agent-node 内嵌 SDK 独占管理 codex thread；codex-app-server 用的是标准 codex app-server 协议，一条 thread 可以被多个客户端订阅——于是你在 codex TUI 里手打的那个会话，可以同时变成网络节点。

前置 ​

装 codex CLI 并登录（跟 codex-sdk 一样）：

bash
npm install -g @openai/codex
codex login       # 或 export OPENAI_API_KEY=sk-xxx
codex --version        # 期望 codex 0.144.0 及以上（app-server 协议以此为准）

工作原理 ​

anet node start  →  spawn agent-node 子进程（runtime=codex-app-server）
                 ↓
      收到派工时: spawn `codex app-server --listen ws://127.0.0.1:<临时端口>`
                 ↓
      bridge 连上 app-server → thread/start 新建并拥有一条 thread
                 ↓
      入站 send_task → bridge.submitTask → 一次 codex turn → 最终答案
                 ↓
      结果用 send_task 回派单方（见下方「回复用 send_task」）
  • 收（入站）：网络 send_task → 节点 inbox → 走桥 → codex 执行一轮
  • 发（出站）：codex 出答案 → 普通 CommHub send_task 回发起方（桥只包住「让 codex 跑一轮」）
  • 单条 thread 同一时刻只有一个 active turn；第二个任务在桥里 FIFO 排队，等当前 turn（自己的或人类 TUI 的）结束再跑
  • 审批只归人类：桥永不代答 approval，需要审批的 turn 会挂起等人类在 TUI 里处理

两种拓扑 ​

推荐的人机共存入口不是手改 config，而是 preview CLI 的一等命令：

bash
cd /path/to/project
for v in $(env | sed -n 's/^\(COMMHUB_[A-Za-z0-9_]*\)=.*/\1/p'); do unset "$v"; done
anet node create codexbridge --runtime codex-app-server
anet node start codexbridge --copresence
tmux attach -t =codexbridge

它统一编排独立 app-server、bridge 与 TUI，默认只读。完整权限、恢复、停止与原生 Windows 手工 WS 步骤见 Codex TUI 人机共存。

① 独占（默认） —— 节点自己起 app-server + 新建 thread。多个 codex-app-server 节点互不干扰：

bash
codex login
anet node create codexbridge --runtime codex-app-server
anet node start codexbridge
jsonc
// config.json
{ "runtime": "codex-app-server", "model": "gpt-5.5" }

② 接管已有 codex 会话 —— 让一个正在运行的 codex 会话同时变成节点。--copresence 会自动生成并保存 URL/thread 绑定；高级或原生 Windows 手工路径也可在创建节点时传：

bash
anet node create codexbridge --runtime codex-app-server \
  --codex-app-server-url ws://127.0.0.1:<free-port> \
  --codex-thread-id <thread-id>

桥作为第二个客户端 thread/resume 复用该线程。TUI 接入时必须运行 codex resume --remote <ws-url> <thread-id>，不能省略 thread id。每个节点必须使用独立 app-server，不能跨节点共用进程级 CommHub token。

回复用 send_task（不是 send_reply） ​

实测：hub 的 send_reply 会把回复塞进发起方收件箱，但不会 SSE 唤醒直接发起方——对端 agent 只能等下次轮询才看到。send_task 会立刻 new_task 唤醒。所以 codex-app-server 节点回复派工统一走 send_task（只对该 runtime 生效，不改其他 runtime 的行为）。收发两个方向都是 send_task。

适用场景 ​

  • 想让人类的 codex TUI 会话同时接入网络（人机共用一条 thread）
  • 想开多个独立 codex 节点各干各的
  • 想要标准 codex app-server 协议而非 SDK 封装

验证状态（Phase 0A / preview 形态）

当前是方案 A 直接双客户端——已真机自验（桥 17 + client 12 单测、741 全量零回归、隔离 hub 真节点 e2e send_task→codex→send_task 闭环 PASS），适用于单机可信 preview。尚未做生产加固：人类 TUI 与桥直连 codex 会在 active turn 争抢、审批「只归人类」目前是代码纪律非权限边界、桥持有 app-server 原始控制面。生产形态是方案 B 单 upstream Policy Gateway（排队仲裁 + 审批只递人类 + 最小权限投递口），见 RFC-030 §18 实现现状 + §8 硬门。

grok-build-acp ​

用 xAI Grok Build 本地 CLI 跑 agent —— 节点 spawn 本地 grok agent stdio 进程 + Agent Client Protocol (ACP) 协议交互，复用本机 Grok 登录态。v0.10.8 起正式接入；v0.10.11 #204 加 per-node isolated cwd 解决多节点身份污染（已在 npm latest）。

前置 ​

起节点 ​

bash
anet node create my-grok --runtime grok-build-acp
anet node start my-grok

长任务超时调整（flags.grokAcpTimeoutMs） ​

当前行为：agent-node 给每个 session/prompt 调用设一个整体硬超时，默认 300000 ms（5 分钟）。视频生成 / 大型 X 搜索 / 多轮 batch 工具调用这种长任务跑超 5min 时，agent-node 会主动 reject 整个请求并把 task 标 failed。

调大上限有两条路（任选其一，env 变量优先）：

bash
# 1) 临时调（启 grok 节点前 export）
GROK_ACP_TIMEOUT_MS=900000 anet node start my-grok
json
// 2) 长期调（写进 .anet/nodes/<alias>/config.json）
{
  "runtime": "grok-build-acp",
  "flags": {
    "grokAcpTimeoutMs": 900000
  }
}

取舍：调大可以让真长任务跑完，但 hang 类问题（agent 真的卡住、不是慢）会更晚被发现；遇到误超时再调，别盲目设很大值。

startup log 以当前 latest 为准

旧版本 agent-node 启动时不打 timeoutMs=... log 行——值会从 agent-node/src/cli.ts 读取，但 anet node start 输出不一定反映。如果跑了一个确定 > 5 min 的任务仍在 300 s 卡住，多半是 flags.grokAcpTimeoutMs 没被读到 (config 写错位置 / env 字段名 typo)；请先升级到 npm latest，再开 issue 上报。

详见 ​

跨 Runtime 协作（Mesh 派活） ​

Agent Network 的核心价值：同一个 Hub 上让不同 Runtime 互相派活。

bash
# 1. Claude Code CLI agent —— 用本地订阅当指挥
anet node create planner --runtime claude-code-cli

# 2. MiniMax agent —— 翻译 / 文案
anet node create translator \
  --runtime claude-agent-sdk \
  --model <minimax-model-id> \
  --env "ANTHROPIC_BASE_URL=https://api.minimaxi.com/anthropic" \
  --env "ANTHROPIC_AUTH_TOKEN=sk-cp-xxx"

# 3. Codex agent —— 写代码
anet node create coder --runtime codex-sdk --model <codex-model-id>

# 4. 三个都启动
anet node start planner
anet node start translator
anet node start coder

在 Dashboard 里给 planner 发：

把这段英文翻译成中文，再让 coder 写一个 Python 脚本把翻译结果写入文件。

planner 会通过 commhub MCP 的工具：

  1. get_all_status — 发现 translator + coder 在线
  2. send_task(alias="translator", task="翻译...") — 派出翻译任务
  3. get_task — 轮询拿翻译结果
  4. send_task(alias="coder", task="写一个脚本把这段文字写入 output.txt") — 派出写代码任务
  5. 整合两边结果，回复给你

整个交互在 Dashboard 的 Tasks / Messages 页面实时可见。

取舍 cheat sheet ​

你的需求推荐 Runtime
已经付了 Claude 订阅，不想再付 APIclaude-code-cli
用国产模型（MiniMax / DeepSeek / GLM / Kimi / 书生 / 小米 MiMo 等）claude-agent-sdk + ANTHROPIC_BASE_URL
用 Anthropic 官方 API（稳定后台）claude-agent-sdk
写代码 / 跑 shell 命令codex-sdk
写文案 / 翻译 / 分析 / RAGclaude-agent-sdk
想要 Claude Code 全套能力（文件 / Bash / MCP）claude-code-cli
团队混搭（指挥 + 翻译 + 写代码）三个全开，每角色配最合适的

已验证 vs 未验证 ​

已验证（当前 stable 继承 v2 E2E 覆盖）

  • claude-agent-sdk runtime 本身 —— E2E 通过
  • vendor 维度：anet node create 的 VENDORS 列表（cli.ts） 里每个 provider（Anthropic / MiniMax / 书生 Intern / 小米 MiMo）的 baseUrl + model id 都是 verified-with-real-call 才进列表的
  • 多 Runtime 混搭（peer agents 通过 get_all_status + send_task + get_task 自治协调）

未验证（请自行评估）

  • claude-code-cli —— 本机能跑（v0.8.2 修了 session resume 默认丢失 bug，详见 changelog），未做 E2E 回归
  • codex-sdk —— 单元测试通过，缺真实 codex 鉴权回归
  • GLM / Kimi 等没跑通验证的 provider —— 故意不进 VENDORS 列表（#104-B 设计：列表里的都是 verified，没验证的不混进去）；要用就走「自定义」custom 供应商接入，能用但请自己先验证 endpoint + model id

下一步 ​

想深入 SDK 层？

本页面是 user how-to。如果你想搞清两个 SDK adapter（claude-agent-sdk / codex-sdk）在 session / tool / streaming / 计费 / 错误处理上的具体差异，以及 anet wrapper 怎么收敛它们 —— 看 SDK Deep-dive。

Powered by Sleep2AGI

© 2026 sleep2agi