Model & CLI Commands
AI 모델 전환, CLI 프로바이더 전환, 폴백 체인 구성, 프로바이더 간 요청 포워딩, Gemini 사고 모드 토글, 모델 할당 초기화를 위한 명령어입니다. 이 명령어들을 사용하면 재시작 없이 세션 도중에 AI 백엔드를 동적으로 재구성할 수 있습니다.
명령어 요약
| 명령어 | 인수 | 설명 |
|---|---|---|
/model | [name] | 활성 AI 모델 전환 |
/cli | [name] | 활성 CLI 프로바이더 전환 |
/fallback | [cli1 cli2 ...|off] | 폴백 순서 설정 또는 비활성화 |
/forward | [on|off] | 다른 프로바이더로의 요청 포워딩 활성화 또는 비활성화 |
/thought | [on|off] | Gemini 사고(확장 추론) 모드 토글 |
/flush | [cli] [model] | off | 모델을 CLI에 고정하거나 고정 해제 |
/model [name]
현재 CLI 프로바이더 내에서 활성 AI 모델을 전환합니다. 모델 이름은 활성 프로바이더가 인식하는 유효한 식별자여야 합니다. 인수 없이 호출하면 현재 활성 모델을 표시합니다.
인수
| 인수 | 필수 | 설명 |
|---|---|---|
name | 아니오 | 전환할 모델 식별자. 생략하면 현재 모델을 표시합니다. |
지원 모델 (예시)
| 프로바이더 | 모델 식별자 |
|---|---|
| Claude | claude-opus-4-8, claude-opus-4-8[1m], claude-sonnet-4-6, claude-haiku-4-5 |
| Gemini | gemini-3-flash-preview, gemini-2.5-flash, gemini-2.0-flash |
| OpenAI | gpt-5.5, gpt-5.4, gpt-5.4-mini, gpt-5.3-codex |
| Grok | grok-3, grok-3-mini |
claude-e를 선택하세요.사용 예시
# Show current model
/model
# Switch to Claude Opus 4.8
/model claude-opus-4-8
# Switch to Sonnet for lighter tasks
/model claude-sonnet-4-6
# Switch to Gemini 2.5 Pro
/model gemini-3-flash-preview
/model 호출에 매핑합니다. "더 똑똑한 모델로 바꿔줘"라고 말하면 오케스트레이터가 사용 가능한 가장 강력한 모델을 선택합니다./cli [name]
활성 CLI 프로바이더를 전환합니다. 이 명령어는 전체 백엔드를 변경합니다 — API 엔드포인트, 인증, 사용 가능한 모델, 도구 기능이 모두 프로바이더와 함께 변경됩니다. 인수 없이 호출하면 현재 CLI를 표시합니다.
인수
| 인수 | 필수 | 설명 |
|---|---|---|
name | 아니오 | 전환할 CLI 프로바이더. 생략하면 현재 CLI를 표시합니다. |
지원 CLI
| CLI 이름 | 프로바이더 | 기본 모델 |
|---|---|---|
claude | Anthropic Claude Code | claude-opus-4-8 |
claude-e | Claude E interactive wrapper | claude-opus-4-8 |
codex | OpenAI Codex CLI | gpt-5.5 |
codex-app | OpenAI Codex app server | gpt-5.5 |
gemini | Google Gemini CLI | gemini-3-flash-preview |
grok | xAI Grok | grok-3 |
opencode | OpenCode (멀티 프로바이더) | 가변 |
copilot | GitHub Copilot | 가변 |
사용 예시
# Show current CLI
/cli
# Switch to Claude
/cli claude
# Switch to Gemini
/cli gemini
# Switch to Codex
/cli codex
# Switch to Grok
/cli grok
전환 시 동작
CLI를 전환하면 CLI-JAW는 다음을 수행합니다:
- 현재 프로바이더와의 연결을 정상적으로 종료합니다
- 새 프로바이더를 기본 모델로 초기화합니다 (
/flush고정이 있는 경우 제외) - 지원되는 경우 대화 컨텍스트를 이어받습니다
- 상태 바와 대시보드를 새 프로바이더로 업데이트합니다
/fallback [cli1 cli2 ...|off]
CLI 프로바이더의 폴백 체인을 구성합니다. 주 CLI가 실패하면(속도 제한, 네트워크 오류, API 장애) CLI-JAW가 자동으로 체인의 다음 프로바이더를 시도합니다. 이를 통해 단일 프로바이더가 다운되더라도 중단 없는 운영을 보장합니다.
인수
| 인수 | 필수 | 설명 |
|---|---|---|
cli1 cli2 ... | 아니오 | 우선순위 순서로 공백으로 구분된 CLI 이름 목록 |
off | 아니오 | 폴백 체인을 완전히 비활성화 |
사용 예시
# Set fallback: try Gemini first, then Codex, then Grok
/fallback gemini codex grok
# Set Claude as the only fallback
/fallback claude
# Disable fallback (only use the active CLI)
/fallback off
# Show current fallback chain
/fallback
폴백 동작 방식
- 활성 CLI로 요청이 전송됩니다
- 활성 CLI가 오류를 반환하면(속도 제한, 타임아웃, 5xx) 첫 번째 폴백 CLI로 요청을 재시도합니다
- 그것도 실패하면 체인의 다음 CLI로 이동합니다
- 모든 폴백이 소진되면 사용자에게 오류를 표시합니다
/forward [on|off]
다른 프로바이더로의 요청 포워딩을 활성화하거나 비활성화합니다. 포워딩이 활성화되면 특정 요청을 보조 프로바이더로 라우팅하여 전문적으로 처리할 수 있습니다 — 예를 들어, Gemini를 대화용 주 프로바이더로 사용하면서 코드 생성 요청은 Claude로 보내거나, 이미지 분석을 비전 지원 모델로 라우팅할 수 있습니다.
인수
| 인수 | 필수 | 설명 |
|---|---|---|
on | 아니오 | 포워딩 활성화 |
off | 아니오 | 포워딩 비활성화 |
사용 예시
# Enable forwarding
/forward on
# Disable forwarding
/forward off
# Show current forwarding status
/forward
포워딩 활용 시나리오
| 시나리오 | 주 CLI | 포워딩 대상 |
|---|---|---|
| 대화 중 코드 생성 | gemini | claude |
| 텍스트 전용 CLI에서 비전 작업 | codex | gemini |
| 비용 최적화 (가벼운 작업은 로컬, 무거운 작업은 포워딩) | grok | claude |
/thought [on|off]
Gemini의 사고(확장 추론) 모드를 토글합니다. 활성화하면 Gemini가 응답하기 전에 추가 연산을 사용하여 단계별로 추론합니다. Claude의 확장 사고 기능과 유사합니다. 다단계 수학, 논리 퍼즐, 아키텍처 결정과 같은 복잡한 작업에 유용합니다. Gemini가 활성 CLI일 때만 적용됩니다.
인수
| 인수 | 필수 | 설명 |
|---|---|---|
on | 아니오 | 사고 모드 활성화 |
off | 아니오 | 사고 모드 비활성화 |
사용 예시
# Enable Gemini thinking
/thought on
# Disable thinking (faster responses, lower cost)
/thought off
# Show current thinking status
/thought
사고 모드 활용 시점
- 활성화 권장: 복잡한 추론, 다단계 문제, 아키텍처 결정, 까다로운 이슈 디버깅, 수학/논리
- 비활성화 권장: 간단한 질문, 빠른 편집, 파일 작업, 일상적인 작업 (시간과 토큰 절약)
/flush [cli] [model] | off
특정 모델을 CLI 프로바이더에 고정하거나 기존 고정을 해제합니다. 플러시 고정이 설정되면 해당 CLI로 전환할 때 프로바이더의 기본 모델 대신 고정된 모델이 자동으로 로드됩니다. off를 사용하여 모든 고정을 해제하거나 특정 고정을 해제할 수 있습니다.
인수
| 인수 | 필수 | 설명 |
|---|---|---|
cli | 아니오 | 모델을 고정할 CLI 프로바이더 |
model | 아니오 | 해당 CLI에 고정할 모델 |
off | 아니오 | 모든 플러시 고정을 해제하거나, CLI 이름 뒤에 사용하면 해당 CLI의 고정을 해제 |
사용 예시
# Pin Claude to always use Opus 4.8
/flush claude claude-opus-4-8
# Pin Gemini to always use 2.5 Pro
/flush gemini gemini-3-flash-preview
# Clear the Claude pin (reverts to default model on next switch)
/flush claude off
# Clear all pins
/flush off
# Show current flush pins
/flush
플러시 고정 동작 방식
플러시 고정은 세션에 저장되며 명시적으로 해제하거나 세션이 종료될 때까지 유지됩니다. 프로바이더의 기본 모델 선택을 재정의합니다:
/flush claude claude-opus-4-8을 설정합니다- 나중에
/cli gemini으로 Gemini로 전환합니다 /cli claude로 다시 전환하면 자동으로claude-opus-4-8을 사용합니다
자연어 매핑
CLI-JAW의 명령어 파서는 한국어와 영어 모두 자연어를 이해합니다. 다음은 자주 사용되는 문구와 해당 명령어 매핑입니다:
| 자연어 | 매핑되는 명령어 |
|---|---|
| "클로드로 바꿔줘" | /cli claude |
| "제미나이로 전환해줘" | /cli gemini |
| "오퍼스 모델로 바꿔줘" | /model claude-opus-4-8 |
| "소넷으로 내려줘" | /model claude-sonnet-4-6 |
| "더 똑똑한 모델 써줘" | /model (사용 가능한 가장 강력한 모델로 업그레이드) |
| "더 빠른 모델로" | /model (사용 가능한 가장 빠른 모델로 다운그레이드) |
| "클로드 안 되면 제미나이 써줘" | /fallback gemini |
| "폴백 꺼줘" | /fallback off |
| "포워딩 켜줘" | /forward on |
| "생각 모드 켜줘" | /thought on |
| "빠르게 답해줘" | /thought off |
| "클로드는 항상 오퍼스 써줘" | /flush claude claude-opus-4-8 |
| "플러시 초기화해줘" | /flush off |
| "Switch to Claude" | /cli claude |
| "Use the smartest model" | /model (가장 강력한 모델로 업그레이드) |
| "Set fallback to Gemini then Grok" | /fallback gemini grok |
일반적인 워크플로우
비용 최적화 설정
일상적인 작업에는 경량 모델을 사용하고, 필요할 때를 위해 강력한 모델을 고정해 둡니다:
# Default to Opus 4.8 for strongest Claude work
/model claude-opus-4-8
# Pin Opus for when you switch to heavy tasks
/flush claude claude-opus-4-8
# Set Gemini Flash as fallback for rate limits
/fallback gemini
멀티 프로바이더 복원력
폴백을 체이닝하여 중단 없는 서비스를 보장합니다:
# Primary: Claude, Fallback: Gemini -> Grok -> Codex
/cli claude
/fallback gemini grok codex
# Pin each provider to its best model
/flush claude claude-opus-4-8
/flush gemini gemini-3-flash-preview
/flush grok grok-3
Gemini 심층 추론 세션
복잡한 분석을 위해 사고 모드를 활성화한 상태로 Gemini로 전환합니다:
# Switch to Gemini Pro with thinking
/cli gemini
/model gemini-3-flash-preview
/thought on
# When done, switch back to Claude
/cli claude
/thought off