Claude Code 모델 스위칭의 번거로움을 끝내는 CLI 도구, Clother

`Claude Code`를 사용하면서 Anthropic의 공식 모델뿐만 아니라 `GLM-5`(Z.AI), `OpenRouter`, 심지어 로컬의 `Ollama`까지 병행해서 활용하고 싶은 경우가 많다. 하지만 프로바이더를 바꿀 때마다 설정 파일을 열어 `ANTHROPIC_BASE_URL`을 수정하거나 API 키를 교체하는 작업은 매우 번거로운 일이다. 특히 Anthropic 구독 모델로 되돌아오기 위해 기존 설정을 지워야 하는 과정은 작업 흐름을 끊는 주범이 된다.

이번 포스팅에서는 이런 불편함을 해결해 줄 수 있는 CLI 도구인 `Clother`를 소개한다. 이 도구는 설정 파일을 매번 고치는 대신, 각 프로바이더 전용 실행 파일(Launcher)을 생성하여 명령어 하나로 즉시 모델을 전환하게 해준다.

GitHub - jolehuit/clother: Configure and launch multiple Claude Code–compatible LLM providers from one CLI, switching profiles

---

 

Clother의 작동 원리: 런처 방식

`Clother`는 기존 설정을 덮어쓰는 방식이 아니라, 각 프로바이더에 필요한 환경 변수를 미리 세팅한 독립적인 스크립트를 만든다. 예를 들어 `clother-zai`라는 명령어를 실행하면 내부적으로 다음과 같은 작업이 일어난다.

• `ANTHROPIC_BASE_URL`을 Z.AI의 엔드포인트로 설정
• `ANTHROPIC_AUTH_TOKEN`에 등록된 Z.AI API 키를 대체
• 최종적으로 claude 명령어를 실행

이 덕분에 사용자는 복잡한 환경 변수 관리 없이 개별 명령어만 기억하면 된다.

---

 

설치 및 초기 설정

Clother를 설치하기 위해서는 먼저 Claude Code CLI가 설치되어 있어야 한다. 이후 아래 명령어를 통해 Clother를 설치할 수 있다.

[!Warning]이 도구는 macOS와 Linux의 쉘 환경에서 작동하도록 작성된 스크립트다. 윈도우 사용자는 반드시 WSL 환경에서 사용해야 하며, 일반적인 명령 프롬프트나 파워쉘에서는 작동하지 않는다는 점에 유의하자.

 

1. Claude Code 설치 (미설치 시)

# Install Claude Code CLI
curl -fsSL https://claude.ai/install.sh | bash

 

2. Clother 설치

# Install Clother
curl -fsSL https://raw.githubusercontent.com/jolehuit/clother/main/clother.sh | bash

[!Tip] 삭제를 위해서는 `clother uninstall` 명령어를 사용하면 된다.

터미널에서 Clother 설치 모습

 

3. 프로바이더 설정

# 사용할 모델 및 API 키를 설정
clother config

[!Warning]
- GLM Coding Plan 설정을 위해 International - zai  을 선택하고 API 키를 입력한다.
- 모델 설정 단계에서 GLM Coding Plan 이 `Pro` 이상일 경우에만 `glm-5` 를 사용할 수 있다.
- 만약 GLM Coding Plan 이 `Lite` 구독 플랜일 경우 `glm-4.7` 모델을 선택한다.

[!Warning]만약 이전에 `~/.claude/settings.json` 파일을 수동으로 수정하여 Anthropic End Point 를 수정했다면 제거해야한다. 그렇지 않으면 Clother 에 의해 설정된 환경변수가 오버라이드되어 무조건 해당 설정으로 실행되는 문제가 발생한다. 

[!Note]GLM Coding Plan 에 대해 좀더 자세한 정보를 원한다면 이전 포스팅을 참고하자.

터미널에서 clother config를 통해 zai 의 GLM 모델 API 키를 입력하는 장면

 

---

 

주요 명령어와 프로바이더 활용

설정이 완료되면 터미널에서 `clother-`로 시작하는 명령어를 통해 즉시 원하는 환경의 Claude Code를 띄울 수 있다.

clother-zai 와 clother-native 명령어로 프로바이더를 스위칭하는 장면

 

1. 주요 클라우드 프로바이더

명령어	프로바이더	특징
`clother-native`	Anthropic	기존 구독(Pro/Max) 모델 사용
`clother-zai`	Z.AI	최신 GLM-5 모델 활용
`clother-deepseek`	DeepSeek	deepseek-chat 모델 연결
`clother-or`	OpenRouter	100개 이상의 외부 모델 접근 가능

2. 로컬 및 커스텀 모델

로컬에서 Ollama를 돌리고 있다면 API 비용 없이 Claude Code의 기능을 활용할 수 있다.

# Ollama에서 특정 모델로 실행할 때
clother-ollama --model qwen3-coder

 

---

 

마무리

Clother는 단순하지만 Claude Code 와의 유연성을 극대화한다. 여러 프로바이더를 목적에 따라 빠르게 오가며 테스트해야 하는 개발자라면, 매번 수동으로 설정을 바꾸는 번거로움에서 벗어나 Clother의 프로필 기반 관리 방식을 도입해 보길 권장한다.