연동 키트설치형 오픈소스TokenEconomizer
TokenEconomizer를 Claude Code에 연동
- 누가 · 어디에
- 동일 코드베이스에서 Claude Code 등 AI 코딩 에이전트를 지속적으로 사용하는 소프트웨어 개발팀
- 업무 효과
- 세션 간 반복되는 빌드/환경 탐색을 줄이고 안 쓰는 도구와 실패 루프를 차단해 토큰 비용을 최대 30.9% 절감
우리 서버 · PC 에 설치해 직접 운영합니다. AI 가 공식 문서를 찾아 정리한 가이드로, mopick 이 직접 따라 해 보지는 않았습니다 · 공식 문서에서 제품을 확인했습니다
준비할 것
- Python 3.10 이상 환경 (PATH 등록 필수)
- Claude Code 등 지원 AI 코딩 에이전트 CLI 설치 및 로그인 계정
- Git CLI 설치 환경
연동 단계
해 본 단계는 번호를 눌러 표시하세요. 표시는 이 브라우저에만 남습니다.
0% 진행
저장소 복제
터미널에서 git clone https://github.com/microsoft/TokenEconomizer.git 명령을 실행하여 로컬 환경에 저장소를 복제합니다.
마켓플레이스 등록
터미널에서 claude plugin marketplace add "$PWD/TokenEconomizer" 명령을 실행하여 복제한 경로를 로컬 플러그인 소스로 등록합니다.
플러그인 설치
터미널에서 claude plugin install tokeneconomizer@tokeneconomizer 명령을 실행해 Claude Code에 플러그인을 설치합니다.
카탈로그 초기화
작업 저장소로 이동해 claude를 실행한 뒤 에이전트 프롬프트에 /tokeneconomizer:toolprune refresh-catalog를 입력해 도구 목록을 갱신합니다.
붙여 넣는 설정 · 코드
YOUR_API_KEY 같은 자리에는 내 값을 넣으세요. 키는 코드 · 문서에 그대로 남기지 말고 환경 변수 · 비밀 저장소에 두세요.
Claude Code 플러그인 등록 및 설치 bash
git clone https://github.com/microsoft/TokenEconomizer.git claude plugin marketplace add "$PWD/TokenEconomizer" claude plugin install tokeneconomizer@tokeneconomizer
- 잘 연결됐는지 확인
- claude 실행 후 대화창에 /tokeneconomizer:status 입력 시 컨트롤러 상태 정보 블록이 정상 출력되는지 확인
- 비용
- 오픈소스 무료 (Apache-2.0 라이선스, 단 내부 판별 모델 호출 시 연결된 에이전트 요금제의 토큰 소모)
- 주의
- · 플러그인이 복제된 디렉터리를 계속 참조하므로 설치 후 다운로드한 TokenEconomizer 폴더를 삭제하거나 이동하면 안 됩니다.
- · 학습된 마이크로 스킬 및 캐시는 머신 로컬(~/.tokeneconomizer)에 저장되므로 작업자 PC 간 자동 공유되지 않습니다.
- · 단일 저장소에서 여러 세션이 누적되어야 효과가 발생하며, 일회성 신규 저장소 작업에서는 절감 효과가 제한적입니다.
공식 문서
우리 회사 시스템에 붙여야 한다면 — 업무 앱 · 사내 자료 · 보안 조건에 맞춘 연동을 TPI INSIGHT AX센터가 함께합니다.