AI Gateway Client

把 Codex 与 AI 编程工具一次配置好

下载对应系统完整包，解压后打开应用并输入激活码；需要哪个智能体，再点击对应的安装按钮。

下载 Mac M 芯片压缩包 查看全部版本
当前主推版本 macOS Apple Silicon · 0.1.0 适合 M1/M2/M3/M4 内测版已做完整性签名，尚未完成 Apple 公证
1下载安装包
2本地解压打开
3输入激活码
4按需配置工具
已可用

Mac M 芯片完整包

适合 Apple Silicon：M1/M2/M3/M4。当前优先路线，压缩包内含 app、打开脚本和用户说明。

下载 ZIP 查看 SHA-256
准备版

Mac Intel 完整包

适合 Intel 老款 Mac。构建脚本已准备，等待 Intel/Rosetta x86_64 环境生成正式产物。

等待实机构建
准备版

Windows x64 完整包

适合 Windows 10/11 x64。PowerShell 构建脚本已准备，等待 Windows 环境生成 exe。

等待实机构建

智能体安装源

这张表供用户核对来源；客户端实际携带激活后的 token 读取服务端 JSON 目录，不会解析本网页。

智能体 当前支持 安装源 客户端校验 状态
Codex 桌面版 macOS / Apple Silicon OpenAI 官方直连 HTTPS 域名、Bundle ID、Team ID、公证、arm64 可自动安装
Claude Code 待发布 Anthropic 来源待核验 安装方式与版本校验待发布 暂未开放
Hermes 待发布 具体产品身份待核验 安装包身份待发布 暂未开放
OpenClaw 待发布 具体产品身份待核验 安装包身份待发布 暂未开放

当前 Codex 由客户端直连官方 CDN 下载，不经过 AI 网关 ECS。集中目录方便统一更新；真正的国内下载加速需要在获得再分发许可后接入 OSS/CDN。 用户端不提供版本选择，始终安装管理员当前发布的唯一版本。

超级说明书

每个端都有独立说明，展开即可查看。

用户端：Mac M 芯片安装流程
  1. 下载 `AIGatewayClient-macos-arm64-0.1.0.zip` 并解压。
  2. 双击 `AI Gateway Client.app`，如无反应再双击 `Open AI Gateway Client.command`。
  3. 如果 macOS 提示无法验证开发者，按住 Control 点击应用，选择“打开”。
  4. 输入服务端发放的激活码，点击“激活”。
  5. 激活成功后进入工具工作台，但不会一次性安装全部智能体。
  6. Mac Apple Silicon 用户点击 Codex 的“安装”后，客户端自动下载官方包、校验、安装、配置并打开。
  7. 其它智能体的可信安装源发布前会显示“暂未发布”，不会执行未经校验的命令。
管理端：发激活码、充值、查看用户
  1. 打开 `https://admin-ai.tmatrix.top`。
  2. 服务地址默认使用 `https://api-ai.tmatrix.top`。
  3. 使用 owner/operator token 登录开发后台。
  4. 在“分发激活码”里设置套餐、设备数、token 额度并生成。
  5. 在“账本流水”查看 grant、recharge、debit。
  6. 在“授权与设备”查看 license、设备数、token 数和到期时间。
服务端：API、provider 与部署
  1. 开发演示运行 `.venv-server/bin/python scripts/run_demo.py`。
  2. 用户端激活走 `/agent/api/activate`。
  3. 工具请求走 `/v1/*` 或 `/codex/*`。
  4. 客户端安装目录走需用户 token 鉴权的 `/agent/api/tools`，不从下载页抓取链接。
  5. provider 当前支持 mock 和百炼 OpenAI-compatible adapter。
  6. 部署材料见 `docs/deployment-runbook.md`、`docs/proxy-tls-runbook.md`。