为你的 AI 代理提供分类账
将一项任务变成你可以检查的账目。为你的支持 shell 的代理提供 bea CLI，以记录交易、检查其工作，并返回由纯文本支持的余额。
安装 bea
选择你的安装程序，然后检查版本。本地账目不需要 Beancount.io 账户。
uv · Python 3.12+
uv tool install beancount-ioHomebrew · macOS 或 Linux
brew install bex-co/tap/bea
2026-08-02 * "Coffee"
Expenses:Dining 12.50 USD
Assets:Checking -12.50 USD纯文本，属于你。
本地 .bean 文件，你可以用 Git 阅读、比较和版本控制。
每次更改前的检查。
默认 CLI 添加必须在替换账目前进行验证。
带上你使用的代理。
一个支持 shell 的代理、一个任务，以及你可以检查的命令。
你需要什么
一个终端、网络连接，以及要么 Homebrew 要么 uv（配合 Python 3.12 或更新版本）。本地簿记无需 Beancount.io 账户——仅在可选的托管步骤中才需要账户。
bea --version示例使用 bea 0.1.0 验证：Python 发行版为 beancount-io，安装的可执行文件为 bea。
一个小任务，一套真实的账目。
从 1,000 USD 开始。记录一笔 12.50 USD 的咖啡支出。让代理检查账目并显示其答案背后的查询。
代理任务提示
你具有 shell 访问权限且已安装 `bea` CLI。首先，运行 `bea --help` 并阅读其功能。然后，在一个新的空演示目录中（不要触碰任何现有分类账）：1) 创建一个 USD 分类账，在 2026-08-01 开设 Assets:Checking 为 1000；2) 在 2026-08-02 添加一笔 12.50 USD 的购买，记为 "Coffee"（Expenses:Dining）；3) 运行 `bea check`；4) 报告 Assets:Checking 的余额，连同你使用的确切 BQL 查询。预期结果：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"在工具之间犹豫不决？Beancount.io 是五款在同一智能体工作流标准下进行比较的工具之一，资料来源有日期标注。
阅读五款工具的比较开始前的一些事情。
你的账本留在你的机器上
以下每条命令都在你选择的目录中处理纯文本 .bean 文件。新分类账文件对你的用户是私有的，并且每次添加都会在文件被替换前针对完整分类账进行验证——在默认的本地 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 依赖 extra 以及登录使用的托管凭据。默认的 bea 安装有意省略 AI 依赖项，直到你明确要求。
按需连接托管工具
本地 CLI 命令无需 Beancount.io 账户即可工作。托管的 AI 帮助和 MCP 访问是单独的可选连接。
bea ask 通过托管 AI 服务回答有关本地分类账的问题。它需要 ask extra——uv tool install 'beancount-io[ask]'——以及你的 Beancount.io 凭据。
MCP 服务器和托管分类账同样使用你的 Beancount.io 账户登录以授权访问。从本地开始；仅在你需要时才连接托管。
Beancount 的代理技能位于产品仓库中，并单独加载到你的代理中——安装 CLI 不会安装或配置它们。
探索 MCP 连接