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

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에서 큰 영감을 받았습니다.
영감과 아키텍처 개념을 제공해 준 원본 프로젝트에 특별한 감사를 표합니다.