OMC 설정은(는) 무엇을 하나요?
이것은 당신이 배워야 할 유일한 명령어입니다. 이것을 실행한 후에는 다른 모든 것이 자동으로 처리됩니다.
이 스킬이 호출되면 아래 워크플로우를 즉시 실행하십시오. 사용자에게 이 지침을 다시 설명하거나 요약해서는 안 됩니다.
참고: 이 가이드의 모든 ~/.claude/... 경로는 CLAUDE_CONFIG_DIR 환경 변수가 설정된 경우 해당 변수를 따릅니다.
최적 사용 상황
사용자가 OMC 자체를 설치, 업데이트 또는 복구하려는 경우 이 설정 흐름을 선택하십시오.
- 마켓플레이스/플러그인 설치 사용자는
/plugin install oh-my-claudecode실행 후 이곳으로 이동합니다. - npm 사용자는
npm i -g oh-my-claude-sisyphus@latest실행 후 이곳으로 이동합니다. - 로컬 개발 및 워크트리 사용자는 체크아웃된 저장소를 업데이트하고 설정을 다시 실행한 후 이곳으로 이동합니다.
플래그 파싱
사용자 호출에서 플래그를 확인합니다:
--help→ 도움말 텍스트 표시(아래 참조) 후 중단--local→ 1단계만 실행(대상=로컬) 후 중단--global→ 1단계만 실행(대상=글로벌) 후 중단--force→ 사전 설정 확인 건너뛰고 전체 설정 실행(1단계 → 2단계 → 3단계 → 4단계)- 플래그 없음 → 사전 설정 확인 후 필요한 경우 전체 설정 실행
도움말 텍스트
사용자가 --help와 함께 실행하면 다음을 표시하고 중단합니다:
OMC 설정 - oh-my-claudecode 구성
사용법:
/oh-my-claudecode:omc-setup 초기 설정 마법사 실행 (또는 이미 구성된 경우 업데이트)
/oh-my-claudecode:omc-setup --local 로컬 프로젝트 구성 (.claude/CLAUDE.md)
/oh-my-claudecode:omc-setup --global 글로벌 설정 구성 (~/.claude/CLAUDE.md)
/oh-my-claudecode:omc-setup --force 이미 구성된 경우에도 전체 설정 마법사 강제 실행
/oh-my-claudecode:omc-setup --help 이 도움말 표시
모드:
초기 설정 (플래그 없음)
- 최초 설정을 위한 대화형 마법사
- CLAUDE.md 구성 (로컬 또는 글로벌)
- HUD 상태 표시줄 설정
- 업데이트 확인
- 사용 중지된 설정 값 제거 (5.0.0에서 defaultExecutionMode 제거됨) 및 MCP 등록을 Claude Code 네이티브 구성으로 전환
- 팀 모드 기본값 설정 (에이전트 수, 유형, 모델)
- 이미 구성된 경우 빠른 업데이트 옵션 제공
로컬 구성 (--local)
- `scripts/setup-claude-md.sh`를 통해 플러그인 로컬 코디네이터 호출; 셸은 사후 설치 작업 전에 코디네이터 응답과 종료 상태를 검증합니다.
- 변경이 필요한 파일에 대해서만 코디네이터가 생성한 바이트 동일 백업 보고
- 프로젝트별 설정
- OMC 업그레이드 후 프로젝트 구성을 업데이트하는 데 사용
글로벌 구성 (--global)
- `scripts/setup-claude-md.sh`를 통해 플러그인 로컬 코디네이터 호출; 셸은 사후 설치 작업 전에 코디네이터 응답과 종료 상태를 검증합니다.
- 변경된 글로벌 파일에 대해서만 코디네이터가 생성한 바이트 동일 백업 보고
- 기본값: ~/.claude/CLAUDE.md를 명시적으로 덮어써서 일반 `claude`도 OMC를 사용하도록 함
- 선택적 보존 모드는 사용자의 기본 `CLAUDE.md`를 유지하고 OMC를 `CLAUDE-omc.md`에 설치하여 `omc` 실행 시 사용
- 모든 Claude Code 세션에 적용
- 동일한 이름의 레거시 후크 파일은 정확한 과거 내용이 독립적으로 확인되지 않는 한 보존
- OMC 업그레이드 후 글로벌 구성을 업데이트하는 데 사용
강제 전체 설정 (--force)
- "이미 구성됨" 확인을 우회
- 처음부터 전체 설정 마법사 실행
- 환경 설정을 재구성하려는 경우 사용
예제:
/oh-my-claudecode:omc-setup # 최초 설정 (또는 구성된 경우 CLAUDE.md 업데이트)
/oh-my-claudecode:omc-setup --local # 이 프로젝트 업데이트
/oh-my-claudecode:omc-setup --global # 모든 프로젝트 업데이트
/oh-my-claudecode:omc-setup --force # 전체 설정 마법사 재실행
자세한 정보: https://github.com/Yeachan-Heo/oh-my-claudecode
설정 호출
이 스킬에서는 플러그인 캐시 디렉터리를 독립적으로 스캔하거나 플러그인 루트를 선택하지 마십시오. 실행 중인 플러그인 환경에서 제공된 플러그인 루트의 설정 스크립트를 호출합니다:
bash "${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-claude-md.sh" <local|global> [overwrite|preserve]
이 스크립트는 유일한 캐시 해결자입니다. 완전한 플러그인 루트(표준 docs/CLAUDE.md, 코디네이터 아티팩트, wiki 스킬)만 허용하며, 엄격한 전체 SemVer 캐시 버전을 선택하고, 컴파일된 소스 핸드셰이크를 검증하며, 코디네이터 프로토콜 또는 상태 불일치 시 오류와 함께 종료됩니다. 해당 코디네이터 외부에서 구성을 다운로드하거나 CLAUDE.md를 변경하지 마십시오.
사전 설정 확인: 이미 구성됨?
중요: 다른 작업을 수행하기 전에 설정이 이미 완료되었는지 확인하십시오. 이렇게 하면 사용자가 업데이트할 때마다 전체 설정 마법사를 다시 실행하지 않아도 됩니다.
# 설정이 이미 완료되었는지 확인
CONFIG_DIR="${CLAUDE_CONFIG_DIR:-$HOME/.claude}"
case "$CONFIG_DIR" in
"~") CONFIG_DIR="$HOME" ;;
"~/"*) CONFIG_DIR="$HOME/${CONFIG_DIR#\.~/}" ;;
"~\\"*) CONFIG_DIR="$HOME/${CONFIG_DIR#\.~\\}" ;;
esac
CONFIG_FILE="$CONFIG_DIR/.omc-config.json"
if [ -f "$CONFIG_FILE" ]; then
if ! command -v jq >/dev/null 2>&1; then
echo "오류: 기존 OMC 설정 상태를 검사하려면 jq가 필요합니다. 기존 구성이 수정되지 않았습니다."
exit 1
fi
if ! SETUP_COMPLETED=$(jq -r '.setupCompleted // empty' "$CONFIG_FILE" 2>/dev/null) \
|| ! SETUP_VERSION=$(jq -r '.setupVersion // empty' "$CONFIG_FILE" 2>/dev/null); then
echo "오류: 기존 OMC 구성이 유효한 JSON이 아닙니다. 기존 구성이 수정되지 않았습니다."
exit 1
fi
if [ -n "$SETUP_COMPLETED" ] && [ "$SETUP_COMPLETED" != "null" ]; then
echo "OMC 설정이 다음 날짜에 완료되었습니다: $SETUP_COMPLETED"
[ -n "$SETUP_VERSION" ] && echo "설정 버전: $SETUP_VERSION"
ALREADY_CONFIGURED="true"
fi
fi
이미 구성된 경우 (그리고 --force 플래그가 없는 경우)
ALREADY_CONFIGURED가 true이고 사용자가 --force, --local, --global 플래그를 전달하지 않은 경우:
AskUserQuestion을 사용하여 질문:
질문: "OMC가 이미 구성되어 있습니다. 어떻게 하시겠습니까?"
옵션:
- CLAUDE.md 업데이트 및 사용 중지된 설정 값 제거 - 활성 플러그인의 표준 CLAUDE.md를 설치하고 2단계 2.4를 실행하되 전체 설정을 다시 실행하지는 않습니다.
- 전체 설정 다시 실행 - 전체 설정 마법사를 처음부터 진행합니다.
- 취소 - 변경 없이 종료합니다.
사용자가 "CLAUDE.md 업데이트 및 사용 중지된 설정 값 제거"를 선택한 경우:
- 로컬(.claude/CLAUDE.md) 또는 글로벌(~/.claude/CLAUDE.md) 구성이 있는지 감지합니다.
- 로컬이 있으면 실행:
bash "${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-claude-md.sh" local - 글로벌만 있으면 실행:
bash "${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-claude-md.sh" global - 2단계 2.4를 실행하여 사용 중지된
defaultExecutionMode키를 제거합니다. - 정리 후 다른 모든 단계를 건너뜁니다.
- 성공을 보고하고 종료합니다.
사용자가 "전체 설정 다시 실행"을 선택한 경우:
- 아래 재개 감지로 계속 진행합니다.
사용자가 "취소"를 선택한 경우:
- 변경 없이 종료합니다.
강제 플래그 재정의
사용자가 --force 플래그를 전달하면 이 확인을 건너뛰고 직접 설정을 진행합니다.
재개 감지
단계를 시작하기 전에 기존 상태를 확인합니다:
bash "${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-progress.sh" resume
상태가 있는 경우(출력이 "fresh"가 아닌 경우), AskUserQuestion을 사용하여 질문:
질문: "이전 설정 세션이 발견되었습니다. 다시 시작하시겠습니까, 아니면 새로 시작하시겠습니까?"
옵션:
- 다음 단계부터 재개: $LAST_STEP - 중단된 지점에서 계속합니다.
- 새로 시작 - 처음부터 시작합니다(저장된 상태를 지웁니다).
사용자가 "새로 시작"을 선택한 경우:
bash "${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-progress.sh" clear
단계 실행
--local 또는 --global 플래그의 경우:
${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/01-install-claude-md.md 파일을 읽고 지침을 따릅니다.
(단계 파일은 플래그 모드에서 조기 종료를 처리합니다.)
전체 설정의 경우(기본값 또는 --force):
단계를 순서대로 실행합니다. 각 단계에 대해 해당 파일을 읽고 지침을 따릅니다:
-
1단계 - CLAUDE.md 설치:
${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/01-install-claude-md.md파일을 읽고 지침을 따릅니다. -
2단계 - 환경 구성:
${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/02-configure.md파일을 읽고 지침을 따릅니다. 2단계는 HUD/statusLine 설정을hud스킬에 위임해야 합니다. 여기서statusLine경로를 인라인으로 생성하거나 패치하지 마십시오. -
3단계 - 통합 설정:
${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/03-integrations.md파일을 읽고 지침을 따릅니다. -
4단계 - 완료:
${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/04-welcome.md파일을 읽고 지침을 따릅니다.
정상적인 인터럽트 처리
중요: 이 설정 프로세스는 ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-progress.sh를 통해 각 단계 후 진행 상태를 저장합니다. 인터럽트(Ctrl+C 또는 연결 끊김)가 발생하면 중단된 지점에서 설정을 재개할 수 있습니다.
최신 상태 유지
oh-my-claudecode 업데이트(npm 또는 플러그인 업데이트를 통해)를 설치한 후:
자동: /oh-my-claudecode:omc-setup을 실행하면 이미 구성되었음을 감지하고 나머지 마법사를 건너뛰는 빠른 "CLAUDE.md 업데이트 및 사용 중지된 설정 값 제거" 옵션을 제공합니다.
빠른 업데이트 경로는 2단계 2.4를 계속 수행하여 업그레이드 시 사용 중지된 defaultExecutionMode 값을 제거해야 합니다. 대체 실행 모드 설정을 작성해서는 안 됩니다.
수동 옵션:
/oh-my-claudecode:omc-setup --local로 프로젝트 구성만 업데이트/oh-my-claudecode:omc-setup --global로 글로벌 구성만 업데이트/oh-my-claudecode:omc-setup --force로 전체 마법사 재실행(환경 설정 재구성)
이렇게 하면 전체 설정을 반복하는 토큰 비용 없이 최신 기능과 에이전트 구성을 유지할 수 있습니다.