OpenAI와 Anthropic API 비용을 관리하는 오픈소스 CLI 도구

실용적 조언

API 비용 관리를 위해 매번 웹 사이트에 로그인하는 대신 이 CLI를 크론탭에 등록하여 매일 아침 Slack으로 보고서를 받도록 설정하라
CI 파이프라인에 이 도구를 넣어 테스트 실행 시 발생하는 예상 비용을 체크하는 용도로 활용 가능하다

섹션별 상세

작성자는 별도의 대시보드 구축 없이도 당월 API 지출액을 즉시 확인할 수 있는 경량 도구를 개발했다. 이 도구는 OpenAI와 Anthropic의 API를 통해 현재 사용량을 가져오고 공급자별 또는 항목별 상세 내역을 출력한다. 런타임 의존성을 제거하여 자동화 환경에서 가볍게 동작하도록 설계했다.

비용 관리의 효율성을 높이기 위해 단순 조회 이상의 예측 및 알림 기능을 포함했다. 현재 사용 추세를 기반으로 월말 최종 비용을 예측하는 기능을 제공하며, JSON 출력을 지원하여 CI/CD 파이프라인이나 크론 작업에 연동 가능하다. Slack이나 Discord 웹훅을 통해 설정된 임계치에 따른 실시간 경고를 보낼 수 있다.

개발자는 가독성 높은 TypeScript 라이브러리 형태와 CLI 형태를 동시에 제공하여 확장성을 확보했다. 단순한 스크립트 수준을 넘어 다른 프로젝트에서 패키지로 불러와 사용할 수 있는 구조를 갖췄다. 현재는 주요 두 공급자만 지원하지만 향후 커뮤니티 피드백에 따라 지원 대상을 확대할 계획이다.

용어 해설

명령줄 인터페이스(CLI): — 터미널이나 콘솔 창에서 텍스트 명령어를 입력하여 소프트웨어를 실행하고 제어하는 방식이다. 그래픽 인터페이스(GUI) 없이도 자동화 스크립트나 서버 환경에서 가볍고 빠르게 동작하며 개발자 도구의 표준으로 활용된다.
웹훅(Webhook): — 특정 이벤트가 발생했을 때 서버가 지정된 URL로 실시간 알림을 보내는 메커니즘이다. 이 도구에서는 API 사용량이 특정 수준에 도달하거나 정기 보고 시 Slack이나 Discord로 데이터를 즉시 전송하는 데 사용된다.
크론(Cron): — 유닉스 계열 운영체제에서 특정 시간에 특정 작업을 자동으로 실행하기 위한 시간 기반 잡 스케줄러이다. API 비용 모니터링 도구를 주기적으로 실행하여 사용량을 체크하고 보고서를 생성하는 자동화 워크플로의 핵심 요소이다.

언급된 도구

capped-cost추천링크

OpenAI 및 Anthropic API 비용 모니터링 및 예측 CLI

언급된 리소스

GitHubcapped-cost GitHub Repository