Getting Started ko

Getting-Started · [한국어]

시작하기

cc-proficiency를 설치하고, 첫 번째 분석을 실행하고, 배지를 삽입합니다.

사전 요구 사항

• Node.js 18 이상
• (선택 사항이지만 권장) gh auth login으로 인증된 GitHub CLI

gh 없이는 배지가 로컬에 저장되고 자동 업로드가 비활성화됩니다.

설치

npm install -g cc-proficiency

초기화

cc-proficiency init

init은 다음 단계를 순서대로 수행합니다:

1. gh를 통해 GitHub 사용자 이름을 감지 (인증된 경우)
2. LANG/LC_ALL 환경 변수에서 로케일을 자동 감지
3. ~/.claude/settings.json에 Stop hook을 주입
4. 기존 세션의 초기 전체 분석을 실행
5. 비공개 GitHub Gist를 생성하고 배지를 푸시 (gh가 사용 가능한 경우)

gh가 인증된 경우의 출력 예시:

Initializing cc-proficiency...

  GitHub user: @yourname
  Locale: en
  ✓ Hook injected into ~/.claude/settings.json

  Running initial analysis...

  Claude Code Proficiency — @yourname
  ────────────────────────────────────────
  CC Mastery     ████████░░░░░░░░░░░░   40  ○
  Tool & MCP     ██████████░░░░░░░░░░   50  ○
  ...
  ────────────────────────────────────────
  3 sessions · 1 project

  Creating private Gist with badge...
  ✓ Gist created

  Add to your README:
  ![CC Proficiency](https://gist.githubusercontent.com/yourname/a1b2c3d4e5f6/raw/cc-proficiency.svg)

  ✓ Configuration saved to /home/you/.cc-proficiency
  Badge saved locally to: /home/you/.cc-proficiency/cc-proficiency.svg

gh 없이의 출력 예시:

Initializing cc-proficiency...

  ⚠ GitHub CLI not authenticated.
  Badge will be saved locally to: /home/you/.cc-proficiency/cc-proficiency.svg
  To enable auto-upload: gh auth login && cc-proficiency init

첫 번째 분석

기존 세션이 있는 경우, init이 이미 분석을 실행했습니다. 언제든 다시 실행할 수 있습니다:

cc-proficiency analyze --full

--full 없이는 아직 처리되지 않은 세션만 분석됩니다 (증분 모드).

Hook 작동 방식

init 후에는 수동으로 아무것도 실행할 필요가 없습니다. 흐름은 다음과 같습니다:

Claude Code를 정상적으로 사용
  → 세션 종료
  → Stop hook이 세션 경로를 ~/.cc-proficiency/queue.jsonl에 기록  (<1초)
  → 백그라운드 자식 프로세스로 cc-proficiency를 생성
  → 트랜스크립트를 파싱하고, 점수를 계산하고, SVG를 렌더링
  → 업데이트된 배지를 Gist에 푸시 (설정된 경우)

이것은 완전히 투명합니다. README 배지가 자동으로 업데이트됩니다.

README에 삽입

init 후, README에 다음 중 하나를 추가합니다:

<!-- 정적 배지 -->
![CC Proficiency](https://gist.githubusercontent.com/<username>/<gist-id>/raw/cc-proficiency.svg)

<!-- 애니메이션 배지 (로드 시 바가 채워짐) -->
![CC Proficiency](https://gist.githubusercontent.com/<username>/<gist-id>/raw/cc-proficiency-animated.svg)

Gist URL은 변경되지 않습니다. 두 SVG 모두 각 세션 후 제자리에서 업데이트됩니다.

프로그레시브 배지 단계

배지는 데이터가 축적됨에 따라 적응합니다:

단계	세션 수	표시 내용
보정 중	0–2	설정 체크리스트, 첫 번째 스코어링을 향한 진행
초기 결과	3–9	5개의 도메인 바 + 8개의 기능 미니바, 낮은 신뢰도 표시기 (○)
전체 배지	10+	전체 바, 기능 히트맵, 신뢰도 점 (● ◐ ○)

프로젝트 수준 기능

cc-proficiency는 Claude Code 프로젝트 수준 설정 디렉토리를 감지합니다. 프로젝트 루트의 .claude/ 아래에 배치하면 CC Mastery 도메인에서 점수를 획득합니다:

디렉토리	감지 내용	규칙
.claude/skills/	커스텀 스킬 정의	ccm-custom-skills (+10 pts)
.claude/agents/	커스텀 에이전트 정의	ccm-custom-agents (+10 pts)
.claude/agent-memory/	에이전트별 메모리 파일	메모리 시그널에 기여
.claude/rules/	규칙 파일	ccm-rules-files (+10 pts)

로컬 전용 모드

GitHub를 전혀 사용하지 않으려는 경우:

cc-proficiency analyze --full
cc-proficiency badge --output my-badge.svg

생성된 배지는 다국어 SVG로, SVG <switch> 요소와 systemLanguage를 사용하여 보는 사람의 선호 언어로 자동 표시됩니다. 지원되는 6개 언어 모두 하나의 파일에 포함되어 있습니다.

모든 것이 완전히 오프라인으로 작동합니다. 어떤 데이터가 로컬에 유지되는지에 대한 자세한 내용은 Privacy-ko를 참조하세요.

다음 단계

• Commands-ko: 전체 명령어 참조
• Scoring-ko: 5개 도메인과 약 53개 규칙의 작동 방식
• Achievements-ko: 잠금 해제할 마일스톤
• Leaderboard-ko: 옵트인 커뮤니티 랭킹