面向技术创始人、开发者和智能体构建者
给你的 AI 智能体一个账本
安装 bea 命令行工具，然后把一项任务粘贴到你已经使用的、支持 shell 的 AI 智能体中。几分钟后，它就会交回一个经过验证的本地账本——无需 Beancount.io 账户。
安装 bea
两种正式方式可获得同一命令。选择适合你机器的方式，然后确认它用版本号回应。
使用 uv（任何装有 Python 3.12 或更新版本的环境）
uv tool install beancount-io使用 Homebrew（macOS 或 Linux）
brew install bex-co/tap/beabea --version示例已使用 bea 0.1.0 验证：Python 发行版为 beancount-io，其安装的可执行文件为 bea。
你需要什么
一个终端、网络连接，以及 Homebrew 或 uv（支持 Python 3.12 或更新版本）。本地记账无需 Beancount.io 账户——只有下面的可选托管步骤才需要。
你的账簿留在你的机器上
以下所有命令都在你选择的目录中的纯文本 .bean 文件上运行。新建的账本文件对你的用户是私有的，每次添加都会在替换文件前针对完整账本进行验证——在默认的本地 CLI 路径下，未知账户或收支不平衡的交易会报错并给出指导，且文件保持不变。
你的智能体的第一个任务
将此粘贴到你的智能体中。它以 1,000 USD 的支票账户开始，记录一笔 12.50 USD 的咖啡消费，验证账本，并报告余额及使用的查询。
智能体任务提示
You have shell access and the `bea` CLI installed. First run `bea --help` and read what it offers. Then, in a NEW empty demo directory (do not touch any existing ledger): 1) create a USD ledger opening Assets:Checking at 1000 on 2026-08-01; 2) add a 12.50 USD purchase narrated "Coffee" to Expenses:Dining on 2026-08-02; 3) run `bea check`; 4) report the Assets:Checking balance together with the exact BQL query you used. Expected result: 987.50 USD.相同步骤的纯命令形式
bea --no-input init demo-books --currency USD --date 2026-08-01 --opening-balance "Assets:Checking 1000"
cd demo-books
bea add transaction --date 2026-08-02 --narration "Coffee" --posting "Expenses:Dining 12.50" --posting "Assets:Checking"
bea check
bea query "SELECT account, sum(position) WHERE account = 'Assets:Checking' GROUP BY account"预期结果：Assets:Checking 持有 987.50 USD。
阅读 CLI 快速入门可选：托管 AI 帮助
以上操作都不需要账户，也不会将你的账本发送到任何地方。两个可选的附加功能需要账户，并且它们都与安装 CLI 无关。
bea ask 通过托管 AI 服务回答有关本地账本的问题。它需要 ask 附加组件——uv tool install 'beancount-io[ask]'——以及你的 Beancount.io 凭据。
MCP 服务器和托管账本同样使用你的 Beancount.io 账户登录以授权访问。从本地开始；仅在你需要时才连接托管服务。
Beancount 的智能体技能存放在产品仓库中，并单独加载到你的智能体中——安装 CLI 不会安装或配置它们。
智能体构建者常问的问题
我需要 Beancount.io 账户吗？
本页内容都不需要。安装 bea、创建本地账本、记录购买和检查余额都无需账户。只有可选的托管附加功能需要登录：bea ask、MCP 服务器和托管账本。
安装 CLI 会配置我的 AI 智能体吗？
不会。安装只是提供 bea 命令；你的智能体保持原样。你将上面的任务粘贴到已经使用的、支持 shell 的智能体中，而加载智能体技能是另一项独立步骤。
我的账本会离开我的机器吗？
本地命令在本地 .bean 文件上运行，且不进行网络调用。只有托管命令——bea cloud 和 bea ask，其模型调用通过托管 AI 代理运行——才会与 Beancount.io 服务通信。
如果我的智能体写了错误条目会怎样？
在默认的本地 CLI 路径下，每次添加都会在替换文件前针对完整账本进行检查。未知账户或收支不平衡的交易会失败并给出指导，并且你的文件保持不变——手动编辑后也让智能体运行 bea check。
bea ask 到底需要什么？
除了本页内容，还需要两样：ask 依赖附加组件和登录用的托管凭据。默认的 bea 安装有意省略 AI 依赖，直到你请求它们。
从咖啡开始，以账簿为继
一次安装，一次粘贴任务，一次验证的余额——然后继续阅读完整的快速入门。