快速开始
前置条件
- 已安装 ATM(参见 安装)。
- 本机至少已安装并运行过一次以下工具之一:
- Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw(完整路由支持)
- Cursor、Doubao、GitHub Copilot、DeepSeek(仅用量统计)
第 1 步 — 扫描本机工具
启动 ATM,点右上角 重新扫描。ATM 读取 ~/.claude/、~/.codex/、~/.openclaw/ 等已知路径,将识别到的工具写入本地数据库。
在 ATM 之外修改配置文件后,需重新扫描以同步变更。
第 2 步 — 确认 Agents 列表
点左侧 Agents。每个识别到的工具显示为一张卡片,包含路由状态和供应商信息。
若某工具未出现,最常见原因为:该工具从未在本机运行过,配置文件尚未生成。请先运行该工具一次,再执行重新扫描。
第 3 步 — 选择供应商
点左侧 供应商。页面按协议分为 Claude 槽位、Codex 槽位等。根据需要选择路由方式:
| 选择 | 适合场景 |
|---|---|
| 普通 API 供应商(如 aiping.cn) | 直接连接上游,配置最简。推荐首次使用 |
| ATM Gateway | 需要请求日志、per-Agent key 或策略路由时 |
选定后点 启用,ATM 自动将变更写入 Agent 的配置文件。
第 4 步 — 重启 Agent
大多数工具仅在启动时读取一次配置。ATM 写入后,需完全退出并重新启动 Claude Code、Codex 等工具,变更方可生效。
第 5 步 — 验证
发起一次正常请求,然后在 ATM 中确认:
- 用量页:新增 Token 应在数秒内出现在趋势图和分布图中。
- 日志页(仅限 ATM Gateway 路由):请求记录含供应商、模型、延迟和 Token 数。
可选:启用 ATM Gateway
如需请求日志、per-Agent key 和策略路由:
- 打开 概览 → 点 启动,等状态变为
运行中。 - 打开 供应商 → 切换至 ATM Gateway → 点 启用。
- 重启 Agent,再发起一次请求。
ATM Gateway 不会随路由切换自动启动。请先从概览页手动启动,否则请求将直接失败。
后续步骤
- 配置路由策略
- 接入具体工具:Claude Code · Codex · OpenClaw · 通用 Agent