1. 从零搭一个 Beancount 记账 Web 应用为什么值得用 Claude Code 来做Beancount 是一个纯文本复式记账工具账本就是一个.bean文件每一笔收支都写成一行行结构化文本。它的好处是数据完全归你、可版本管理、可脚本化但痛点也很明显——官方只提供命令行想看个「本月餐饮花了多少」「资产趋势图」得自己写查询、自己搭前端。对不写代码的人来说这一步基本就卡死了。我这次想验证的事情很具体能不能让 Claude Code 把「解析 Beancount 账本 起一个 Web 页面展示」这条链路全部写完我只负责描述需求和点确认。答案是能但前提是把模型通道配置对——Claude Code 默认走 Anthropic 官方接口国内直连经常超时所以我用 TaoToken 的统一 Key 和 Base URL 把它接上后面所有代码生成、文件读写、命令执行都由 Claude Code 在终端里完成。这篇适合三类人一是用 Beancount 记账但不会写前端的二是想体验 Claude Code 但卡在接入配置的三是想找一个「零代码也能跑通」的 AI 编程实战案例的。全程你只需要复制配置、粘贴提示词、按回车。下面从环境准备讲到页面跑起来每一步都给可复制的命令和配置。2. 前置准备TaoToken 统一 Key 接入 Claude Code 的完整配置Claude Code 是一个跑在终端里的编程 Agent它能读你项目里的文件、执行 shell 命令、改代码。它本身是个客户端需要背后有一个模型服务。默认它连 Anthropic 官方我们要做的是把请求指向 TaoToken 的 API 通道用统一 Key 鉴权。先拿到 Key。打开 TaoToken 控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentclaude_code_beancount在 API Keys 页面创建一个新 Key复制出来形如sk-xxxxxxxx。这个 Key 后面既用于 Claude Code也能用于其他兼容 Anthropic 协议的工具所以叫「统一 Key」。接着配置环境变量。Claude Code 读取的是ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN这两个变量。Base URL 填 TaoToken 的 API 地址https://taotoken.net/api注意这里不加任何查询参数。macOS / Linux 在~/.zshrc或~/.bashrc里追加export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKENsk-你的KeyWindows PowerShell 用户在当前会话里执行$env:ANTHROPIC_BASE_URLhttps://taotoken.net/api $env:ANTHROPIC_AUTH_TOKENsk-你的Key想永久生效就写进系统环境变量或者用setx。改完记得source ~/.zshrc或重开终端。如果你用的是 Claude Code 的配置文件方式部分版本支持~/.claude/settings.json可以写成 JSON{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的Key } }这里有个容易踩的点Base URL 结尾不要带/v1也不要带斜杠Claude Code 会自己拼接路径。填错会直接 404 或 401。配置完先别急着建项目用一条最小请求验证通道是否通——这一步放在第 4 节先把项目骨架搭起来。3. 可复制配置项目初始化与 Beancount 解析代码生成环境变量配好后新建一个空目录当项目根mkdir beancount-web cd beancount-web然后在这个目录里启动 Claude Codeclaude第一次启动它会问你是否信任当前目录选 yes。进去之后就是一个对话界面你输入自然语言它来干活。下面是我实际用的提示词你可以直接抄帮我用 Python 搭一个 Beancount 记账 Web 应用。要求1用 Flask 做后端2读取当前目录下的main.bean账本文件用 beancount 库解析3提供一个首页展示账户余额列表和最近 20 笔交易4提供一个/add接口能往账本追加一笔交易5所有依赖写进 requirements.txt。请直接创建文件。Claude Code 会依次创建app.py、templates/index.html、requirements.txt并在终端里告诉你它做了什么。核心解析逻辑大致长这样你可以对照检查它有没有写对from flask import Flask, render_template, request, redirect from beancount import loader from beancount.core import data, realization import datetime app Flask(__name__) BEAN_FILE main.bean def load_ledger(): entries, errors, options loader.load_file(BEAN_FILE) return entries, errors app.route(/) def index(): entries, errors load_ledger() # 按账户聚合余额 balances {} for entry in entries: if isinstance(entry, data.Transaction): for posting in entry.postings: amt posting.units if amt is None: continue balances.setdefault(posting.account, 0) balances[posting.account] float(amt.number) recent [e for e in entries if isinstance(e, data.Transaction)][-20:] return render_template(index.html, balancesbalances, recentrecent, errorserrors)注意beancount库的 API 在不同版本间有差异2.x 和 3.x 的loader.load_file返回值结构基本一致但postings里units可能是None比如自动平衡的行所以上面加了判空。Claude Code 一般会处理这些边界但你最好扫一眼。依赖文件flask beancount装依赖pip install -r requirements.txt再准备一个最小账本main.bean让页面有数据可展示2024-01-01 open Assets:Cash CNY 2024-01-01 open Expenses:Food CNY 2024-01-01 open Income:Salary CNY 2024-01-05 * 午餐 公司楼下 Expenses:Food 35.00 CNY Assets:Cash -35.00 CNY 2024-01-10 * 工资 Assets:Cash 12000.00 CNY Income:Salary -12000.00 CNY到这里项目骨架就有了。如果 Claude Code 生成的代码有语法问题直接在对话里说「app.py 第 30 行报错帮我修」它会读文件、改、再让你跑。4. 验证请求跑起服务并写入一笔真实记账数据先验证模型通道。在 Claude Code 里输入一句「你好确认一下连接正常」如果它能正常回复说明 Base URL 和 Key 都生效了。如果报 401回到第 2 节检查 Key 有没有复制全、有没有多余空格。接着启动 Flaskpython app.py终端会打印Running on http://127.0.0.1:5000。浏览器打开这个地址你应该能看到账户余额和最近交易列表。如果页面空白或报 500看终端 traceback把错误贴回 Claude Code 让它修。现在做一次真实的写入验证。我让 Claude Code 加一个表单提交或者你直接用 curl 测/add接口curl -X POST http://127.0.0.1:5000/add \ -d date2024-01-15 \ -d payee超市 \ -d amount88.50 \ -d accountExpenses:Food接口内部会把这笔交易格式化成 Beancount 语法追加到main.beanapp.route(/add, methods[POST]) def add(): d request.form[date] payee request.form[payee] amount request.form[amount] account request.form[account] line f\n{d} * {payee}\n {account} {amount} CNY\n Assets:Cash -{amount} CNY\n with open(BEAN_FILE, a, encodingutf-8) as f: f.write(line) return redirect(/)提交后刷新首页余额应该变了最近交易里也多了一条「超市」。这一步跑通说明「解析—展示—写入」整条链路是活的。你可以再让 Claude Code 加个饼图用 Chart.js 在模板里画它一样能写。5. 本篇常见报错排查401、local proxy failed 与 reading choices接入 Claude Code 时最常见的几个报错我按实际遇到的整理一下。401 UnauthorizedKey 错了或没生效。检查ANTHROPIC_AUTH_TOKEN是否和 TaoToken 控制台里的一致有没有把sk-前缀漏掉。改完环境变量要重开终端export只在当前会话有效。local proxy failed / connection refusedBase URL 填错或者本地网络到taotoken.net不通。确认填的是https://taotoken.net/api不带/v1、不带尾斜杠。如果公司网络有出口限制换网络再试。Error reading choices / unexpected response通常是模型名不匹配或返回体解析失败。Claude Code 默认会带一个模型 ID如果你在配置里手动指定了模型确认它和 TaoToken 支持的模型列表一致。不确定就别指定用默认。OAuth / login requiredClaude Code 有时会尝试走官方登录流程。确保ANTHROPIC_AUTH_TOKEN已设置它会优先用这个而不是 OAuth。Beancount 解析报错main.bean里缩进必须用空格不能用 Tab金额和账户之间至少两个空格。报错信息里会带行号照着改。排查顺序建议先确认通道发一句普通对话再确认项目代码跑python app.py看 traceback最后确认账本语法。三层分开定位比一上来就改代码快得多。6. 把这条链路用起来从记账 Demo 到长期可维护的小工具跑通之后这个项目其实可以继续长。你可以让 Claude Code 加账户筛选、按月统计、导出 CSV甚至接一个定时任务每天自动备份main.bean。因为账本是纯文本配合 git 做版本管理每次改动都有记录比很多记账 App 的数据更可控。如果你打算长期用 Claude Code 写这类小工具可以考虑 TaoToken 的 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentclaude_code_beancount统一 Key 在多工具间复用省得每个客户端配一遍。想先单独验证模型效果用模型对话页https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentclaude_code_beancount发几条请求看看返回质量。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentclaude_code_beancountAPI Keys 管理在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentclaude_code_beancount。最后留一个我踩过的坑Claude Code 生成代码时偶尔会「自作主张」改你的main.bean格式尤其是缩进。每次让它改完用beancount main.bean命令行校验一遍确认账本没被写坏再提交。这个习惯能帮你省掉很多对账时的困惑。