전체 활용 사례

// 업종별 — 그대로 따라가는 시나리오

1인 사장님 — 종합소득세 월별 누적

매월 1일 Claude Code 가 전월 거래·세금계산서·현금영수증을 종소세 신고서 항목 기준 markdown 한 장으로 누적 정리.

CLIClaude Code매월 1일

이런 분께 5월 종소세 신고를 직접 하는 프리랜서·1인 사업자.

income-tax-2026-04.zip

약 18 KB·월 1회 갱신

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

02실행

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

프롬프트

지난달 매출/매입/카드/현금 거래를 종소세 신고서 항목 기준으로 정리해서 income-tax-<YYYY-MM>.md 에 누적해줘.

내부적으로 도는 수집 명령: h6s fetch bank.transactions.cb.v1 --provider CB_KB --month 2026-04 + hometax.tax-invoices.sales.v1 / .purchase.v1 / cash-receipts.* --provider HOMETAX

03검증

  • income-tax-<YYYY-MM>.md 한 장에 종소세 신고서 항목별 합계가 누적된다.
  • 달이 바뀌면 같은 파일에 덧붙는다(월 1회 갱신).

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_...

05변형

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

특정 달만 다시

terminal
2026-03 거래로 종소세 정리 다시 해줘

매월 1일 자동화

terminal
github-action 의 cron 예시(월 1회)로 같은 프롬프트를 무인 실행
다음이커머스 셀러 — PG ↔ 은행 정산 대사