Molayo

© 2026 Molayo

GitHub요약2026. 05. 18. 03:52

Claude Code API 제공자 간의 원활한 전환을 지원하는 CLI 도구 Clauver

요약

Clauver는 여러 Claude Code API 제공자(Anthropic, Z.AI, MiniMax, Kimi 등) 사이를 원활하게 전환하고 관리할 수 있도록 설계된 강력한 CLI 도구입니다. 이 도구는 단일 명령어로 제공자를 쉽게 전환하며, age 암호화를 사용하여 API 키를 안전하게 저장합니다. 또한, 자동 완성 기능과 빠른 설정 마법사 등을 제공하여 사용자 경험을 향상시킵니다.

핵심 포인트

  • 다양한 Claude Code API 제공자(Anthropic, Z.AI, MiniMax 등) 간의 원활한 전환 및 관리 지원
  • age 암호화를 활용하여 민감한 API 키를 안전하게 저장하고 메모리 내에서만 복호화
  • 단일 명령어로 제공자 설정, 테스트, 기본값 지정이 가능하며 자동 완성 기능을 지원
  • Linux 환경에 최적화되어 있으며, 설치 스크립트와 대화형 마법사를 통해 사용 편의성을 높임

██████╗██╗ █████╗ ██╗ ██╗██╗ ██╗███████╗██████╗
██╔════╝██║ ██╔══██╗██║ ██║██║ ██║██╔════╝██╔══██╗
██║ ██║ ███████║██║ ██║██║ ██║█████╗ ██████╔╝
...

Claude Code Provider Manager - 여러 Claude Code API 제공자(providers) 사이를 원활하게 전환합니다.

Clauver는 다음과 같은 다양한 Claude Code API 제공자들을 쉽게 관리하고 전환할 수 있게 해주는 강력한 CLI 도구입니다:

Native Anthropic - 기존의 Claude Pro/Team 구독 사용
Z.AI - Zhipu AI의 GLM 모델
MiniMax - MiniMax AI의 MiniMax-M2 모델
Kimi - Moonshot AI의 Kimi K2 모델
DeepSeek - DeepSeek AI의 DeepSeek 모델
Custom Providers - 사용자 정의 제공자 추가

⚠️ 플랫폼 호환성 (Platform Compatibility): 이 스크립트는 Linux에서만 작동하도록 테스트 및 확인되었습니다. 다른 Unix 계열 시스템(macOS, WSL)에서도 작동할 수 있지만, 호환성이 보장되지는 않습니다.

주요 기능

  • 간편한 제공자 전환 (Easy Provider Switching) - 단일 명령어로 제공자 전환
  • 안전한 API 키 관리 (Secure API Key Management) - age (X25519)를 사용하여 API 키 암호화
  • 설정 테스트 (Configuration Testing) - 사용 전 제공자 설정 테스트
  • 기본 제공자 (Default Provider) - 빠른 액세스를 위한 기본 제공자 설정
  • 자동 완성 (Auto-completion) - bash, zsh, fish를 위한 탭(Tab) 완성 지원
  • 빠른 설정 마법사 (Quick Setup Wizard) - 초보자를 위한 대화형 설정
  • 상태 모니터링 (Status Monitoring) - 설정된 모든 제공자를 한 번에 확인
  • 자가 업데이트 (Self-Update) - 단일 명령어로 최신 버전 업데이트
  • 암호화 저장 (Encrypted Storage) - 비밀 정보는 저장 시 암호화되며, 메모리 내에서만 복호화됨

사전 요구 사항

claude CLI - 설치 방법:
npm install -g @anthropic-ai/claude-code

age - 암호화를 위해 필요:
sudo apt install age (또는 macOS의 경우 brew install age)

Bash/Zsh/Fish - 자동 완성을 위해 필요

API Keys - 제3자 제공자를 위해 필요

설치 방법

curl -fsSL https://raw.githubusercontent.com/dkmnx/clauver/main/install.sh | bash

설치 프로그램은 다음을 수행합니다:

  • ✅ claude 명령 확인
  • ✅ ~/.clauver/bin/에 clauver 설치
  • ✅ 자동 완성 설정
  • ✅ PATH 추가 (필요한 경우)
# 저장소 복제 (Clone the repository)
git clone https://github.com/dkmnx/clauver clauver
cd clauver
...

clauver setup # 대화형 설정 마법사 (Interactive setup wizard)

clauver config zai # Z.AI 설정
clauver config minimax # MiniMax 설정
clauver config kimi # Kimi 설정
...

clauver anthropic # Native Anthropic 사용
clauver zai # Z.AI 사용
clauver minimax # MiniMax 사용
...

빠른 접근을 위해 기본 제공자 (Default provider)를 설정하세요:

# 기본 제공자 설정
clauver default zai
# 현재 기본 제공자 표시
...

clauver list # 모든 제공자 목록 표시
clauver status # 제공자 상태 확인
clauver test <name> # 제공자 테스트
...

# 최초 설정
clauver setup
# 제공자 설정
...

# 특정 제공자 테스트
clauver test zai
# 모든 제공자 테스트
...

# 선호하는 기본 제공자 설정
clauver default minimax
# 기본 설정 확인
...

# 현재 버전 및 사용 가능한 업데이트 확인
clauver version
# 최신 버전으로 업데이트
...

Clauver는 현대적이고 안전한 파일 암호화 도구인 age를 사용하여 모든 API 키를 자동으로 암호화합니다. 귀하의 비밀 정보(Secrets)는 다음과 같이 관리됩니다:

  • 디스크에 저장될 때 암호화된 상태로 유지 (Encrypted at rest)
  • 필요할 때만 메모리로 복호화됨
  • 평문(Plaintext) 상태로 디스크에 기록되지 않음

중요 (CRITICAL): 설치 직후 암호화 키를 즉시 백업하세요!

# 암호화 키 위치
~/.clauver/age.key
# 키 백업 (한 가지 방법 선택):
...

age 키가 없으면 비밀 정보를 복호화할 수 없습니다!

암호화 키를 분실한 경우:

# 1. 백업이 있는 경우, 복구합니다:
cp ~/backup/clauver-age.key.backup ~/.clauver/age.key
chmod 600 ~/.clauver/age.key
...

평문 비밀 정보를 사용하는 이전 버전에서 업그레이드하는 경우:

# 현재 저장 유형 확인
clauver status
# 암호화된 저장소로 마이그레이션
...

암호화 키는 휴대 가능합니다! 다른 머신에서 설정을 사용하려면 다음과 같이 하세요:

# 원본 머신에서 - 두 파일을 모두 백업합니다:
cp ~/.clauver/age.key ~/backup/
cp ~/.clauver/secrets.env.age ~/backup/
...

# 커스텀 제공자 추가
clauver config custom
# 제공자 이름: my-provider
...

Clauver는 bash, zsh, fish를 위한 자동 완성 (auto-completion) 기능을 포함하고 있습니다.

설치 후 다음을 시도해 보세요:

clauver <TAB><TAB> # 사용 가능한 명령어 표시
clauver z<TAB> # 'clauver zai'로 완성

Clauver는 단위 테스트 (unit tests), 통합 테스트 (integration tests), 보안 검증 (security validation) 및 성능 벤치마크 (performance benchmarks)를 포함하는 포괄적인 테스트 스위트 (test suite)를 갖추고 있습니다.

# 모든 테스트 실행
cd tests/
make test
...

다음 내용을 포함한 상세한 테스트 정보는:

  • 테스트 카테고리 및 커버리지 영역 (coverage areas)
  • CI/CD 파이프라인 및 지속적 통합 (continuous integration)
  • 보안 테스트 및 성능 벤치마크
  • 테스트 기여 가이드라인 (contributing guidelines)

👉 전체 테스트 문서는 tests/README.md를 참조하세요.

Clauver는 암호화된 설정 시스템을 사용합니다:

~/.clauver/
├── secrets.env.age # 암호화된 API 키 (age로 암호화됨)
├── age.key # 암호화 키 (chmod 600) - 반드시 백업하세요!
...

  • secrets.env.age: age (X25519) 암호화를 사용하여 암호화된 API 키
    ZAI_API_KEY
    MINIMAX_API_KEY
    KIMI_API_KEY
    DEEPSEEK_API_KEY
    비밀 정보는 메모리 내에서만 복호화되며, 디스크에 평문 (plaintext)으로 절대 기록되지 않습니다.

  • age.key: 암호화 키 (자동 생성)
    주의: 이 파일을 백업하세요! 이 파일이 없으면 비밀 정보를 복호화할 수 없습니다.

    • 기기 간 이동 가능 - 이 파일을 복사하여 다른 곳에서 설정을 사용할 수 있습니다.
    • 위치: ~/.clauver/age.key

  • config: 제공자 설정을 저장합니다:

    • 기본 URL (Base URLs), 모델, 엔드포인트 ID (endpoint IDs)
    • 커스텀 제공자 정의
      default_provider
    • 사용자가 선호하는 기본 제공자

저장 시 암호화 (Encrypted at Rest): API 키는 age(현대적이고 안전한 암호화 방식)를 사용하여 암호화됩니다.
메모리 전용 복호화 (Memory-Only Decryption): 비밀 정보는 프로세스 치환 (process substitution)을 통해 메모리로 직접 복호화됩니다.
디스크 내 평문 없음 (No Plaintext on Disk): 암호화된 파일은 평문으로 기록되지 않습니다.
세션 캐싱 (Session Caching): 성능을 위해 세션당 한 번씩 비밀 정보를 복호화합니다.
자동 키 생성 (Automatic Key Generation): 첫 사용 시 암호화 키가 자동으로 생성됩니다.
마이그레이션 지원 (Migration Support): 평문에서 암호화된 저장소로 원활하게 마이그레이션할 수 있습니다.

문제가 발생했나요? 전체 문제 해결 (troubleshooting) 가이드를 참조하세요.

일반적인 해결 방법:

PATH 문제: export PATH="$HOME/.clauver/bin:$PATH"

누락된 의존성 (dependencies): npm install -g @anthropic-ai/claude-code

age 암호화 (encryption): sudo apt install age (또는 brew install age)

제공자 (provider) 테스트: clauver test <provider>

상태 확인 (status check): clauver status

Clauver는 jolehuit의 clother에서 큰 영감을 받았습니다.
영감과 아키텍처 개념을 제공해 준 원본 프로젝트에 특별한 감사를 표합니다.

AI 자동 생성 콘텐츠

본 콘텐츠는 GitHub Claude Ecosystem의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.

원문 바로가기
0

댓글

0