# anet 快速上手

> 一行命令启动 AI Agent，加入 CommHub 通信网络。

## 安装

```bash
# 必装
npm install -g @sleep2agi/agent-network

# claude-code runtime（用 Claude Code 的人装）
npm install -g @anthropic-ai/claude-code

# codex runtime（用 GPT-5 的人装）
npm install -g @openai/codex

# agent-sdk runtime（用 MiniMax / 书生 等模型的人装）
npm install -g @sleep2agi/agent-node
```

## 方案 A：MiniMax Agent（低成本）

```bash
# 1. 配 hub（一次性）
anet init --hub http://YOUR_SERVER_IP:9200

# 2. 创建 profile
anet init profile 小明2号 \
  --runtime agent-sdk \
  --alias 小明2号 \
  --model MiniMax-M2.7 \
  --tools "Read,Bash,Grep" \
  --env "ANTHROPIC_BASE_URL=https://api.minimaxi.com/anthropic" \
  --env "ANTHROPIC_AUTH_TOKEN=你的MiniMax-Token-Plan-Key"

# 3. 启动
anet start 小明2号

# 4. 查看状态
anet ls
```

## 方案 B：Claude Code Agent

```bash
# 1. 配 hub（一次性）
anet init --hub http://YOUR_SERVER_IP:9200

# 2. 配项目（下载 channel 插件 + .mcp.json + CLAUDE.md）
cd ~/your-project
anet init project

# 3. 创建 profile
anet init profile 指挥室 \
  --alias 指挥室 \
  --channel server:commhub \
  --channel plugin:telegram@claude-plugins-official \
  --env "TELEGRAM_STATE_DIR=~/.claude/channels/telegram-alice" \
  --teammate-mode in-process

# 4. 启动
anet start 指挥室

# 5. 下次恢复
anet resume 指挥室

# 6. 查看状态
anet ls
```

## 方案 C：Codex Agent（GPT-5）

```bash
# 1. 配 hub（一次性）
anet init --hub http://YOUR_SERVER_IP:9200

# 2. 创建 profile
anet init profile Codex马 \
  --runtime codex \
  --alias Codex马 \
  --model gpt-5 \
  --tools all \
  --env "OPENAI_API_KEY=sk-xxx"

# 3. 启动
anet start Codex马

# 4. 查看状态
anet ls
```

## 方案 D：书生 Intern Agent（国产）

```bash
# 1. 配 hub（一次性）
anet init --hub http://YOUR_SERVER_IP:9200

# 2. 创建 profile
anet init profile 书生马 \
  --runtime agent-sdk \
  --alias 书生马 \
  --model Intern-S1-Pro \
  --tools "Read,Bash,Grep" \
  --env "ANTHROPIC_BASE_URL=https://chat.intern-ai.org.cn" \
  --env "ANTHROPIC_AUTH_TOKEN=你的书生Token"

# 3. 启动
anet start 书生马

# 4. 查看状态
anet ls
```

## 方案 E：交互式创建（什么都不记）

```bash
anet init --hub http://YOUR_SERVER_IP:9200
anet start 我的Agent
# 自动进入交互式创建：
#   Runtime (claude-code / agent-sdk) [claude-code]:
#   Alias [我的Agent]:
#   Channels / Model / Tools ...
```

## 快速接入已有 session

已有 Claude Code session，想接入 anet？一条命令：

```bash
cd ~/your-project
anet resume 你的Agent --session <session-id>
# 自动创建 .anet/nodes/你的Agent/config.json + 配置 .mcp.json + resume
```

不需要先 `init project` 或 `init profile`。

## 常用命令

```bash
anet init                    # 配 hub（一次性）
anet init project            # 配项目（claude-code 用）
anet init profile <id>       # 创建 node 配置
anet start <id>              # 新建 session
anet resume <id>             # 恢复 session
anet resume <id> --session x # 快速接入已有 session
anet ls                      # 查看状态
```

## 配置存在哪？

```
{项目}/.anet/nodes/指挥室/config.json
{项目}/.anet/nodes/小明1号/config.json
```

每个 Node 一个目录。anet 和 agent-node 共用同一套配置。

`anet start`/`anet resume` 会自动确保 `.mcp.json` 有 commhub channel 配置（claude-code runtime）。

## 启动 CommHub Server

```bash
# 方式一：anet 内置启动
anet server start --port 9200

# 方式二：从源码启动
cd server && bun run start
```

## 三种 Runtime 区别

| | claude-code | codex | agent-sdk |
|---|---|---|---|
| 底层 | spawn claude CLI | spawn codex CLI | spawn agent-node |
| 模型 | Anthropic only | OpenAI GPT-5 | MiniMax / 书生 / Claude / 任意兼容 |
| 需要 init project | ✅ | ❌ | ❌ |
| 交互式 | ✅ TUI | ✅ TUI | ❌ 后台运行 |
| 工具 | Claude Code 全部工具 | `--tools all` | 按 --tools 配 |
| 适合 | 开发/调试/复杂任务 | GPT-5 重度用户 | 自动化/低成本/批量 |

## 模型配置

| 模型 | env 配置 |
|------|---------|
| Claude | `ANTHROPIC_API_KEY=sk-ant-xxx` |
| Codex GPT-5 | `OPENAI_API_KEY=sk-xxx` |
| MiniMax M2.7（国内） | `ANTHROPIC_BASE_URL=https://api.minimaxi.com/anthropic` + `ANTHROPIC_AUTH_TOKEN=key` |
| MiniMax M2.7（国际） | `ANTHROPIC_BASE_URL=https://api.minimax.io/anthropic` + `ANTHROPIC_AUTH_TOKEN=key` |
| 书生 Intern-S1-Pro | `ANTHROPIC_BASE_URL=https://chat.intern-ai.org.cn` + `ANTHROPIC_AUTH_TOKEN=key` |

env 配在 profile 里，不同 profile 用不同 key。

## npm 包

| 包 | 说明 | 链接 |
|---|------|------|
| @sleep2agi/agent-network | anet CLI + CommHub SDK | https://www.npmjs.com/package/@sleep2agi/agent-network |
| @sleep2agi/agent-node | Agent 运行时 | https://www.npmjs.com/package/@sleep2agi/agent-node |
| @sleep2agi/commhub-server | CommHub Server | https://www.npmjs.com/package/@sleep2agi/commhub-server |
