클로드스킬마트스킬 둘러보기바로 쓰는 문장영상으로 배우기터미널 사용법스킬이 뭐예요?
 
← 목록으로

Claude Code 저장소 아키텍처 가이드

Claude Code CLI 코드베이스의 디렉터리 구조, 도구/커맨드 작성 패턴, 명명 규칙을 Claude에게 주입하는 레포 전용 컨벤션 스킬.

개발·코딩고급★ 3,351⑂ 3,673AI 점수 5/10마지막 업데이트: 2026. 8. 29.

무엇을 해주나

Claude Code CLI(TypeScript, Bun, React+Ink 기반)의 내부 구조를 Claude가 이해한 상태로 작업하게 만듭니다.

  • src/ 하위 30여 개 디렉터리의 역할을 표로 정리 (tools/, commands/, components/, coordinator/, memdir/ 등)
  • main.tsx → entrypoints/init.ts → cli.tsx로 이어지는 초기화 순서 설명
  • buildTool()을 사용한 도구 정의 템플릿, PromptCommand/LocalCommand/LocalJSXCommand 세 가지 커맨드 유형 템플릿 제공
  • 권한 시스템(default/plan/bypassPermissions/auto, Bash(git *) 같은 와일드카드 규칙), bun:bundle 피처 플래그, Zod 검증, 지연 import 등 규약 명시
  • 파일·컴포넌트·타입·훅·상수 명명 규칙 표

이런 분께 추천

  • Claude Code CLI 소스(혹은 그 포크)를 직접 수정·확장하는 개발자
  • Ink + Bun 기반 터미널 애플리케이션의 실제 설계 사례를 참고하고 싶은 사람
  • 에이전트 도구/슬래시 커맨드 레지스트리 구조를 학습하려는 사람

참고: 문서가 가리키는 src/ 파일들은 스킬에 포함되어 있지 않습니다. 해당 코드베이스가 없으면 읽을 거리에 가깝습니다.

활용 예시

  1. "새 슬래시 커맨드 /changelog를 추가해줘" → PromptCommand 형식과 allowedTools 패턴을 따라 src/commands/에 파일을 만들고 src/commands.ts에 등록.
  2. "파일 삭제 도구를 만들어줘" → buildTool() 스켈레톤에 checkPermissions(), isReadOnly()를 구현하고 UI.tsx/prompt.ts를 분리한 디렉터리 구조로 생성.
  3. "실험 기능을 안전하게 감춰줘" → import { feature } from 'bun:bundle'로 감싸 빌드 시 데드코드 제거되도록 수정.

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/codeaashu/claude-code/HEAD/Skill.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 codeaashu/claude-code 의 Skill.m 폴더를 내 ~/.claude/skills/claude-code-skill/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/codeaashu/claude-code.git /tmp/cc-skill && mkdir -p ~/.claude/skills/claude-code-skill && cp /tmp/cc-skill/Skill.md ~/.claude/skills/claude-code-skill/SKILL.md

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 엽니다.
  2. 저장소를 임시 폴더로 복제합니다: git clone https://github.com/codeaashu/claude-code.git /tmp/cc-skill
  3. 스킬 폴더를 만듭니다: mkdir -p ~/.claude/skills/claude-code-skill
  4. 파일을 복사합니다: cp /tmp/cc-skill/Skill.md ~/.claude/skills/claude-code-skill/SKILL.md (파일명은 반드시 SKILL.md)
  5. Claude Code를 재시작하고 /skills 로 목록에 나타나는지 확인합니다.
  6. 대상 코드베이스 디렉터리에서 Claude Code를 실행한 뒤 "이 저장소의 도구 정의 규약대로 새 도구를 추가해줘"처럼 요청합니다.
GitHub에서 원본 보기 ↗라이선스: NOASSERTION