본문으로 건너뛰기
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는 다른 포스팅을 -12.50 USD로 자동 채웁니다. 오늘 구매한 경우 --date를 생략할 수 있습니다.

각 추가는 파일이 대체되기 전에 전체 원장과 대조됩니다. 알 수 없는 계정이나 불균형 거래는 안내와 함께 오류를 생성합니다.

4. 결과 확인​

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

거래 목록은 최신 항목을 먼저 표시하며, 포스팅 금액을 포함합니다. 대차대조표는 당좌예금에 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를 사용하여 설치된 버전에서 사용 가능한 옵션을 확인하세요.