Oh My ClaudeCode
Reference

환경 변수

OMC의 동작을 제어하는 환경 변수 전체 목록과 사용법

핵심 환경 변수

DISABLE_OMC

OMC의 모든 훅을 비활성화합니다.

export DISABLE_OMC=1

값이 설정되어 있으면 (어떤 값이든) OMC가 완전히 비활성화됩니다. Claude Code는 OMC 없이 기본 동작으로 실행됩니다.

OMC_SKIP_HOOKS

특정 훅만 건너뜁니다. 쉼표로 구분합니다.

export OMC_SKIP_HOOKS="keyword-detector,persistent-mode"

전체 비활성화(DISABLE_OMC) 없이 특정 훅만 끄고 싶을 때 씁니다.

상태 관리

OMC_STATE_DIR

상태 파일을 중앙 집중식으로 관리합니다.

export OMC_STATE_DIR="$HOME/.claude/omc"
항목기본값설정 후
상태 저장 위치{worktree}/.omc/$OMC_STATE_DIR/{project-id}/
워크트리 삭제 시상태 함께 삭제상태 보존

프로젝트 식별자는 Git remote URL의 해시값을 사용합니다. 같은 리포지토리의 서로 다른 워크트리에서도 상태를 공유합니다.

기능 제어

변수기본값설명
OMC_PARALLEL_EXECUTIONtrue병렬 에이전트 실행 허용
OMC_LSP_TOOLStrueLSP 도구 활성화
OMC_MAX_BACKGROUND_TASKS5최대 백그라운드 작업 수
OMC_LSP_TIMEOUT_MS15000LSP 요청 타임아웃 (밀리초)

모델 라우팅

변수기본값설명
OMC_ROUTING_ENABLEDtrue지능형 모델 라우팅 활성화
OMC_ROUTING_DEFAULT_TIERMEDIUM기본 모델 티어 (LOW/MEDIUM/HIGH)
OMC_ROUTING_FORCE_INHERITfalse부모 모델 상속 강제
OMC_ESCALATION_ENABLEDtrue에스컬레이션 허용

모델 별칭 오버라이드

export OMC_MODEL_ALIAS_HAIKU="custom-haiku-model"
export OMC_MODEL_ALIAS_SONNET="custom-sonnet-model"
export OMC_MODEL_ALIAS_OPUS="custom-opus-model"

비표준 프로바이더를 쓸 때 모델 이름을 매핑합니다.

외부 모델

변수기본값설명
OMC_CODEX_DEFAULT_MODEL(프로바이더 기본값)Codex CLI 기본 모델
OMC_GEMINI_DEFAULT_MODEL(프로바이더 기본값)Gemini CLI 기본 모델
OMC_EXTERNAL_MODELS_DEFAULT_PROVIDER-기본 외부 프로바이더 (codex/gemini)
OMC_EXTERNAL_MODELS_FALLBACK_POLICYprovider_chain모델 실패 시 폴백 정책

위임 라우팅

변수기본값설명
OMC_DELEGATION_ROUTING_ENABLEDfalse외부 프로바이더로의 위임 라우팅 활성화
OMC_DELEGATION_ROUTING_DEFAULT_PROVIDERclaude기본 위임 프로바이더

MCP 서버

변수설명
EXA_API_KEYExa MCP 서버 API 키

고급 설정

변수설명
OMC_BRIDGE_SCRIPTPython 브릿지 스크립트 경로 (자동 감지)
OMC_USE_NODE_HOOKS1로 설정하면 macOS/Linux에서 Node.js 훅 사용

사용 예시

비용 절약 모드

# 라우팅 비활성화, 모든 에이전트가 부모 모델 상속
export OMC_ROUTING_FORCE_INHERIT=true

디버깅 모드

# 특정 훅만 비활성화해서 문제 격리
export OMC_SKIP_HOOKS="persistent-mode,keyword-detector"

대규모 프로젝트

# LSP 타임아웃 늘리기
export OMC_LSP_TIMEOUT_MS=30000

# 더 많은 백그라운드 작업 허용
export OMC_MAX_BACKGROUND_TASKS=10

On this page