Claude Code Dashboard
내 Claude Code에 설정된 모든 커스텀 구성을 한 눈에 확인합니다.
마지막 업데이트 2026-07-20
개념 정리
▾Claude Code 생태계를 구성하는 8가지 핵심 개념. 위에서 아래로 추상화 수준이 높아진다.
Tool
Layer 1
Claude가 직접 쓰는 내장 도구 하나. 파일 읽기, 코드 수정, 검색, 쉘 실행 등 가장 작은 실행 단위.
Read Edit Write Bash Grep Glob
MCP Tool
Layer 1+
외부 서비스와 연결하는 도구. MCP 서버가 중간 다리 역할을 해서 Notion, Gmail 등을 Claude가 직접 조작할 수 있게 함.
Notion Gmail Chrome Claude Preview↔ Tool과의 차이: Tool은 내장, MCP Tool은 외부 서버 경유
API
Layer 1+
외부 AI 모델을 직접 호출. Codex CLI를 통해 GPT-5.4/5.3에게 교차 검증 수행. Proxima MCP는 보조용.
ask_chatgpt ask_gemini ask_all_ais↔ MCP Tool과의 차이: MCP Tool은 서비스 조작, API는 AI 모델 호출
Skill
Layer 2
/명령어로 실행하는 재사용 프롬프트 템플릿. 여러 Tool을 조합해 특정 작업을 수행하는 레시피./commit /recap /pdf /dashboard↑ Tool을 조합: Skill = Tool + Tool + ... 의 실행 순서
Plugin
Layer 3
스킬 번들 팩. 하나의 플러그인이 관련된 여러 스킬을 묶어서 제공. 마켓플레이스에서 설치.
design → 7개 스킬 · anthropic-skills → 6개 스킬↑ Skill을 묶음: Plugin = Skill + Skill + ... 를 하나의 패키지로
Agent
Layer 4
특정 역할의 독립 실행 주체. 자체 도구 세트와 모델을 가지고 자율적으로 판단하며 작업 수행.
developer debugger researcher tester↑ Tool+Skill을 자율 사용: 스스로 판단해서 어떤 도구를 쓸지 결정
Hook
자동화
특정 이벤트가 발생할 때 자동 실행되는 쉘 명령. Tool 호출 전후, 파일 저장 시 등에 트리거.
pre-commit lint · post-edit format · pre-push test
↔ Skill과의 차이: Skill은 사용자가 호출, Hook은 이벤트가 자동 트리거
CLAUDE.md
설정
매 대화 시작 시 자동으로 읽히는 지시 파일. 글로벌(~/.claude/)과 프로젝트별(.claude/) 두 레벨 존재.
에이전트 규칙 · 교차 검증 절차 · 응답 스타일
↔ Hook과의 차이: CLAUDE.md는 정적 지시, Hook은 동적 스크립트 실행
Claude Code가 실행될 때 실제로 일어나는 일. 세션 시작부터 결과 출력까지의 전체 흐름.
세션 시작 (초기화)
1
CLAUDE.md 읽기 — 글로벌(~/.claude/) → 프로젝트(.claude/) 순서
설정
2
Memory 파일 로드 — MEMORY.md 인덱스 + 관련 메모리 참조
설정
3
settings.json 적용 — 허용된 도구, Bash 명령어, MCP 서버 목록
설정
사용자 메시지 수신 (실행)
4
Orchestrator(Claude)가 작업 분석 — 무엇을 해야 하는지 판단
5
Tool / MCP Tool 직접 사용 — 파일 읽기, Notion 조회 등
도구
6
또는 Skill 호출 — /commit, /pdf 등 프롬프트 템플릿 실행
스킬
7
또는 Agent 위임 — developer, debugger 등 서브에이전트에게 작업 분배
에이전트
8
필요 시 Codex CLI 교차 검증 — /codex:rescue로 GPT-5.4에게 검증 요청
Codex
작업 완료 (마무리)
9
Hook 트리거 — 설정된 경우 자동 실행 (lint, format, test 등)
훅
10
결과 출력 — 사용자에게 결과 전달, Memory 업데이트 (필요 시)
헷갈리기 쉬운 개념들을 나란히 비교. 핵심 차이점에 집중.
Tool vs MCP Tool
Tool
내장 도구, 항상 사용 가능
로컬 파일 시스템 작업
네트워크 불필요
예: Read, Edit, Bash
MCP Tool
외부 서비스 연결
MCP 서버가 중간 다리
네트워크/인증 필요
예: Notion, Gmail, Chrome
Skill vs Plugin
Skill
단일 /명령어
하나의 특정 작업 수행
개별 설치/생성 가능
예: /commit, /pdf
Plugin
여러 Skill의 묶음
관련 기능을 패키지로
마켓플레이스에서 설치
예: design (7개 스킬)
Agent vs Skill
Agent
자율적으로 판단하며 실행
자체 도구 + 모델 보유
복잡한 작업 독립 처리
예: developer, debugger
Skill
정해진 프롬프트 실행
Orchestrator가 도구 사용
단일 작업에 특화
예: /commit, /recap
Hook vs CLAUDE.md
Hook
이벤트 시 동적 실행
쉘 스크립트/명령어
settings.json에서 설정
예: pre-commit lint
CLAUDE.md
세션 시작 시 정적 로드
마크다운 지시 문서
글로벌 + 프로젝트별
예: 에이전트 규칙, 스타일
MCP Tool vs API
MCP Tool
외부 서비스 조작
CRUD 작업 (읽기/쓰기)
Notion 페이지 편집 등
데이터 + 액션 중심
API
다른 AI 모델 호출
질문/검증 (read-only)
GPT에게 교차 검증 등
지능 + 판단 중심
에이전트 (Agents)
11개 ▾개발 계열
🔵
developer
sonnet
코드 작성, 기능 구현, 버그 수정
ReadEditWrite
BashGrepGlob
🔴
debugger
opus
에러 분석, 근본 원인 추적, 코드 리뷰
ReadEditBash
GrepGlob
🟡
tester
sonnet
테스트 설계, 작성, 실행, 커버리지
ReadWriteEdit
BashGrepGlob
설계 & 리서치 계열
🩵
architect
opus
시스템 설계, 아키텍처, 기술 스택
ReadGrepGlob
WebSearchWebFetch
🩷
researcher
opus
논문, 기술 문서, 라이브러리 조사
ReadGrepGlob
WebSearchWebFetch
🩵
analyst
sonnet
데이터 전처리, 통계, 시각화
ReadWriteBash
GrepGlob
검증 & 문서 계열
🟠
plan-verifier
sonnet
연구 계획/설계 교차 검증 (Codex CLI → GPT-5.4)
BashReadWrite
Codex CLI
🟣
code-verifier
haiku
코드 교차 검증 (Codex CLI → GPT-5.3-Codex)
BashReadWrite
Codex CLI
🟣
tech-writer
sonnet
README, API 문서, 보고서
ReadWriteEdit
GrepGlob
운영 계열
🟢
progress-tracker
haiku
작업 체크리스트, 진행상황 추적
ReadWrite
EditGlob
⬜
research-orchestrator
opus
에너지 시스템 연구 코디네이터 (Custom role)
Custom role
⚡ Agent 호출 규칙
→
에러/버그 발생 시 debugger 먼저 분석 → 수정은 developer
→
새 기능 구현: architect → developer → tester 순
→
진행상황 질문 ("지금 어디까지?", "현황", "다음 뭐해?") → progress-tracker 즉시
→
핵심 로직 변경 → code-verifier (GPT 교차 검증)
→
연구 계획/설계 검증 → plan-verifier (GPT 교차 검증)
→
독립 작업 2개 이상 → 병렬 실행 (백그라운드 시 사용자에게 명시)
Commands & Skills
6 Commands | 12+7+11 Skills ▾커스텀 명령어 (Custom Commands)
/portfolio-update
일일 포트폴리오
research-portfolio repo에 오늘 작업 기록 (journal + changelog)
/recap
세션 요약
지난 채팅 작업 내역 한국어로 빠르게 요약
/research-toolkit
연구 도구
시뮬레이션, 체크리스트, 리팩토링, 논문 피겨 생성
/dashboard
대시보드
이 대시보드 HTML 파일을 최신 상태로 자동 업데이트
/linkedin-post
LinkedIn 게시물
뉴스/내 작업 추천 → 변형안 생성 → 터미널 출력 (--preview로 HTML)
/sync-papers
논문 동기화
EndNote → Obsidian 논문 메타 동기화
빌트인 스킬 (Built-in Skills — 12개)
📄 문서 처리 (5개)
pdf
docx
pptx
xlsx
github-to-pptx
🔧 도구 (4개)
skill-creator
update-config
keybindings-help
simplify
⚙️ 자동화 (3개)
loop
schedule
claude-api
🏭 사용자 정의 스킬 — Aspen Automation (11개)
🔬 파이프라인 단계 (9개)
/aspen-scan
/aspen-save
/aspen-doe
/aspen-sim
/aspen-obj
/aspen-exergy
/aspen-preprocess
/aspen-train
/aspen-optimize
🎛️ 제어 (2개)
/aspen-pipeline
/aspen-status
🎨 플러그인 스킬 — Design (7개)
🎨 Design (7개)
design-critique
accessibility-review
design-handoff
design-system
ux-copy
research-synthesis
user-research
설정 & 권한
▾
⚙️ settings.json
🔒 settings.local.json
허용된 Bash 명령어
허용된 도구
허용된 도메인
MCP 도구 (Proxima) — 40개+ 허용 (보조용, 교차 검증은 Codex CLI 우선)
Proxima MCP 도구 허용되어 있으나, 교차 검증은 Codex CLI (/codex:rescue)를 우선 사용
추가 디렉토리
기타 설정
Marketplace: claude-plugins-official
Auto Updates: latest channel
플러그인 (Plugins)
2개 ▾
🔌
codex
v1.0.2
openai-codex — GPT 교차 검증 CLI 플러그인
1 Agent
7 Commands
3 Skills
🎨
frontend-design
latest
claude-plugins-official — Generates distinctive, production-grade frontend interfaces that avoid generic AI aesthetics
1 Skill
Enabled
🔌 codex (openai-codex) 상세
→
Status: Enabled
→
Agent: codex-rescue
→
Commands (7):
setup
review
adversarial-review
rescue
status
result
cancel
→
Skills (3): code-review, plan-rescue, adversarial-review
템플릿 & CLAUDE.md 규칙
▾
템플릿 (3개) — 로컬 템플릿 폴더에서 관리
cross-validation-report-template.md
GPT 교차 검증 리포트
request → report → response → summary 4단계 구조
request → report → response → summary 4단계 구조
plan_document.md
아키텍처 계획서
Meta, Summary, Groups, Dependencies, Risks 섹션
Meta, Summary, Groups, Dependencies, Risks 섹션
vr_report.md
검증 리포트
findings, verdict, confidence 항목 포함
findings, verdict, confidence 항목 포함
CLAUDE.md 핵심 규칙 (Global — ~/.claude/CLAUDE.md)
1
서브에이전트 적극 활용
독립 작업 2개+ → 병렬 실행. 10개 에이전트 색상 체계. 전문 영역은 항상 해당 에이전트 사용. 백그라운드 병렬 실행 시 반드시 사용자에게 명시하고 agent별 담당 작업을 표로 안내 (병렬 실행 안내 규칙).
2
GPT 피드백 루프 (Codex CLI — codex-plugin-cc)
Codex CLI를 통해 GPT 교차 검증 수행. 모델 라우팅: code-verifier →
/codex:review --model gpt-5.3-codex, plan-verifier → /codex:rescue --model gpt-5.4. 기본 1라운드, critical issue 시 최대 3라운드. 응답: accept / accept with notes / revise. 호출 실패 시 사용자에게 알리고 대기 (자동 fallback 금지).3
교차 검증 문서 규칙 & 실시간 상태 표시
Claude가 모든 파일 I/O 전담 (Codex sandbox는 로컬 파일 읽기 불가). 요청/응답 파일 작성 후 내용을 프롬프트 인라인으로 전달. 템플릿 양식 필수. 저장 위치: reports/<project>/<work>/YYYY-MM-DD_<session>/. GPT 응답 전 재질문 절대 금지. 각 단계(요청·처리중·수신)마다 상태 메시지 실시간 출력 필수.
4
응답 스타일
진행상황 보고는 progress-tracker를 통해 출력. 불필요한 요약 반복 금지. 작업 완료 후 다음 단계 항상 제시.
글로벌 CLAUDE.md + 프로젝트별 CLAUDE.md 2개 별도 운영
Hooks
▾PostToolUse — 3개 Hook
Write → 띄어쓰기 자동 수정
Matcher: Write
Type: command
동작: 연속 띄어쓰기(2개+) → 1개로 sed 자동 수정
대상: 모든 Write 파일
Write → LinkedIn 어투 검사
Matcher: Write
Type: prompt (LLM)
동작: 파일명에 'linkedin' 포함 시 어투 검사
기준: 학술적 어투 / 도치 금지 / 대화체 금지
ExitPlanMode → 교차 검증 자동 시작
Matcher: ExitPlanMode
Type: prompt (LLM)
동작: Plan 확정 → Codex CLI (/codex:rescue --model gpt-5.4)로 교차 검증 자동 실행
흐름: plan 읽기 → VR_request 작성 → plan-verifier → GPT-5.4 검증 (최대 3라운드) → VR_summary → 코드 작성 허용
🚫 교차 검증 완료 전 코드 작성 차단