tingly-box

核心能力

• 作为本地网关统一接入智能体请求，并在 OpenAI、Anthropic、Gemini 等协议之间转换。
• 为一键或手动配置 Claude Code、Codex、OpenCode、Xcode 等客户端集中模型和凭据。
• 用 Web 控制台管理服务商、路由、别名、用户令牌和用量，并按成本、速度或自定义策略分配请求。
• 通过 Telegram、飞书、企业微信、Slack、Discord 等机器人远程控制智能体，可使用 API Key 或部分服务的 OAuth 配额。

如何开始

1. 1
   用 npx 安装并启动

   无参数运行时会自动重启、迁移并打开 Web UI。网络异常时可改用内置二进制的 bundle 包。

   npx tingly-box@latest

2. 2
   用 Docker 后台运行

   先创建数据目录，再映射 12580 端口和数据卷启动容器。

   mkdir tingly-data
   docker run -d \
   --name tingly-box \
   -p 12580:12580 \
   -v `pwd`/tingly-data:/home/tingly/.tingly-box \
   ghcr.io/tingly-dev/tingly-box

3. 3
   配置即时通讯远程控制

   打开本机 Web UI，进入 Remote 区域配置所选平台的机器人后即可远程交互。