CLI라는 단어를 처음 들으면 "개발자 얘기겠지"라고 넘기기 쉽습니다.
맞습니다. CLI(Command Line Interface)는 원래 터미널에 명령어를 직접 입력하는 개발자들의 도구입니다. 그런데 볼타 CLI는 조금 다르게 설계됐습니다. 명령어를 직접 다룰 필요가 없습니다. AI가 대신하기 때문입니다.
결과적으로 재무팀 담당자도, 혼자 사업을 운영하는 대표도 쓸 수 있는 도구가 됐습니다. 이 글은 그 이야기입니다.
전자세금계산서 자동발행이 어려웠던 이유
전자세금계산서를 자동으로 발행하고 싶다는 니즈는 오래됐습니다.
매달 같은 거래처에 같은 금액을 발행해야 하는데, 매번 홈택스에 들어가서 처음부터 입력하는 과정이 반복됩니다.
자동화 방법이 없었던 건 아닙니다. API 연동을 하면 됩니다.
하지만 API 연동은 개발자가 필요하고, 개발자가 없는 팀에서는 선택지가 아니었습니다.
그러다 보니 현실에서는 이런 방식이 계속됩니다.
홈택스 로그인 → 공동인증서 인증 → 공급자 정보 입력 → 공급받는자 정보 입력 → 금액·품목 입력 → 발행 → 확인
거래처가 20곳이면 이 과정을 20번 반복
매달 같은 작업을 다시 처음부터
거래처 하나당 몇 분씩, 20곳이면 한 시간입니다.
아무도 이 시간을 아깝지 않다고 생각하지 않지만, 딱히 줄일 방법도 없었습니다.
CLI가 바꾸는 것, 그리고 AI가 추가하는 것
볼타 CLI는 전자세금계산서 발행을 명령어로 처리할 수 있게 만든 도구입니다.
예를 들어 이런 명령어 하나로 세금계산서를 발행할 수 있습니다.
bolta invoice issue \
--recipient-name "주식회사 베타" \
--item "SaaS 이용료" \
--amount 2000000 \
--tax 200000 \
--issue-date 2026-04-30이 방식의 장점은 반복 자동화가 가능하다는 점입니다.
스크립트로 묶으면 수십 건을 한 번에 처리할 수 있고, 타이머와 연결하면 날짜가 되면 알아서 발행됩니다.
개발자 입장에서는 강력한 도구입니다.
그런데 여기서 AI가 더해지면 얘기가 달라집니다.
저 명령어를 직접 입력할 필요가 없어집니다. 대신 이렇게 말하면 됩니다.
"주식회사 베타에 4월분 세금계산서 발행해줘. 품목 'SaaS 이용료', 공급가액 200만 원."
AI가 이 요청을 이해하고, 뒤에서 CLI 명령을 만들어 실행합니다. 사용자 입장에서는 대화하듯 요청하면 전자세금계산서가 자동발행되는 구조입니다.
코드를 모르는 사람도, 터미널을 한 번도 열어본 적 없는 사람도 쓸 수 있습니다.
실제로 어떻게 세팅하나요?
처음 한 번만 설정해두면 됩니다. 이후에는 신경 쓸 일이 없습니다.
아래 항목이 헷갈리신다면 AI 에이전트에 문서를 전달 후 ‘학습해서 연결해줘’ 라고 명령어를 추가하면 가능합니다.
1단계: 볼타 CLI 설치
터미널(맥은 터미널 앱, 윈도우는 명령 프롬프트)을 열고 아래 중 하나를 실행합니다.
# npm 사용 시
npm install -g @bolta-io/cli
# macOS Homebrew 사용 시
brew install bolta-io/tap/bolta
# curl 사용 시 (macOS/Linux)
curl -fsSL https://bolta.io/install.sh | sh터미널이 처음이라면 npm 방식을 추천합니다.
Node.js가 설치되어 있지 않다면 nodejs.org에서 먼저 설치하면 됩니다.
2단계: API 키 발급
볼타 계정에서 API 키를 발급받습니다.
bolta.io 회원가입
설정 → 개발자센터 이동
API 키 생성 → 테스트 키 발급
이 키는 CLI와 AI가 볼타 시스템에 접근할 때 사용하는 인증 수단입니다.
3단계: 인증 연결
발급받은 키를 CLI에 등록합니다. 한 번만 하면 됩니다.
bolta configure --api-key YOUR_API_KEY --customer-key YOUR_CUSTOMER_KEY여기까지 하면 준비가 끝납니다. 이제 AI 에이전트에서 바로 요청할 수 있습니다.
비개발자가 실제로 쓰는 방법
볼타 CLI는 Claude, ChatGPT 같은 AI 도구와 바로 연결됩니다.CLAUDE.md, llms.txt 같은 AI 가이드 문서가 내장되어 있어서, AI가 볼타 CLI를 어떻게 써야 하는지 이미 알고 있습니다.
별도로 설정하거나 가르칠 필요가 없습니다.
연결 후에는 이렇게 요청하면 됩니다.
세금계산서 발행:
"주식회사 알파에 3월분 세금계산서 발행해줘. 품목은 '클라우드 인프라 운영', 공급가액 500만 원."
홈택스를 열 필요도, 거래처마다 정보를 다시 입력할 필요도 없습니다.
한 번 발행한 거래처는 정보가 저장되기 때문에 요청이 점점 짧아집니다.
어떤 상황에서 효과가 클까요?
거래처가 많을 때 — 매달 수십 곳에 전자세금계산서를 발행하는 경우, 건별로 홈택스에서 처리하던 시간이 크게 줄어듭니다.
매달 같은 패턴이 반복될 때 — 정기 거래처에 비슷한 금액을 반복 발행하는 경우가 많습니다. 거래처 정보가 저장되어 있어서 "지난달이랑 동일하게"만으로 처리가 가능한 구조입니다.
혼자서 발행부터 관리까지 다 할 때 — 1인 기업이나 소규모 팀에서 대표가 직접 세금계산서를 처리하는 경우, 반복 업무에 들어가는 시간을 줄이고 더 중요한 일에 집중할 수 있게 됩니다.
수정발급이 잦을 때 — 금액 정정, 거래처 변경 같은 수정발급도 같은 흐름에서 바로 처리됩니다. 홈택스를 다시 열고 처음부터 입력하지 않아도 됩니다.
빨라지는 게 아니라, 방식이 바뀝니다
전자세금계산서 자동발행을 단순히 "입력 시간을 줄이는 것"으로 보면 절반만 본 겁니다.
실제로 달라지는 건 세금계산서 업무를 다루는 방식 자체입니다. 기존에는 발행할 때마다 직접 화면을 열고 정보를 입력하고 승인 상태를 따로 확인해야 했습니다. 건수가 늘수록 확인해야 할 것도 함께 늘었습니다.
볼타 CLI와 AI를 연결하면 이 구조가 달라집니다. 발행, 조회, 수정이 하나의 대화 흐름 안에서 이어집니다. 매달 반복되던 작업이 "알아서 돌아가는 프로세스"로 바뀝니다.
개발자가 AI로 생산성을 끌어올리는 방식이 이제 재무팀에도 열리고 있습니다. 코드를 몰라도, 터미널을 한 번도 열어본 적 없어도 괜찮습니다. AI가 그 사이를 채워줍니다.
볼타 CLI는 그 첫 번째 진입점입니다.
볼타 CLI 시작하기
볼타 CLI, 설치부터 첫 발행까지 5분이면 됩니다.
npm install -g @bolta-io/cli
bolta configure --api-key YOUR_API_KEY --customer-key YOUR_CUSTOMER_KEY설정이 끝나면 AI 에이전트에서 바로 요청하면 됩니다.
자세한 사용법은 볼타 CLI 문서에서, 전체 서비스는 볼타에서 확인할 수 있습니다.
전자세금계산서를 아직 "매달 해치워야 하는 작업"으로 처리하고 있다면, 지금이 방식을 바꿔볼 타이밍입니다.