전체 실행 런북

// CLI·AI 연동 — 재무 업무 자동화

일일 거래 요약 + 분개 후보 제안

전일 다은행 입출금을 룰북 + AI 로 분개 후보까지 붙여 팀 재무 슬랙에 매일 아침 한 줄.

CLIClaude Code매일

이런 분께 · 재무팀. 룰북 CSV · 환경변수만 본인 환경에 맞게 바꾸면 사용할 수 있습니다.

team-finance
h

어제 입출금 요약 · 4개 은행 27건 입금 +5,420,000 / 출금 -2,140,000 분개 후보 22건 (확정 18 · 검토 4)

01사전 점검

아래 명령을 붙여 넣어 현재 환경이 준비됐는지 확인합니다.

  • CLI가 설치돼 있다

    h6s --version

    버전 문자열이 출력됩니다

    대안으로 npm i -g @h6s-ai/cli

  • 로그인(또는 API Key)이 돼 있다

    h6s whoami

    워크스페이스와 사용량이 출력된다

    대안으로 h6s init # 또는 export H6S_API_KEY=h6s_live_...

  • 워크스페이스에 대상 자격증명이 있다

    h6s credentials list

    공동인증서 또는 대상 기관 자격증명이 1건 이상 보인다

    대안으로 h6s credentials create --interactive --cert

  • Slack 전송 (선택, 없으면 stdout 출력)

    echo $SLACK_WEBHOOK_URL

    webhook URL 이 출력된다

    대안으로 export SLACK_WEBHOOK_URL=https://hooks.slack.com/...

02실행

이 한 줄로 끝. 수집 → 룰북·대사 → 외부 전송까지 internal-finance skill 이 오케스트레이션한다.

프롬프트

어제 입출금내역을 등록된 은행 모두에서 받아 분개 후보까지 붙여서 팀 재무 슬랙에 요약 보내줘.

내부적으로 도는 수집 명령: h6s fetch bank.transactions.cb.v1 --provider CB_KB --from 2026-05-15 --to 2026-05-15 --output csv (skill 이 등록된 은행마다 반복)

03검증

  • 팀 재무 슬랙(또는 stdout)에 은행수·건수·입출금 합·분개 후보 한 줄 요약이 온다.
  • 분개 후보가 conventions.md 룰북 기준으로 확정/검토로 나뉜다.

04흔한 에러

CREDENTIAL_INSUFFICIENT_FOR_PROVIDER

그 provider 에 매칭되는 자격증명이 워크스페이스에 없습니다.

해결 h6s credentials create --interactive --cert (공동인증서 1개로 전 기관 공용).

CERT_EXPIRED · CERT_WRONG_PASSWORD

등록된 공동인증서가 만료됐거나 비밀번호가 틀렸다.

해결 h6s credentials update 로 갱신 후 재실행.

NO_API_KEY

API Key 가 설정되어 있지 않습니다.

해결 h6s init 또는 export H6S_API_KEY=h6s_live_...

Slack 전송 skip (SLACK_WEBHOOK_URL 미설정) 한 줄

webhook 미설정은 정상 동작입니다. stdout 으로 같은 요약을 출력합니다.

해결 채널 전송이 필요하면 SLACK_WEBHOOK_URL 등록.

05변형

같은 사례에서 자주 바꾸는 옵션. 다른 사례는 아래 이전/다음에서.

거래처 DB로 적요 보강

terminal
export INTERNAL_VENDOR_LIST_PATH=./vendors.csv   # 있으면 적요·거래처 매칭에 사용

특정 은행만

terminal
어제 국민은행 입출금만 요약해줘
다음1인 사장님 분기 부가세 신고 자료