> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archetype.ing/llms.txt
> Use this file to discover all available pages before exploring further.

# 가계부

> 내 가계부. 쓰고 받은 돈, 예산, 정기 결제, 월간 리포트, 그리고 내가 승인할 때만 기록하는 에이전트.

가계부는 쓰고 받은 돈, 분류마다의 월 예산, 계좌 잔액, 내역에서 찾은 정기 결제와 고정비, 매달 1일의 지난달 리포트를 둡니다. 금액은 원 단위입니다. 기본으로 켜져 있고 사이드바에 **가계부**로 나옵니다. 플러그인을 켜고 끄는 방법은 [플러그인](https://docs.archetype.ing/ko/extend/plugins.md)을 보세요.

가계부는 이 컴퓨터에만 있습니다. 은행이나 카드사에 직접 연결하지 않습니다.

## 기록을 넣는 길

| 방법 | 어디서 |
| - | - |
| 직접 입력 | 화면의 추가 칸. "50만", "3만5천"처럼 적어도 됩니다 |
| 카드 문자 | **문자 붙여넣기**: 신한, 삼성, 현대, KB국민, 롯데, 하나, 우리, NH농협, BC, 카카오뱅크, 토스뱅크의 승인·취소 문자 |
| 카드사·은행 파일 | **파일 가져오기**: 내려받은 CSV, `.xlsx`, `.xls`. 한국어 머리글도 됩니다 |
| 이미 가진 파일 | **가져올 내역 찾기**가 다운로드 폴더(또는 정한 폴더)를 보고, 파일마다 새 기록을 보여 줍니다. **N건 가져오기**로 하나씩 가져옵니다 |
| 동기화 폴더 | CODEF 동기화 파일과, 휴대폰 자동화가 쓰는 카드 문자 `.txt`. 폴더가 바뀔 때마다 읽습니다 |

같은 파일이나 문자를 다시 읽어도 늘어나지 않습니다. 취소 문자는 그 승인 기록을 취소로 표시합니다. 카드 결제인지 분명하지 않은 문자는 이유와 함께 빼고, 짐작하지 않습니다. 카드 하나에는 한 가지 길만 쓰세요. 같은 카드의 문자와 파일을 서로 맞춰 보지 않으므로, 둘 다 넣으면 결제가 두 번 잡힙니다.

## 화면

* 분류는 나에게서 배웁니다. 한 가맹점의 기록 하나에 분류를 주면 그 가맹점의 기록은 그 뒤로 같은 분류가 됩니다.
* 분류마다 한 달 **예산**을 정합니다.
* **정기 결제**: 매주, 매월, 매년 비슷한 금액이 나가는 가맹점. 하나씩 확인하거나, 이름을 바꾸거나, 정기 결제가 아니라고 합니다. 아니라고 한 곳은 따로 모아 두어 되살릴 수 있습니다.
* **지난달**: 쓴 돈과 받은 돈, 분류마다 예산 대비, 많이 쓴 가맹점, 새로 찾은 정기 결제, 가장 크게 달라진 분류.
* **\{company}에 청구**: 보낼 것 플러그인을 켜고 회사에 로그인해 있으면, 지출 하나를 [보낼 것](https://docs.archetype.ing/ko/plugins/drafts.md)의 경비 청구 초안으로 만듭니다. 가계부에서는 아무것도 보내지 않습니다.

## 에이전트가 하는 일

| 읽기 | 바꾸기 (매번 물음) |
| - | - |
| `money_summary`, `list_money`, `money_report` | `add_money`, `update_money`, `remove_money` |
| `money_rules`, `money_recurring` | `set_money_budget`, `set_money_rule` |
| `find_money_sources` | `import_money`, `record_money_messages` |
| | `draft_money_claim` |

바꾸는 도구는 매번 한 줄로 먼저 묻습니다. 가져오기는 새 기록이 몇 건이고 며칠에 걸치는지, 카드 문자는 문자마다 무엇을 하는지 보여 줍니다. 물을 수 없는 곳에서는 읽는 도구만 주어지고, `yolo`를 포함해 어떤 권한 모드도 묻지 않고 바꾸지 않습니다. [승인](https://docs.archetype.ing/ko/use/approvals.md)을 보세요.

## 알림과 이벤트

| 알림 | 언제 |
| - | - |
| **다가오는 정기 결제** | 확인한 정기 결제가 며칠 뒤 나갈 때. 결제마다 한 번 |
| **월간 리포트** | 매달 1일, 지난달 돌아보기. 기록이 없는 달은 보내지 않습니다 |

[트리거](https://docs.archetype.ing/ko/use/automations.md)가 깨어날 수 있는 이벤트: **`money.recorded`**(직접, 에이전트, 파일, 동기화 폴더로 새 기록이 생겼을 때. 메모는 담지 않음)와 **`money.recurring`**(확인한 정기 결제가 곧 나갈 때).

## 설정

**관리 → 플러그인 → 가계부**에서:

| 설정 | 기본값 | 하는 일 |
| - | - | - |
| **동기화 폴더** | 비어 있음 | 읽을 CODEF 파일과 카드 문자 `.txt`가 있는 폴더 |
| **정기 결제 며칠 전에 알릴지** | 2 | 0\~14일. 0이면 알리지 않습니다 |
| **가져올 내역을 찾을 폴더** | 다운로드 | **가져올 내역 찾기**가 볼 홈 폴더 안의 폴더 |
| **회사 카드** | 비어 있음 | 회사 것인 카드. 이 카드로 만든 청구는 회사가 낸 것으로 합니다 |

파일에서 연도가 뒤에 오는 날짜(`11/12/2026`)는 **관리 → 날짜**에서 정한 순서로 읽습니다. 정하기 전에는 그런 줄을 건너뛰고 몇 줄인지 알려 줍니다.

## 제공하는 프로필

**가계부 담당**(먼저 물음): 기록이 들어오면 가계부에 이미 있는 분류 중 알맞은 곳에 넣고, 가맹점 이름이 이상하면 고칩니다. 큰 금액, 처음 보는 가맹점, 중복, 거의 다 쓴 예산처럼 평소와 다른 것만 알려 줍니다. 기록을 지우지 않습니다. `money.recorded`에 깨어납니다. **관리 → 프로필 → 새 프로필**에서 시작합니다.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.