Claude Code와 SuperClaude 세팅 가이드

2025년 9월에 정리한 내용이다. Claude Code와 SuperClaude 모두 업데이트가 잦으므로, 설치 명령과 옵션은 각 공식 문서에서 최신 내용을 확인한다.

1. 준비

Claude Pro 또는 Max 구독(또는 Anthropic API 키)
macOS, Linux, Windows(네이티브 또는 WSL)
SuperClaude를 쓰려면 Python 3.10 이상

2. Claude Code 설치와 로그인

설치 방법은 공식 문서의 권장 방식을 따른다.

# 프로젝트 루트에서 실행
cd your-project
claude

첫 실행 시 로그인 절차가 진행된다. 세션 안에서는 슬래시 명령으로 상태를 확인하고 관리한다.

명령	용도
`/login`, `/logout`	계정 전환
`/status`	로그인 방식·모델 등 현재 상태
`/permissions`	도구 허용·거부 규칙 관리
`/memory`	CLAUDE.md 메모리 파일 편집
`/clear`	대화 컨텍스트 초기화
`/init`	프로젝트를 분석해 CLAUDE.md 초안 생성

VS Code·Cursor 등의 통합 터미널에서 claude를 실행하면 IDE 확장 연동을 안내한다.

3. CLAUDE.md로 프로젝트 맥락 주기

프로젝트 루트의 CLAUDE.md는 세션마다 자동으로 읽히는 프로젝트 메모리다.

# 프로젝트 개요
React + TypeScript 프론트엔드와 Node.js API로 구성된 웹 애플리케이션.

## 명령어
- 개발 서버: `npm run dev`
- 테스트: `npm test`
- 린트: `npm run lint`

## 코딩 규칙
- ESLint + Prettier
- 커밋 메시지는 Conventional Commits 형식

## 주요 디렉터리
- `src/components`: 공용 컴포넌트
- `src/api`: API 클라이언트

CLAUDE.md: 팀과 공유하는 프로젝트 메모리(커밋)
~/.claude/CLAUDE.md: 모든 프로젝트에 적용되는 개인 메모리

자주 실행하는 명령, 테스트 방법, 지켜야 할 규칙처럼 매번 설명해야 하는 내용을 적어 두는 것이 효과적이다. 너무 길면 오히려 중요한 지시가 묻히므로 짧게 유지한다.

4. 권한 설정

.claude/settings.json(팀 공유) 또는 .claude/settings.local.json(개인)에 허용·거부 규칙을 둔다.

{
  "permissions": {
    "allow": ["Bash(npm run lint)", "Bash(npm run test:*)"],
    "deny": ["Bash(curl:*)", "Read(./.env)"]
  }
}

자주 쓰는 안전한 명령은 허용해 두면 매번 승인하지 않아도 되고, 비밀 파일 읽기나 외부 요청은 거부 규칙으로 막아 둔다.

5. SuperClaude

SuperClaude는 Claude Code에 /sc: 접두사의 커스텀 명령과 역할별 프롬프트를 추가하는 서드파티 프레임워크다. Anthropic 공식 도구가 아니며, ~/.claude 아래에 명령·설정 파일을 설치한다.

# pipx 사용 시
pipx install SuperClaude
SuperClaude install

# uv 사용 시
uv tool install SuperClaude
SuperClaude install

설치 후 Claude Code 세션에서 다음처럼 사용한다.

/sc:analyze src/auth --focus security
/sc:implement "모바일 반응형 네비게이션"
/sc:test src/utils
/sc:document src/api
/sc:git

명령 이름과 플래그는 버전마다 바뀌어 왔으므로, 설치한 버전의 /sc:help나 README로 확인한다. 이 명령들은 결국 Claude Code에 전달되는 프롬프트 템플릿이다. 같은 작업을 자연어로 요청해도 되며, 팀에서 자주 쓰는 절차를 고정하고 싶을 때 유용하다.

메이저 버전을 올릴 때 이전 버전 파일과 충돌하면, 문서의 업그레이드 안내에 따라 이전 설치를 제거한 뒤 다시 설치한다. ~/.claude 아래에는 직접 만든 설정과 메모리도 있으므로, 통째로 지우기 전에 백업한다.

6. 유용한 팁

입력창에서 !로 시작하면 셸 명령을 바로 실행한다.
Esc 두 번으로 이전 메시지 시점으로 돌아가 다시 지시할 수 있다.
파일 경로를 @로 참조하면 해당 파일을 맥락에 넣는다.
큰 작업은 먼저 계획을 세우게 한 뒤(plan mode) 실행하면 방향이 어긋나는 일을 줄일 수 있다.