Claude Alloy

그 구성 요소들보다 더 강력한 혼합물.

Quick Start • Agents • Install • Dev Guide • Contributing

ig

IGNITE 모드를 활성화합니다 — 강철(steel)이 의도를 언어화하고, 전문가들을 병렬로 실행하며, HUD가 컨텍스트(context) / 비용(cost) / 할당량(quota)을 실시간으로 추적합니다.

팀과 함께하는 Claude Code.

14명의 전문가 에이전트(agent). 모델 계층화(Opus/Sonnet/Haiku)를 통해 검색을 위해 과도한 비용을 지불하는 일을 방지합니다. 런타임(runtime) 제로. 하나의 설정 오버레이(config overlay). 활성화하는 명령 하나, 제거하는 명령 하나.

강철(Steel)은 구조를 유지합니다. 텅스텐(Tungsten)은 압력 아래에서도 녹지 않습니다. 수은(Mercury)은 빠르게 움직입니다. 그래핀(Graphene)은 모든 것을 전도합니다.

alloy

그게 전부입니다. 14명의 에이전트, 23개의 훅(hooks), 10개의 기술(skills), 15개의 명령(commands) + HUD 상태 표시줄(statusline). 전역적으로 활성화됩니다. 어떤 디렉토리에서든 Claude Code를 열고 바로 시작하세요.

이 도구가 시간을 절약해 주었다면, ⭐를 눌러주세요 — 그것이 제가 계속 개발을 이어갈 수 있는 동력이 됩니다.

unalloy

순정(vanilla) Claude로 돌아갑니다. 원래의 설정이 정확하게 복구됩니다.

| 가장 높은 비강도(strength-to-weight ratio). 가볍지만 모든 것을 복구함. |
iridium |
sonnet | 성능 검토자. O(n²), 메모리 누수(memory leaks), N+1 쿼리(N+1 queries)를 찾아냄. | 가장 밀도가 높은 천연 원소. 가장 무거운 문제들을 포착함. |
cobalt |
sonnet | 의존성 전문가. CVE, 오래된 패키지, 공급망 리스크(supply chain risks). | 필수적인 미량 원소. 작지만 전체에 결정적임. |
flint |
sonnet | 테스트 엔지니어. 커버리지 공백(coverage gaps), 불안정한 테스트(flaky tests), 누락된 엣지 케이스(edge cases). | 불꽃을 일으킴. 무엇이 고장 나는지 찾아냄. |

모델 계층화(Model tiering)는 의도적입니다. Opus는 오케스트레이션(orchestration)과 판단을 담당합니다. Sonnet은 조사와 분석을 담당합니다. Haiku는 grep을 담당합니다. 당신은 검색이 아니라 사고(thinking)에 비용을 지불합니다.

런타임 없는 순수 설정(Pure config, no runtime). 플러그인 시스템, 데몬(daemon), 백그라운드 프로세스가 없습니다. 오직 마크다운 에이전트 정의, 셸 훅(shell hooks), 그리고 settings.json만 존재합니다. bash를 읽을 수 있다면, 모든 라인을 감사(audit)할 수 있습니다.

의도적인 모델 계층화(Deliberate model tiering). 오케스트레이션과 판단을 위한 Opus. 조사와 구현을 위한 Sonnet. grep을 위한 Haiku. 당신은 검색이 아니라 사고에 비용을 지불합니다.

다양한 설치 모드(Multiple install modes). activate.sh / deactivate.sh를 통한 전역 토글, 프로젝트별 드롭인(drop-in), 플러그인 스타일, 또는 전역 명령 — 당신의 워크플로에 맞는 방식을 선택하세요.

완전한 가역성(Fully reversible). /unalloy는 이전의 Claude Code 설정을 정확하게 복구합니다. 종속성(lock-in)이나 잔여물이 남지 않습니다.

선형 파이프라인이 아닌 적응형 라우팅(Adaptive routing, not a linear pipeline). Steel은 모든 작업을 고정된 순서로 강제하거나 명확한 목적 없이 에이전트를 생성하는 대신, 작업에 필요한 요구사항(FAST, RESEARCH, PLAN, BUILD, SECURITY 등)에 따라 경로를 지정합니다.

Claude Code — Anthropic의 CLI 에이전트 (npm install -g @anthropic-ai/claude-code)

Claude Pro/Max 구독 또는 Anthropic API 키 — 멀티 에이전트 워크로드에는 Max를 권장합니다.

bash (4.0+), jq, git

토큰 사용량: claude-alloy는 오케스트레이션에는 Opus를, 구현에는 Sonnet을, 검색에는 Haiku를 라우팅합니다. 따라서 당신은 검색이 아니라 사고에 비용을 지불합니다. 멀티 에이전트 작업(특히 `ig

에는 단일 에이전트 Claude Code보다 더 많은 토큰을 사용합니다. 더 높은 Rate Limit (속도 제한)를 제공하는 Claude Max를 5배/20배 사용하실 것을 강력히 권장합니다. API 사용자의 경우 복잡한 작업 시 일반적인 토큰 사용량의 약 2-3배를 예상할 수 있습니다.

일회성 Alias (별칭) 설정:

git clone https://github.com/OMARVII/claude-alloy.git
cd claude-alloy
bash setup-aliases.sh
...

그 다음, 어디에서든:

alloy # 전역적으로 14개의 에이전트 활성화
unalloy # 순정 Claude 상태로 복귀

그 후 Claude 내부에서, 최대 노력 모드(maximum effort mode)를 위해 ** ig** (또는 /ignite)를 입력하세요 — 모든 에이전트가 병렬로 작동하며, 어떠한 작업도 미완성 상태로 제출되지 않습니다.

상태: 플러그인 메타데이터는 포함되어 있으나, 완전한 Hook (훅)/설정 경험을 위해서는 Global Toggle (전역 토글) 또는 프로젝트별 설치를 권장합니다. Claude Code 플러그인 범위의 에이전트는 ~/.claude 또는 프로젝트의 .claude/ 디렉토리에 설치된 파일보다 더 엄격한 제한이 적용됩니다.

# 로컬 플러그인 테스트 (먼저 클론하세요)
claude --plugin-dir /path/to/claude-alloy

# 특정 프로젝트에만 설치
bash install.sh --project /path/to/project
# 또는 전역 /alloy-init 명령어를 설정한 후, 모든 프로젝트에서 사용하세요
...

설치 후, 서브 에이전트(subagents)를 위한 MCP Schema Pinning (MCP 스키마 고정)을 활성화하려면 docs/mcp-config.md를 참조하세요 (cp .mcp.json.example .mcp.json).

.claude/
├── agents/ 14개 에이전트 (steel, tungsten, quartz, mercury, graphene, carbon, prism, gauge, spectrum, sentinel, titanium, iridium, cobalt, flint)
├── skills/ 10개 스킬 (git-master, frontend-ui-ux, dev-browser, code-review, review-work, ai-slop-remover, tdd-workflow, verification-loop, pipeline, hyperplan)
...

어떠한 도구 | 컨텍스트 사용량 ~70% / ~85%에서 권고 경고 (도구 호출 100 / 140회) |
statusline |
지속적인 HUD | HUD: 모델, ctx%, 세션 지속 시간, 도구 수, cwd (settings.json의 statusLine을 통해 설정) |

Steel은 고정된 파이프라인을 따르지 않습니다. 적응형으로 경로를 지정합니다:

┌─ FAST: 직접 처리
│
사용자 → steel ──├─ RESEARCH: mercury ×N + graphene ×N (병렬)
...

차별점: prism은 인라인(inline)으로 실행되며(별도의 단계가 아님), gauge는 선택 사항입니다(필수 게이트가 아님). 또한 모든 빌드 후에는 변경 사항에 따라 일치하는 리뷰어 — sentinel (보안), iridium (성능), cobalt (의존성), flint (테스트) — 를 호출하는 리뷰 게이트가 작동합니다. quartz는 파이프라인에 포함되지 않습니다 (정체되었을 때만 사용). 고정된 순서도 없고 이유 없는 에이전트 생성도 없습니다 — steel은 작업별로 적응합니다.

기본 모드는 정밀 라우팅(precision-routed) 모드입니다. 불확실성, 리스크 또는 규모로 인해 가치가 생길 때 에이전트가 가동됩니다. ig는 완전한 병렬 처리를 위해 명시적으로 선택(opt-in)하는 모드입니다.

ig (또는 /ignite)를 입력하여 최대 출력(maximum effort) 모드를 실행하세요: 6개 이상의 에이전트가 병렬로 가동되며, 할 일(todos)을 집요하게 추적하고, 모든 완료 주장(completion claim) 전에 수동 QA를 수행합니다. 단 두 글자만으로 전체 팀이 투입됩니다.

alloy는 기존 Claude 설정과 병합됩니다. 사용자의 커스텀 권한, 모델 선호도 및 플러그인이 그대로 유지됩니다. unalloy를 입력하면 설정이 정확히 복구됩니다.

디스크에 아무것도 기록하지 않고 단일 세션 동안에만 claude-alloy를 로드하려면 --plugin-url 플래그와 함께 claude를 실행하세요:

claude --plugin-url https://github.com/OMARVII/claude-alloy/releases/download/v1.7.1/claude-alloy.zip

플러그인은 압축이 해제되어 세션 동안 사용된 후 종료 시 폐기됩니다. 이는 릴리스 후보(release candidate)를 테스트하거나, 전체 설치를 결정하지 않고 일회성 작업에 alloy를 시도해 볼 때 유용합니다. --plugin-url 플래그에 대한 문서는 https://code.claude.com/docs/en/cli-reference 에서 확인할 수 있습니다.

요약(TL;DR)—cd /path/to/claude-alloy && git pull을 실행하세요. 전역 심볼릭 링크(symlink) 설치는 즉시 업데이트됩니다. 복사 모드(Copy-mode) 및 프로젝트별 설치는 한 단계를 더 거쳐야 합니다: alloy 또는 bash install.sh --project .를 다시 실행하세요.

전역 설치(alloy)는 macOS 및 Linux에서 기본적으로 **심볼릭 링크 (symlinks)**를 사용합니다. 이는 claude-alloy 저장소에서 git pull을 실행하면 모든 에이전트, 스킬, 명령어 및 훅(hooks)이 즉시 업데이트됨을 의미하며, 재활성화가 필요하지 않습니다.

cd /path/to/claude-alloy
git pull # 심볼릭 링크 모드: 변경 사항이 즉시 적용됩니다

명시적인 제어를 선호하는 경우:

alloy --update # 최신 버전 pull + 한 번에 재활성화 (re-activate)
alloy --check # 상태 점검 (health checks, alloy doctor) 실행
alloy --version # 설치된 버전 표시

활성화 시 자동 업데이트 (auto-update)를 비활성화하려면:

export ALLOY_AUTO_UPDATE=0 # 환경 변수 (세션별 적용)
touch ~/.claude/.alloy-no-update # 영구적인 옵트아웃 (opt-out)

심볼릭 링크 (symlinks)를 지원하지 않는 WSL/Windows 또는 파일 시스템의 경우, alloy는 자동으로 **복사 모드 (copy mode)**로 전환됩니다. 복사 모드에서는 git pull을 수행한 후 alloy를 실행하여 업데이트를 적용하세요.

프로젝트별 설치 (Per-project installs)는 항상 복사본을 사용하므로 (심볼릭 링크 아님), 업데이트를 위해서는 설치 프로그램을 다시 실행해야 합니다:

cd /path/to/claude-alloy
git pull
bash install.sh --project /path/to/your/project

프로젝트 설치를 위해 setup-global.sh와 /alloy-init을 사용했다면, 먼저 캐시된 페이로드 (cached payload)를 업데이트하세요:

cd /path/to/claude-alloy
git pull
bash setup-global.sh # ~/.claude/alloy-dist/를 새로고침합니다

그 다음, 업데이트를 적용하기 위해 Claude Code 내의 각 프로젝트 안에서 /alloy-init을 다시 실행하세요.