メインコンテンツへスキップ
Beancount.io Logo
Beancount CLI クイックスタート

Beancount CLI クイックスタート

bea コマンドをインストールし、ローカルの Beancount 台帳を作成し、最初の購入を記録して残高を確認します。

bea（Beancount.io のコマンドラインツール）を使ってローカル台帳を作成し、最初の購入を記録します。ローカルでの記帳には Beancount.io アカウントは不要です。

このチュートリアルでは、当座預金に 1,000 USD から始めます。12.50 USD のコーヒー購入後、残高が 987.50 USD になることを確認します。

1. コマンドのインストール​

macOS または Linux で Homebrew を使用する場合：

brew install bex-co/tap/bea
bea --version

Homebrew を使用しない場合は、uv をインストールして uv tool install beancount-io を使用します。Python パッケージには Python 3.12 以降が必要です。

2. 台帳の作成​

新しいディレクトリを選択します。この例では、~/my-books 内に main.bean を作成します：

bea --no-input init ~/my-books --currency USD --date 2026-08-01 \
  --opening-balance "Assets:Checking 1000"
cd ~/my-books

テンプレートには、一般的な当座預金、普通預金、現金、クレジットカード、収入、支出の勘定科目が含まれています。期首残高は Equity:OpeningBalances に対して相殺されます。

自分の帳簿では、記録を開始する予定の最も早い日付を選択してください。すべてのテンプレート勘定科目はその日付で開始されます。期首残高は、その日の勘定科目の状態を記述する必要があります。クレジットカードの負債は負の金額を使用します。

init は既存の台帳を上書きすることはありません。新しいファイルは POSIX システム上でプライベートです。所有者のみが読み書きできます。ローカルのユーザーグループと共有するには、chmod 640 main.bean で明示的に権限を変更します。

代わりにガイド付きセットアップを実行するには、ターミナルで bea init ~/my-books を実行します。ウィザードが通貨、履歴開始日、当座預金残高を尋ねます。

3. 購入の記録​

bea add transaction --date 2026-08-02 --narration "Coffee" \
  --posting "Expenses:Dining 12.50" \
  --posting "Assets:Checking"

支出は勘定科目の USD 通貨を使用します。Beancount はもう一方の posting を -12.50 USD として自動的に入力します。今日の購入では --date を省略できます。

各追加は、ファイルが置き換えられる前に完全な台帳と照合されます。未知の勘定科目や不均衡な取引があると、ガイダンス付きのエラーが発生します。

4. 結果の確認​

bea check
bea list transaction --limit 10
bea report balance-sheet

取引リストは、最新のエントリを posting 金額とともに先頭に表示します。貸借対照表には当座預金の 987.50 USD が表示されます。

その金額を直接確認するには：

bea query "SELECT account, sum(position) WHERE account = 'Assets:Checking' GROUP BY account"

クエリテーブルは結果の精度を保持します。構造化出力の場合は、コマンドの前にグローバルな --json フラグを置きます：

bea --json list transaction --limit 10

5. 帳簿を良い状態に保つ​

ファイルを手動で編集した後は bea check を実行します。列を揃えるには bea format main.bean を実行します。スクリプトがフォーマットが必要な場合に失敗するようにするには、bea format main.bean --check を使用します。

別のディレクトリから作業するには、ルートファイルを明示的に選択します：

bea --file ~/my-books/main.bean check

ルートは --file、次に BEA_FILE、次に作業ディレクトリ内の main.bean の順で選択されます。グローバルオプションはコマンドの前に置きます。フォーマットは独自のファイルまたはディレクトリアーギュメントを取ります。

独自の記録を続ける​

bea upgrade --check で更新を確認します。bea upgrade を実行して、インストールされたコピーを管理するパッケージマネージャーを呼び出します。bea --help または bea add transaction --help を使用して、インストールされているバージョンで利用可能なオプションを確認します。