configure-ecc

Everything Claude Code 설정하기

현재 도구 내에서 대화형 마법사를 실행합니다. 먼저 현재 상태를 점검하고, 지원되는 옵션만 수집한 후, 미리 보고, 한 번 확인하고, 비대화식으로 적용하며, 검증하고, 성공한 경우에만 환영 메시지를 표시합니다. ECC를 임시 디렉토리에 복제하거나 플러그인 컴포넌트를 수동으로 복사하지 마십시오.

사람이 조작하는 터미널에서는 표준 진입점은 ecc setup과 npx ecc-universal setup입니다. 도구 내부에서는 아래의 명시적인 비대화식 명령을 대신 사용하십시오.

현재 도구에 따라 분기

• Claude Code에서는 아래의 전체 범위 및 후크 마법사를 사용합니다.
• Codex에서는 Codex의 네이티브 플러그인 라이프사이클을 사용합니다. Claude 범위를 제공하거나 ECC의 네 가지 Claude 후크 프로필을 Codex에 매핑하지 마십시오.
• Kimi에서는 ./.kimi-code 아래에 프로젝트 표면을 설치합니다. Kimi는 ECC의 Claude 라이프사이클 후크 프로필을 제공하지 않습니다.
• 도구가 불확실한 경우, 감지된 증거를 설명하고 어떤 도구를 구성할지 사용자에게 물은 후 변경 명령을 실행하십시오.

이 스킬은 설치 후 재구성 경로입니다. 제공자의 내장된 첫 설치 UI를 가로채거나 대체할 수 없습니다.

Claude Code: 전체 대화형 마법사 실행

1. 변경 없이 현재 상태 점검

두 명령을 모두 실행하고 설치된 ECC 범위, 활성화 상태, 마켓플레이스 출처를 요약하십시오:

claude plugin list --json
claude plugin marketplace list --json

단일 기존 ecc@ecc 설치는 재구성으로 간주합니다. Claude의 제공자 소유 "Open home page" 제어를 설치 증거로 해석하지 마십시오. 여러 ECC 범위, 레거시/수동 설치, 잘못된 설정 또는 마켓플레이스 충돌이 있는 경우 setup이 반환한 복구 방법을 보고하고 중단하십시오. 어떤 상태를 삭제할지 추측하지 마십시오.

2. 정확히 두 가지 선택 수집

정확히 하나의 범위 질문을 하고 하나의 값을 요구하십시오:

• user | project | local
• user는 이 사용자에게 전역입니다.
• project는 저장소 설정을 통해 공유됩니다.
• local은 현재 프로젝트에 비공개입니다.

선택된 범위만 시각적으로 선택 또는 설치 중으로 표시하십시오. 사용자가 단일 기존 설치와 다른 범위를 선택하는 경우, 범위 마이그레이션으로 설명하고 아래 명령에 --move-scope를 포함하십시오.

정확히 하나의 후크 모드 질문을 하고 하나의 값을 요구하십시오:

• off | minimal | standard | strict
• off는 스킬과 명령을 유지하지만 ECC 후크 자동화를 비활성화합니다.
• minimal은 가장 가벼운 라이프사이클 및 안전 자동화를 활성화합니다.
• standard는 품질과 안전 자동화의 균형을 맞춥니다.
• strict는 가장 강력한 검사와 알림을 활성화합니다.

후크 선호도는 개인 Claude 플러그인 설정이며, 선택한 설치 범위를 따르지 않습니다.

3. 미리 보고 한 번 확인

플러그인 번들 설정 스크립트를 선호합니다. 선택한 두 값을 대체하고 범위 마이그레이션의 경우에만 --move-scope를 포함하십시오:

node "$CLAUDE_PLUGIN_ROOT/scripts/setup.js" --mode claude-plugin \
  --scope <scope> --hooks <hooks> [--move-scope] --dry-run --json

$CLAUDE_PLUGIN_ROOT을 사용할 수 없는 경우, 게시된 npm 패키지를 사용하십시오:

npx --yes --package ecc-universal ecc setup --mode claude-plugin \
  --scope <scope> --hooks <hooks> [--move-scope] --dry-run --json

정확히 하나의 확인 요약을 표시하십시오. 여기에는 계획된 작업, 하나의 범위, 하나의 후크 모드, 마켓플레이스 작업, 그리고 출발지에서 목적지로의 마이그레이션이 포함되어야 합니다. 하나의 예/아니오 질문을 하십시오. 도구 셸을 통해 빈 대화형 ecc setup을 실행하지 마십시오. 해당 셸은 일반적으로 TTY가 아닙니다.

4. 명시적 선택 적용

확인 후, --dry-run 없이 동일한 경로를 다시 실행하십시오. 모든 선택을 명시적으로 유지하고 JSON을 요청하여 성공 여부를 결정적으로 확인할 수 있도록 하십시오:

node "$CLAUDE_PLUGIN_ROOT/scripts/setup.js" --mode claude-plugin \
  --scope <scope> --hooks <hooks> [--move-scope] --yes --json

대체 수단:

npx --yes --package ecc-universal ecc setup --mode claude-plugin \
  --scope <scope> --hooks <hooks> [--move-scope] --yes --json

5. 검증 후 환영 메시지 표시

종료 코드가 0이고 설정 결과의 scope와 hooks가 선택한 값과 일치해야 합니다. 그런 다음 독립적으로 실행하십시오:

claude plugin list --json

선택한 범위에 정확히 하나의 활성화된 ecc@ecc 항목이 있는 경우에만 계속하십시오. $CLAUDE_PLUGIN_ROOT을 사용할 수 있는 경우, 성공적인 설정 action(installed, updated, migrated, resumed, 또는 already-migrated)을 번들 렌더러에 전달하십시오:

호출하기 전에 제공자가 보고한 버전이 scripts/lib/terminal-welcome.js의 ECC_VERSION_PATTERN과 일치하는지 확인하십시오. 예상치 못한 버전 텍스트를 셸 명령에 삽입하는 대신 거부하십시오.

node -e 'const { renderTerminalWelcome } = require(process.env.CLAUDE_PLUGIN_ROOT + "/scripts/lib/terminal-welcome"); process.stdout.write(renderTerminalWelcome({ action: process.argv[1], version: process.argv[2], color: process.stdout.isTTY }));' "<action>" "<installed-version>"

정확히 한 번 환영 메시지를 표시하십시오. 실패, 드라이런, 취소, 범위 또는 후크 불일치, 또는 확인할 수 없는 상태에서는 표시하지 말고 오류와 복구 방법을 보고하십시오. 확인된 변경 후 사용자에게 /reload-plugins를 실행하거나 Claude Code를 다시 시작하라고 알리십시오.

Codex: 네이티브 플러그인 라이프사이클 사용

codex plugin marketplace list --json 및 codex plugin list --available --json으로 현재 상태를 점검하십시오. Codex의 네이티브 플러그인 명령에는 Claude 스타일의 user | project | local 선택자가 없습니다. Codex 네이티브 플러그인은 제공자별 후크를 지원하지만, Codex는 이에 대한 명시적 신뢰가 필요합니다. Codex가 신뢰 결정을 표시하도록 하십시오. Claude의 네 가지 프로필 후크 질문을 하거나 해당 프로필이 Codex에 매핑된다고 주장하지 마십시오.

ECC 마켓플레이스가 없는 경우 추가하십시오. 그렇지 않으면 스냅샷을 새로고침하십시오:

codex plugin marketplace add affaan-m/ECC
codex plugin marketplace upgrade ecc --json

한 번 확인을 요청한 다음, 설치하거나 이미 설치된 캐시를 멱등적으로 새로고침하고 확인하십시오:

codex plugin add ecc@ecc --json
codex plugin list --json

JSON이 ECC가 설치되었음을 보고하고 installedPath를 제공하는 경우에만 계속하십시오. 그런 다음 확인된 번들의 환영 메시지를 표시하십시오:

Codex JSON이 반환한 정확한 절대 installedPath만 사용하십시오. 제어 문자를 거부하고 설치된 버전이 ECC_VERSION_PATTERN과 일치하는지 확인하십시오. node를 이 인수 배열과 함께 직접 호출하십시오. 이는 도구 API 호출이며 셸 명령이 아닙니다:

["<installedPath>/scripts/welcome.js", "--action", "configured", "--version", "<installed-version>"]

현재 도구가 별도의 인수 배열로 실행 파일을 호출할 수 없는 경우 환영 메시지를 건너뛰십시오. Codex JSON 값으로 셸 명령을 절대 생성하지 마십시오.

Claude의 off | minimal | standard | strict 프로필이 Codex에 적용되었다고 절대 주장하지 마십시오.

Kimi: 프로젝트 표면 설치

확인 전에 기능 요약을 표시하십시오: 대상 ./.kimi-code; ECC 라이프사이클 후크에 대해 hooks=unsupported. Claude 범위 또는 후크 모드 질문을 하지 마십시오. 먼저 미리 보기:

npx --yes --package ecc-universal ecc install --profile core --target kimi --dry-run

해당 프로젝트 대상에 대한 한 번 확인을 표시한 다음, --dry-run 없이 동일한 명령을 적용하십시오. 다음으로 확인하십시오:

npx --yes --package ecc-universal ecc doctor --target kimi

doctor가 성공하고 설치된 명령과 스킬이 ./.kimi-code 내에 유지된 경우에만 다음을 표시하십시오:

npx --yes --package ecc-universal ecc welcome --action configured

Kimi가 ECC 라이프사이클 후크를 설치하거나 구성했다고 주장하지 마십시오.