快速上手

CloudBridge 把你的云平台和大模型平台账单读进本机的一本账——数据可以来自账单 API，也可以来自你下载的账单文件——然后画出趋势。不用注册，不同步，没有遥测。这一页带你从下载走到第一份账单。

1. 安装

从 Releases 页面下载最新版本：

平台	文件
macOS（Apple 芯片）	`cloudbridge-macos-arm64.dmg`
Windows（x64）	`cloudbridge-windows-x64.exe`

macOS。 打开 .dmg，把 CloudBridge 拖进 Applications（应用程序），再从那里启动。发布版本带 Developer ID 签名并经过公证，打开时不需要任何绕过操作。如果 macOS 拦截了当前版本，请报告具体的提示内容和你的 macOS 版本；不要把移除隔离属性当成常规安装步骤。

Windows。 .exe 没有代码签名，SmartScreen 很可能会提示 Windows protected your PC。先确认文件来自官方 Releases 页面，再点 More info 和 Run anyway。Windows 会记住对这个文件的选择；新版本会再问一次。

不提供 Linux 和 Intel Mac 的安装包。从源码构建需要 Rust 1.95 或更新版本，见开发环境配置：

bash

git clone https://github.com/JetSquirrel/cloudbridge.git
cd cloudbridge
cargo run --release

2. 想先看看也可以

浏览器演示用一份示例账单运行同样的页面。它不保存任何凭据，也不连接任何云平台，所以导入账单、从账单 API 刷新和 SQL 查询只能在桌面版里用。

在应用里，空的总览页会提供 Load demo data（加载演示数据），也可以打开 Settings → Demo data。演示账号不带凭据，刷新时会跳过；同一页的 Clear demo data 可以清除它们。

3. 添加账号

打开 Accounts，点 Add account，选择数据源并填一个名字。

数据源	账单怎么进来	需要什么
Amazon Web Services	账单 API	Access Key ID + Secret — AWS
阿里云	账单 API，或账单导出文件	AccessKey ID + Secret — 阿里云
Cloudflare	账单 API	Account ID + API token — Cloudflare
DeepSeek	余额 API，或账单导出文件	API key — DeepSeek
火山引擎	账单导出文件	不需要
OpenAI	账单导出文件	不需要
Anthropic（Claude）	账单导出文件	不需要

点 Save。API 类数据源会立即拉取本月和上个月的账单，凭据填错的话，这次拉取就会报错。

4. 把账单拿进来

API 类数据源在保存时已经拉取了账单。超过刷新间隔后，总览页上的 Refresh 会再拉一次。
文件类数据源——火山引擎、OpenAI、Anthropic，以及想看更细明细时的阿里云和 DeepSeek——需要导出文件：从云平台控制台下载，然后在账号那一行点 Import。见导入账单文件。

5. 读账单

Overview（总览）显示你选择的时间窗口：MTD（本月至今）、30d 或 12m。在 Settings → Reporting 里选择 USD 或 CNY。接下来：

总览与账号解释这些数字。
告警、规则与预算在花费突增时提醒你。
状态栏与后台运行让这一切在关掉窗口后继续运行。

有东西没显示出来？见常见问题排查。

快速上手 ​

1. 安装 ​

2. 想先看看也可以 ​

3. 添加账号 ​

4. 把账单拿进来 ​

5. 读账单 ​