macOS: 유니버설 dmg (Intel/Apple Silicon)
네 서피스를 한 문서로 결합했다. 항목 664개 전부 — core만 추리는 A3 치트시트와 달리 세부까지 들어간다. 생성 2026-08-20 · 3ac0537
데스크톱 앱의 Code 탭. 브라우저 pane·diff 리뷰·워크스페이스. · 섹션 33개 · 항목 157개
데스크톱 앱은 CLI 와 설정 공유, 조작 체계는 별개. 같은 기능도 이름이 다를 수 있음.
macOS: 유니버설 dmg (Intel/Apple Silicon)
Windows: x64 설치 / ARM64는 별도 설치파일
Linux(베타): apt 또는 .deb
Code
설치 후 로그인 → 탭 클릭
설치 후 앱을 실행하고 Anthropic 계정으로 로그인한다. 세 탭 중 Code 탭을 클릭해서 소프트웨어 개발 기능을 사용한다. CLI와 세션과 설정을 공유한다.
Windows는 Git for Windows 필요 (설치 후 앱 재시작)
탭마다 다루는 대상이 별개. 현재 탭 위치가 사용 가능 기능을 결정.
Chat
일반 대화
일반적인 텍스트 대화를 위한 탭. 코드 작성 없이 아이디어를 브레인스토밍하거나 설명을 요청할 때 사용한다.
Cowork
Dispatch·장기 에이전틱 작업
장기 실행 작업과 에이전트 협업을 위한 탭. 백그라운드 작업을 관리하고 여러 에이전트가 같은 작업에 협력할 수 있다.
Code
소프트웨어 개발 (이 치트시트 범위)
소프트웨어 개발을 위한 전용 탭. 파일 읽기·쓰기, 명령 실행, Git 작업 등 개발에 필요한 모든 기능이 여기에 있다. 이 치트시트는 주로 이 탭을 기준으로 작성되었다.
세션 시작 위치가 접근 가능한 파일 범위 결정.
Environment
Local/Cloud/SSH/WSL(Win) 선택
Project folder
작업할 폴더·저장소 선택
Model
전송 버튼 옆 드롭다운(세션 중 변경 가능)
Permission mode
모드 선택기(세션 중 변경 가능)
CLI 와 같은 개념, UI 라벨 표기만 차이. API 식별자 대조 필요 시 CLI 시트 참고.
Manual (default)
편집·명령 전 항상 확인
Accept edits
파일편집+기본 명령 자동승인
Plan
탐색만, 편집 전 계획 제시
Auto
백그라운드 안전검사로 대부분 자동
Bypass permissions
프롬프트 없음, 격리 환경 전용
Bypass: Pro/Max는 설정→Claude Code 토글, Team/Enterprise는 조직 정책. dontAsk 모드는 CLI 전용
입력창에서 바로 쓸 수 있는 참조·첨부 문법.
Enter 전송, 진행 중 정정 메시지 입력 시 중단 없이 다음 단계에 반영
정지 버튼: 즉시 중단
@파일명: 컨텍스트 추가 (로컬·SSH만, 클라우드·WSL 불가)
첨부: 이미지·PDF 드래그앤드롭
+
버튼: 파일첨부/스킬/커넥터/플러그인
데스크톱에서 쓸 수 있는 슬래시 명령. 터미널 전용 대화형 명령은 여기서 동작 불가.
/
/ 입력 또는 +→Slash commands 로 탐색 (내장 명령어 + 커스텀·프로젝트·플러그인 스킬)
/clear, /compact, /context
새 대화 시작/요약/컨텍스트 확인
/rewind, /diff
체크포인트 롤백 / diff 뷰어
/model, /effort, /plan
모델·추론강도 변경 / 계획 모드
/rename, /branch, /export
이름변경/대화분기/내보내기
/code-review, /security-review
diff 검토 / 보안 취약점 검사
/background, /tasks, /fork
백그라운드 분리/작업목록/복사
/loop, /goal, /recap, /insights
반복실행/목표설정/요약/분석
/btw
사이드 채팅 열기
/desktop
(터미널에서) 세션을 데스크톱으로 이동
/ide, /mcp, /doctor, /usage
IDE·MCP 관리/진단/사용량
/permissions 등 터미널 전용 대화형 명령어는 "isn't available in this environment" 응답. /config 는 인자 무시하고 설정 화면만 열림
앱 안에서 로컬 서버를 띄워 결과 바로 확인. 코드 수정과 화면 확인의 왕복 단축.
수정 후 자동으로 dev 서버 실행·검증(스크린샷/DOM검사/클릭/폼입력)
서버 드롭다운에서 시작/중지
Persist sessions
: 재시작해도 쿠키·로컬스토리지 유지
HTML/PDF/이미지/영상 경로 클릭 시 Browser pane에서 열림
외부 사이트를 여는 경로. 문서에서 본 내용을 그대로 지시로 받아들이지 않도록 주의.
Cmd/Ctrl+Shift+B 로 Browser pane 열기
첫 접근 시 승인 카드(Allow once/Always allow/Deny), 서브도메인별 개별 승인
로그인 상태 공유 필요하면 Claude in Chrome 확장 사용 (Browser pane은 별도 프로필)
조직 차원 allow/blocklist 및 외부 탐색 자체 차단 가능
변경을 시각적으로 훑고 그 자리에서 코멘트 작성.
변경 후 +12 -1 형태 diff stats 클릭 → diff 뷰어
줄 클릭해 댓글, Cmd/Ctrl+Enter 로 한번에 제출
Review code
버튼: 컴파일오류·명백한 버그·보안취약점 위주(스타일은 안 봄)
PR 상태를 앱 안에서 추적.
PR 생성 후 세션에 CI 상태 바 표시 (GitHub CLI gh 필요)
Auto-fix
: 실패한 체크 자동 수정 시도
Auto-merge
: 모든 체크 통과 시 squash 병합(GitHub에서 auto-merge 먼저 활성화 필요)
완료 시 데스크톱 알림
여러 세션·패널을 동시에 두는 배치.
패널: chat·diff·browser·terminal·file·plan·tasks·subagent (+macOS는 iOS 시뮬레이터)
헤더 드래그로 위치 변경, 가장자리 드래그로 크기 조절
Views
메뉴에서 패널 추가
Cmd/Ctrl+\ 포커스된 패널 닫기
앱 안의 터미널과 편집기. 별도 창을 오갈 필요 감소.
통합 터미널 Ctrl+`: 세션과 동일한 작업 디렉토리·환경 공유 (로컬 세션 전용)
파일 클릭 → 파일 패널에서 바로 편집·저장
파일 우클릭: 컨텍스트로 첨부/다른 앱에서 열기/탐색기 표시/경로 복사
무엇을 크게 볼지 고르는 축.
Normal
도구 호출 요약 + 전체 텍스트 응답
Verbose
모든 도구 호출·중간 단계 표시
Summary
최종 응답과 변경사항만
Ctrl+O 로 순환 전환
데스크톱 전용 단축키. 터미널 CLI 와 같은 키라도 동작이 다를 수 있음.
Cmd/Ctrl + /
단축키 목록 표시
Cmd/Ctrl + N
새 세션
Cmd/Ctrl + W
세션 닫기
Ctrl+Tab / Shift+Tab
다음/이전 세션
Esc
응답 중단
Cmd/Ctrl + Shift + D
diff 패널 토글
Cmd/Ctrl + Shift + B
Browser 패널 토글
Cmd/Ctrl + Shift + S
Browser 요소 선택
Ctrl + `
터미널 패널 토글
Cmd/Ctrl + \
포커스 패널 닫기
Cmd/Ctrl + ;
사이드 챗 열기
Ctrl + O
뷰 모드 순환
Cmd/Ctrl + Shift + M
권한 모드 메뉴
Cmd/Ctrl + Shift + I
모델 메뉴
Cmd/Ctrl + Shift + E
effort 메뉴
1–9
열린 메뉴에서 항목 선택
Code 탭 전용 — 터미널 CLI의 Shift+Tab 등과는 다름
사용량과 한도를 앱 안에서 확인.
모델 선택기 옆 사용량 링 클릭 → 컨텍스트 사용량(세션별) + 플랜 사용량(전체 서피스 공유)
실제 데스크톱 조작. 샌드박스 안의 Bash 와는 신뢰 경계가 별개.
화면·앱 직접 조작 (CLI 없는 GUI 자동화용)
macOS·Windows Pro/Max 리서치 프리뷰, Team/Enterprise 불가
기본 꺼짐: 설정→General→Computer use 토글, macOS는 손쉬운 사용+화면 기록 권한 추가 필요
View only(브라우저 등) / Click only(터미널·IDE) / Full control(그 외) 3단계
세션당 1회 승인 (Dispatch 세션은 30분마다 재승인)
실제 데스크톱을 조작 — 샌드박스 Bash와는 다른 신뢰 경계
세션 목록·이름·재개. 이름을 붙여두면 며칠 뒤 찾기가 훨씬 수월.
Cmd/Ctrl+N 새 세션, 여러 세션 병렬 실행
Git worktree
Git 저장소는 세션마다 자동 로 격리(.claude/worktrees/)
Cmd/Ctrl 누르고 사이드바 클릭 → 2개 세션 분할 보기
완료 후 보관 아이콘, PR 병합 시 자동 보관(Auto-archive) 설정 가능
본 작업 흐름을 끊지 않고 옆에서 질문.
Cmd/Ctrl+; 또는 /btw 로 열기 — 메인 세션 컨텍스트는 읽지만 기록엔 안 남음, 앱 종료 시 사라짐 (로컬·SSH·WSL만)
오래 걸리는 작업을 떼어내고 다른 일 병행.
Tasks 패널: 서브에이전트·백그라운드 셸·동적 워크플로우 진행상황
"다른 세션이 뭐 했어?" 같은 자연어로 다른 Code 세션 확인·메시지·이름변경·보관 요청
최근 20개 세션까지, 클라우드 세션은 제외
실행을 웹으로 올려 기기를 닫아도 계속 진행.
Environment에서 Cloud 선택 → 앱 종료해도 계속 실행, claude.ai/code·모바일 앱에서 확인
여러 저장소 동시 추가 가능
Continue in
메뉴: 웹 세션으로 전송 또는 IDE로 열기
여러 작업을 한 번에 흩뿌려 돌리는 탭.
휴대폰에서 작업 지시 → 개발 작업이면 자동으로 Code 세션 생성 (Dispatch 배지 표시)
완료·승인 필요 시 폰으로 푸시 알림
Pro/Max 전용, Team/Enterprise 불가
외부 서비스를 UI 에서 바로 연결. MCP 직접 설정 전에 여기부터 확인.
+
버튼 → Connectors: Google Calendar/Slack/GitHub/Linear/Notion 등 (로컬·SSH만, 클라우드·WSL 불가)
설정→Connectors 에서 관리·연결 해제
앱에서 스킬·플러그인 관리. CLI 와 같은 파일 체계 사용.
+
/ 입력 또는 →Slash commands 로 내장 명령어·커스텀 스킬·플러그인 스킬 탐색
+
→Plugins: 설치된 플러그인 확인, "Add plugin"으로 마켓플레이스 설치
플러그인은 클라우드·WSL 세션에서는 사용 불가
미리보기로 띄울 서버를 프로젝트에 정의.
name / runtimeExecutable
식별자 / 실행 명령
runtimeArgs / args
명령 인자
서버 포트
cwd / env
작업 디렉토리 / 환경변수
autoPort
포트 충돌 시 자동 재할당 여부
program / url
node 스크립트 직접 실행 / 접속 주소
autoVerify: 기본 켜짐(수정마다 자동 검증), false로 끌 수 있음
로컬·클라우드·자체 호스팅 중 실행 위치가 접근 가능 자원 결정.
Local
내 컴퓨터에서 직접 실행
Cloud
Anthropic 관리 인프라, 앱 꺼도 계속 실행
SSH
원격 머신 연결 (Linux·macOS만)
WSL (Windows)
WSL2 배포판 안에서 실행
조직 정책이 개인 설정보다 우선.
관리 콘솔: Code 데스크톱 사용 여부, 웹 세션, Remote Control, Bypass 모드 비활성화 등 제어
Managed settings: disableAutoMode, sshHostAllowlist, managedMcpServers 등
macOS는 MDM(Jamf/Kandji), Windows는 그룹 정책/레지스트리로 배포·정책 관리
데이터가 어디까지 나가는지에 대한 규칙.
주요 허용 도메인: anthropic.com, claude.ai, claude.com, claude.app, *.claudeusercontent.com (HTTPS 443)
로컬 세션은 로컬 처리, 클라우드 세션은 Anthropic 관리 인프라에서 코드·대화 컨텍스트 처리
CLI 명령이 데스크톱에서 무엇에 해당하는지 대조표.
--model sonnet
모델 드롭다운
--resume, --continue
사이드바에서 세션 클릭
--permission-mode
모드 선택기
--dangerously-skip-permissions
Bypass permissions 모드
--add-dir
클라우드 세션의 + 버튼(저장소 추가)
--allowedTools/--disallowedTools
세션별 대응 없음(설정파일 규칙은 적용)
--verbose
Verbose 뷰 모드
--print, --output-format
미지원 (대화형 전용)
MAX_THINKING_TOKENS
로컬 환경변수 에디터
같은 일을 어디서 하는 게 나은지 판단하는 표.
CLI는 dontAsk 포함 전체 / 데스크톱은 4종+Bypass
CLI는 Bedrock 등 / 데스크톱은 기본 Anthropic API
CLI는 설정파일 / 데스크톱은 Connectors UI 또는 설정파일
CLI는 /plugin / 데스크톱은 플러그인 관리자 UI
CLI 불가 / 데스크톱은 이미지·PDF 지원
CLI는 --worktree / 데스크톱은 자동 worktree
CLI는 cron/CI / 데스크톱은 Scheduled tasks
Computer Use
CLI는 macOS /mcp 활성화 / 데스크톱은 앱 내장
CLI는 Computer Use로 구동 / 데스크톱은 전용 패널
Dispatch
CLI 없음 / 데스크톱은 사이드바 지원
CLI는 --print·Agent SDK / 데스크톱 미지원
터미널이 나은 상황과 앱이 나은 상황의 구분.
병렬 세션 관리, 패널 배치, 변경사항 시각적 검토 → 데스크톱
스크립팅, 자동화, 터미널 워크플로우 선호 → CLI
증상별 확인 순서.
403/인증 오류 → 로그아웃 후 재로그인, 유료 구독 확인
화면 멈춤/빈 화면 → 재시작, 업데이트 확인, 방화벽 CDN 허용 확인
"Failed to load session" → 폴더 존재 확인, Git LFS 설치 확인
Windows "Git is required" → Git for Windows 설치 후 재시작
MCP 서버 Windows 오류 → 설정 확인, 앱 재시작, 작업관리자에서 프로세스 확인
판정 근거가 되는 1차 출처.
공식 문서: code.claude.com/docs/en/desktop
Cowork: claude.com/product/cowork
Cowork: claude.com/product/cowork
iOS 시뮬레이터: /docs/en/desktop-ios-simulator
WSL 연동: /docs/en/desktop-wsl
다운로드: claude.com/download
연구자용 워크벤치. 노트북·커넥터·클러스터. · 섹션 31개 · 항목 192개
연구용 노트북 워크벤치. 로컬 우선이라 데이터가 내 컴퓨터에 보존.
Claude + 로컬 분석 환경을 결합한 데스크톱 앱. 자연어로 요청하면 Python/R/shell 코드를 샌드박스에서 작성·실행하고, 결과를 출처 기록이 포함된 버전 관리 아티팩트로 저장
데이터 분석과 연구 작업을 위한 전용 환경이다. Jupyter 노트북처럼 셀 단위로 코드를 실행하고 결과를 확인할 수 있지만, 자연어로 요청할 수 있는 것이 차별점이다.
파일은 내 컴퓨터에 유지, 코드는 샌드박스에서 실행
새 폴더·네트워크 호스트·원격 잡은 매번 승인 후 사용
백그라운드 가 주장과 실제 실행 기록을 대조
연구 도구 — 임상·진단 용도 아님. 리뷰어는 오류를 줄일 뿐 없애지 못하므로 결과는 반드시 직접 검증
설치 전에 확인할 것. Windows 는 WSL2 필요.
Pro/Max/Team/Enterprise (Free 불가)
macOS
13 이상 (Apple Silicon/Intel)
Linux
x64 glibc 배포판 (arm64·Alpine 불가)
약 5GB (런타임+기본 환경)
socat, bubblewrap 0.8.0+, 비특권 유저 네임스페이스
네이티브 Windows 빌드 없음 — WSL2 사용
설치 경로와 첫 실행.
macOS
claude.com/product/claude-science 에서 설치 파일 다운로드 → 더블클릭. 첫 실행 시 Python·R 기본 환경 구성(수 분) 후 브라우저 탭 자동 오픈
sudo apt-get install -y curl bubblewrap socat # Ubuntu/Deb
Linux 예시
# 샌드박스 의존성 (sudo 필요)
sudo apt-get install -y curl bubblewrap socat # Ubuntu/Debian
sudo dnf install -y curl bubblewrap socat # Fedora/RHEL
sudo pacman -S curl bubblewrap socat # Arch
bwrap --version # 0.8.0 이상 확인 (22.04는 불가, 24.04 OK)
curl -fsSL https://claude.ai/install-claude-science.sh | bash
claude-science serve
브라우저 탭에서 열리지만 로컬 앱 — 공개 URL 없음. API 키 불필요
Windows 에서는 WSL2 안에서 구동. WSL1 은 불가.
wsl --install -d Ubuntu-24.04
예시
# 관리자 PowerShell
wsl --install -d Ubuntu-24.04
wsl -l -v # 버전 2 확인
wsl --set-version Ubuntu-24.04 2 # 1이면 전환
# WSL 내부
sudo apt update && sudo apt install -y curl bubblewrap socat
curl -fsSL https://claude.ai/install-claude-science.sh | bash
. ~/.profile && claude-science --version
claude-science serve --port 8765 --no-browser
WSL2가 localhost 자동 포워딩 → 출력 URL을 Windows 브라우저에 붙여넣기
WSL 1 불가, Ubuntu 24.04 이상 필요. wsl --shutdown 시 앱도 종료
이 제품 고유의 용어들. 다른 Claude 제품과 이름이 겹쳐도 뜻은 다를 수 있음.
Project
관련 세션·산출물 묶음. custom instructions와 폴더 권한이 세션 간 유지
Session
프로젝트 내 대화 스레드 1개. 자체 kernel·workspace 보유
Artifact
Claude가 저장한 파일. Files view에 표시, 영구 보존
Workspace
아티팩트 저장 전 코드가 읽고 쓰는 세션별 폴더
Kernel
변수를 메모리에 유지하는 살아있는 Python·R 프로세스
Environment
conda 기반 명명된 패키지 세트, 세션 간 재사용
Version
아티팩트의 불변 저장본 — 덮어쓰지 않고 위에 쌓임
Execution log
해당 아티팩트 버전을 만든 노트북 셀 구간
Data directory
~/.claude-science — DB·아티팩트·워크스페이스·로그
노트북 조작과 컴포저 단축키.
@
아티팩트·업로드 파일 삽입
#
과거 세션 삽입
/
스킬 삽입 (스킬 피커)
Cmd/Ctrl+K
검색 (프로젝트 설명까지 매칭)
Files
사이드바 = 프로젝트 전체 아티팩트 그리드 (업로드는 Your uploads)
Open / Open beside session / View in context / Provenance / Versions / Copy link / Star / Rename / Download / Delete
Settings
Permissions · Memory · Specialists · Connectors · Skills · Network · Compute · Credentials · Storage · Usage
실행 중인 커널의 메모리·CPU 확인 및 중지
셀·결과에 주석을 남기는 기능.
영역 선택 → Annotate pill 클릭 → 코멘트 입력 → Cmd/Ctrl+Enter 또는 Save
N comments
저장만으로는 전송 안 됨 — 컴포저의 chip에 모였다가 다음 메시지와 함께 전송
가능: Markdown, plain text, LaTeX, code(텍스트 선택), PDF(페이지 단위), 이미지·figure(점 클릭), 렌더된 HTML, 세션 transcript
불가: 테이블 · 스레드/resolve 없음 · 1,000자 제한
패키지를 어떻게 설치하고 어디에 격리되는지.
Python·R은 persistent kernel에서 실행, 변수 유지. 약 30분 idle·패키지 설치·세션 종료 시 재시작
Python: numpy, pandas, scipy, matplotlib, seaborn, pillow R: tidyverse, ggplot2, jsonlite
micromamba
(conda-forge, bioconda, defaults, pytorch) · pip/PyPI · CRAN·Bioconductor
환경 설치 = 영구 / 셀 내 인라인 pip install·install.packages() = 커널 재시작까지만
Task environment(예: single-cell, structural-biology)는 필요 시 생성, 머신 전체 공유. 목록·삭제는 Claude에게 요청
GPU는 — Settings > Compute에서 활성화(샌드박스 강도 낮아짐)
apt·sudo·root 없음 — 패키지가 없으면 conda-forge 컴파일러로 소스 빌드
산출물과 그 출처 추적. 무엇이 어떤 실행에서 나왔는지 기록.
아티팩트는 , 그 외 세션 파일은 종료 몇 시간 후 삭제
같은 파일명 재저장 = 새 버전. 열면 version stepper + diff 토글
과거 버전은 읽기 전용(복원하려면 다시 저장 요청), 대화 속 링크는 을 가리킴
인라인 편집 가능: Markdown, code, plain text (Edit content → Save = 새 버전) 불가: 이미지, PDF, HTML, 테이블
Messages
· Code(스크립트·노트북 다운로드) · Execution Log · Environment(환경명·언어·패키지 버전) · Review
Execution Log가 실행의 권위 있는 기록 — Code 탭과 불일치하면 로그를 신뢰. ~/.claude-science 내부 파일 직접 이동·삭제 금지
결과를 검토하는 기능.
응답·승인된 plan·아티팩트·실행 기록을 독립적으로 재독해 주장과 실제 실행을 대조 (재실행은 하지 않음)
실행 없이 계산했다고 보고한 결과
응답 값과 원본 파일 불일치
인용이 주장을 뒷받침하지 않음 /
미완료 plan 단계 · 방법론상 뒷받침 안 되는 결론
응답 후 자동 실행 + Request review 수동 트리거. 결과는 Reviewer · N findings 카드(claim·evidence·transcript 링크)
기본값: Max/Team/Enterprise ON, Pro OFF. 커스텀 기준은 Settings > Specialists > Reviewer > Instructions(추가만 가능, 내장 체크 제거 불가)
터미널에서 쓰는 서브커맨드.
serve
실행 + 1회용 로그인 링크 열기
open
새 로그인 링크 발급 후 브라우저 열기
url
새 로그인 링크만 출력 (SSH용)
status
실행 여부·버전·포트 JSON 출력
logs [--tail]
로그 출력 / 실시간 추적
stop
정상 종료
update [--check]
업데이트 (--to <ver>로 롤백)
import <path>
다른 데이터 디렉터리 병합
--version
버전 출력
전역: --data-dir <dir>(기본 ~/.claude-science), --config <file>
import는 미리보기·되돌리기 없음 — 사전 백업 필수
serve 실행 시 정하는 값들. 네트워크 노출 범위를 여기서 결정.
--port <n>
기본 8000 (0=자동 할당)
--no-browser
브라우저 자동 오픈 안 함
--detached
백그라운드 실행
--no-auto-update
자동 업데이트 끄기
--host <addr>
기본 127.0.0.1 (변경 시 네트워크 노출)
--base-path </prefix>
리버스 프록시용
--allow-origin <url>
허용 오리진 (반복 지정)
--sandbox-port <n>
기본 port+1, HTML 미리보기용
--verbose
상세 로그
--dangerously-no-sandbox(홈 전체 접근+무제한 네트워크) · --dangerously-skip-approvals(모든 승인 자동)
원격 리눅스 서버에 SSH 터널로 연결.
ssh -L 8000:localhost:8000 \
예시
# ① 내 컴퓨터에서 먼저 터널 (링크 3분 만료)
ssh -L 8000:localhost:8000 \
-L 8001:localhost:8001 you@server.example.com
# ② 서버에서
claude-science serve --no-browser
claude-science url # 링크 재발급
리다이렉트 실패 시 로그인 화면의 Paste a code 사용
미리보기 포트(8001)를 안 열면 인터랙티브 차트가 정적 스냅샷으로 표시
기본으로 켜져 있는 읽기 전용 커넥터들. 대부분 공개 연구 DB.
계정·키 불필요, 승인 카드 없이 실행. Settings > Connectors에서 개별 OFF
Genomes
Ensembl(VEP), UCSC
Genes & Ontologies
MyGene, UniProt, GO, Reactome, OLS
Variants
gnomAD, ClinVar, dbSNP
Human Genetics
GWAS Catalog, eQTL Catalogue, FinnGen, BioBank Japan
Clinical Genomics
ClinGen, CIViC, Open Targets
Expression
GTEx
Regulation
ENCODE, JASPAR, UniBind
Protein Annotation
InterPro, Pfam, Human Protein Atlas, STRING
Structures
PDB, AlphaFold, EMDB, Complex Portal, IntAct
RNA
Rfam
Omics Archives
GEO, ArrayExpress, PRIDE, MGnify, MetaboLights
Cancer Models
cBioPortal
Chemistry
PubChem, ChEBI, Rhea, BindingDB
Drug Regulatory
FDA drug data, openFDA
Literature Graph
OpenAlex, arXiv
Research Resources
Grants.gov, Antibody Registry
추가: BioMart, CellGuide(CELLxGENE), ZINC, Ketcher(2D 분자 스케처)
일부 DB는 비상업/출처표기 라이선스 — 사용 전 확인
다른 Claude 제품과 공용으로 쓰는 커넥터.
claude.com/connectors 기반 4종: PubMed, Clinical Trials, ChEMBL, bioRxiv
Team/Enterprise는 관리자가 추가해야 표시됨
기본 제공 스킬.
Settings > Skills
Settings > Skills · 자동 로드, 컴포저에 / 입력해 직접 선택 가능
literature review, indication dossier
AlphaFold2, Boltz-2, Chai-1, ESMFold2, OpenFold3
ProteinMPNN (Ligand/Soluble 포함)
DiffDock
ESM-2
Evo 2, Borzoi
scGPT, scvi-tools
직접 만드는 스킬.
Add skill
버튼 → 4가지 방식
Chat with Claude
대화로 생성
Write from scratch
직접 작성
Upload a skill
파일 업로드
Import from GitHub
private repo 가능(Settings > Credentials에 GitHub 토큰 추가 후)
기존 세션의 워크플로를 스킬로 증류(distill)해 달라고 요청 가능
클러스터에 작업 제출.
Settings > Compute > SSH hosts > Add SSH host
Settings > Compute > SSH hosts > Add SSH host
~/.ssh/config의 alias 선택 (주소·user·port·ProxyJump 자동 인식)
호스트 메모 입력 (partition, account code, module load 등) — 첫 작업 전 Claude가 읽음
Advanced
에서 User/Port/Identity file 재정의 → Add
추가 시 read-only 프로브로 CPU/GPU/CUDA, conda·modules·Apptainer, scratch, sbatch 존재 여부 자동 탐지 (Probe로 재실행)
실행: 워크스테이션=detached 프로세스, SLURM=sbatch. 연결 끊겨도 잡 유지
기본 잡 타임아웃 30분, 동시 잡 100. 약 100MB 초과 출력은 호스트에 남고 경로만 기록
원격 잡은 샌드박스 밖 — 내 계정 권한 전체로 실행됨. 호스트엔 아무것도 설치하지 않음
외부 컴퓨트로 실행 위임. 과금이 붙는 경로.
Settings > Compute > Cloud providers
Settings > Compute > Cloud providers → Modal Connect
예시
modal token new # CLI 로그인 → ~/.modal.toml 자동 인식
또는 Settings > Credentials > Modal에 Token ID + secret 붙여넣기(암호화 저장, Claude에 미노출)
승인 카드에 머신 스펙(H100 등)·초당 과금·최대 청구 시간 표시
입력 1 GiB/submit 제한 (초과 시 Modal Volume 마운트), 출력 ./out/ 최대 5 GiB
동시 잡 기본 10, 컨테이너 타임아웃 기본 12시간(최대 23)
지출 상한 없음 · 과금은 Modal이 직접 청구 · 앱 종료해도 잡은 계속 과금
HTTP 모델 엔드포인트 연결.
Settings > Compute > Model endpoints
Settings > Compute > Model endpoints → NVIDIA BioNeMo NIM Connect
BioNeMo Agent Toolkit 스킬 import + NVIDIA NGC API 자격증명 → NVIDIA 호스팅 API 또는 로컬 Docker NIM 컨테이너 선택
S3·GCS·Azure 버킷 연결.
Settings > Credentials
Settings > Credentials → AWS / Google Cloud / Microsoft Azure
access key, service-account JSON, HMAC key, connection string 등 + 버킷명(또는 Azure Blob containers) 나열
버킷 등록 = 샌드박스 네트워크 허용목록 추가 (호출별 승인 카드 없음)
코드에서 boto3, Azure SDK로 접근. Settings > Storage에서 탐색·임포트(최대 100GB)
GCS는 HMAC key + boto3 또는 import/export만 가능 — gsutil·gcloud storage·google-cloud-storage는 path-style이라 차단됨
문헌 DB 접근. 기관 구독 필요 여부로 구분.
Settings > Credentials > Services > Literature access
Settings > Credentials > Services > Literature access (claude.ai 계정 설정과 별개)
오픈액세스(Unpaywall·Semantic Scholar·PMC) → CrossRef 링크 → 보유 키 출판사 → 라이브러리 프록시 → 출판사 페이지
Elsevier API key
+ institutional token (구독 필요)
Springer Nature key
Springer 경로 활성
Semantic Scholar key
해당 단계 가속
NCBI API key
PubMed 3→10 req/s
CORE API key
오픈액세스 aggregator
도서관 경유 재시도
OpenAlex API key
매 요청 필수 (무료 발급)
어떤 키도 페이월을 우회하지 않음. Unpaywall 단계는 Settings > General > Contact email 공유해야 작동
직접 만든 MCP 커넥터 연결.
Settings > Connectors > Add connector
Settings > Connectors > Add connector → Remote(HTTPS) 또는 Local command. Name은 소문자·숫자·하이픈만
Remote
: 서버 URL + Advanced(transport SSE/Streamable HTTP, OAuth, Headers helper)
Local command
: 실행 명령 + Advanced(인자, 환경변수)
Ask each time
툴 기본값 → Tools 탭에서 Always allow/Block
Local 커넥터 환경변수는 암호화 없이 설정 파일 저장 — 고가치 시크릿 금지. Skip approvals는 신뢰하는 개발자만
승인 카드의 범위. 한 번·세션·프로젝트 단위로 구분.
폴더 접근·코드 실행·원격 잡·커넥터 툴마다 카드 표시
Once
이번 한 번만
This conversation
현재 세션 동안
This project
이 프로젝트 전체
Global
모든 프로젝트
설정 파일. 앱 설정보다 우선.
~/.claude-science/config.toml
~/.claude-science/config.toml — 시작 시 1회 읽음, 변경은 재시작 후 적용
[network]
예시
[network]
proxy = "http://proxy.example.corp:8080"
no_proxy = ".example.corp,registry.example.corp"
ca_bundle = "/etc/claude-science/corporate-ca.pem"
mcp_x509_strict = "auto" # relaxed | strict
[conda]
channel_mirror = "https://..." # 내부 미러
pip_index_url = "https://..."
allow_insecure_mirror = false
[sandbox.network]
enabled = true
allowed_domains = ["*.example.org"]
denied_domains = [] # 거부 우선
미러 값이 잘못되면 앱이 시작되지 않음. 파일 값이 Settings보다 우선(“조직 관리” 표시)
환경 변수로 넘기는 값들.
DO_NOT_TRACK
텔레메트리 끄기(값 무관)
GITHUB_TOKEN
api.github.com 레이트리밋 완화
HTTPS_PROXY / HTTP_PROXY
프록시 (설정파일보다 우선)
NO_PROXY / ALL_PROXY
NO_PROXY는 설정 키와 병합
데이터가 어디에 남고 어디로 나가는지.
대화·산출물은 저장 (~/.claude-science) — Anthropic 측 세션 저장소 없음
Anthropic이 받는 것: + 제품 사용 텔레메트리(대화 내용 아님, 끌 수 있음)
원격 컴퓨트 트래픽은 Anthropic 경유하지 않음
Directory 커넥터는 Anthropic 호스팅 경유, 로컬 커넥터는 직접 통신
폴더 삭제 = 모든 프로젝트·아티팩트·대화 영구 삭제. Custom Data Retention·Compliance API는 로컬 데이터에 미적용 → MDM/EDR로 관리
플랜별로 쓸 수 있는 범위 상이.
Free
사용 불가
Pro / Max
기본 켜짐
Team / Enterprise
기본 꺼짐 — Owner가 활성화
Organization settings > Claude Science > Enable for your organization → 마법사 → Enable
Owner/Primary Owner만 가능(Admin 불가). HIPAA 조직도 기본 꺼짐이며 켜도 BAA 미적용·PHI 사용 금지
베타라서 아직 안 되는 것들. 기대치 조정용.
감사 로그 미기록, Compliance API 내보내기/삭제 불가
조직 데이터 내보내기 제외, Custom Data Retention 무효
커넥터·도메인·스킬 허용목록이
관리자가 원격 컴퓨트 연결을 제한할 수 없음
오프보딩 시 로컬 데이터 미삭제 · 네이티브 Windows 빌드 없음
방화벽에서 열어야 하는 도메인 목록.
claude.ai
claude.ai, platform.claude.com, api.anthropic.com
*.mcp.claude.com
*.mcp.claude.com(커넥터), storage.googleapis.com(자동 업데이트), api.github.com·codeload.github.com(스킬)
api.unpaywall.org, doi.org, eutils.ncbi.nlm.nih.gov, api.semanticscholar.org, api.crossref.org, api.openalex.org, api.elsevier.com, api.springernature.com
pypi.org, files.pythonhosted.org, conda.anaconda.org, repo.anaconda.com, cran.r-project.org, bioconductor.org, registry.npmjs.org, github.com, *.githubusercontent.com
익명 파일 업로드·웹훅·리버스 터널·path-style 오브젝트 스토리지(s3.amazonaws.com 등) → 버킷은 <bucket>.s3.<region>.amazonaws.com 호스트명 형식으로 사용
미러 트래픽은 프록시를 거치지 않고 직접 연결 — 프록시 허용목록만으로는 환경 빌드가 안 되고 로그에도 안 남음
판정 근거가 되는 1차 출처.
공식 문서: claude.com/docs/claude-science/overview
시작 가이드: /docs/claude-science/get-started
커넥터·스킬: /docs/claude-science/connectors-and-skills
CLI 설정: /docs/claude-science/command-line-settings
다운로드: claude.com/product/claude-science
터미널에서 쓰는 본체. 설치·플래그·권한·훅·자동화. · 섹션 37개 · 항목 195개
네이티브 설치가 권장 경로. npm 설치는 새로 깔 때 비권장 레거시. 문제 발생 시 추측 전에 claude doctor 먼저.
curl -fsSL https://claude.ai/install.sh | bash
예시
# macOS/Linux/WSL
curl -fsSL https://claude.ai/install.sh | bash
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
# Homebrew / WinGet
brew install --cask claude-code
winget install Anthropic.ClaudeCode
claude auth login
로그인
claude auth status
인증 상태 확인
claude auth logout
로그아웃
claude doctor
설정 진단·문제 해결
설치·인증·경로·권한 설정을 한 번에 점검한다. 문제 발생 시 추측 전에 이 명령을 먼저 돌리는 게 시간을 절약한다. 출력을 복사해서 지원 요청에 쓸 수도 있다.
점검 항목: 설치 버전, 인증 상태, PATH 설정, 파일 권한, 프로젝트 구성, 훅/스킬 상태.
터미널에서 치는 진입점. 대부분은 claude 하나로 시작하고, 나머지는 이어가기(-c/-r)와 관리 명령.
claude
대화형 세션 시작
인터랙티브 셸을 시작한다. 프롬프트를 입력하고 응답을 받으면서 대화를 계속할 수 있다. 세션은 자동으로 저장되고 /resume 로 다시 불러올 수 있다.
claude "query"
프롬프트와 함께 시작
첫 프롬프트를 한 줄로 입력해서 세션을 시작한다. 대화형 셸에 들어가지 않고 바로 답을 얻고 싶을 때 유용하다.
claude -p "query"
프린트 모드: 실행 후 종료
한 번만 실행하고 종료한다. 인터랙티브 세션을 남기지 않고 CI/CD 파이프라인이나 스크립트에서 쓰기 좋다.
cat f | claude -p "q"
파이프 콘텐츠 처리
claude -c / --continue
최근 대화 이어가기
claude -r "<s>" "query"
세션 ID·이름으로 재개
claude -n <name>
세션 표시 이름 지정
claude --from-pr <PR>
PR 연결 세션 재개
claude update
최신 버전 업데이트
claude install [version]
네이티브 바이너리 설치
claude setup-token
장기 OAuth 토큰 생성
claude mcp
MCP 서버 구성
세션 시작 시 한 번 정하는 값들. 세션 안에서 바꿀 수 있는 것은 같은 이름의 슬래시 명령으로도 존재(--model ↔ /model).
--model
세션 모델 지정
--effort
추론 강도 설정
--add-dir
파일 접근용 작업 디렉토리 추가
--allowedTools
확인 없이 도구 허용
--disallowedTools
특정 도구 금지
--output-format
출력 형식 지정
--input-format
입력 형식 지정
--max-turns
에이전트 턴 수 제한
--verbose
상세 로그 활성화
--continue / --resume
세션 이어가기 / 재개
--from-pr
PR 연결 세션 재개
--fork-session
세션을 복사해 분기 후 재개
--dangerously-skip-permissions
모든 권한 확인 생략
세션 안에서 치는 명령. 대화 흐름을 끊지 않고 상태를 바꾸거나 확인할 때 사용.
/help
도움말 표시
사용 가능한 슬래시 명령어 전체 목록과 간단한 설명을 보여준다. 명령어 이름을 까먹었을 때 빠르게 찾을 수 있다.
/init
코드베이스 분석해 CLAUDE.md 생성/개선
이미 CLAUDE.md 가 있으면 덮어쓰지 않고 개선을 제안한다. CLAUDE_CODE_NEW_INIT=1 을 설정하면 스킬·훅까지 묻는 대화형 흐름이 되고, 다른 코딩 에이전트의 설정을 발견하면 /import 로 옮기길 제안한다.
/exit
CLI 종료(별칭 /quit · 백그라운드는 분리)
/clear [name]
새 대화 시작
대화 요약, 컨텍스트 확보
지금까지의 대화를 요약해서 컨텍스트를 줄인다. 선택적으로 계속할 지시를 입력하면 요약된 상태에서 이어서 작업한다. 긴 대화가 느려졌을 때 유용하다.
/context [all]
컨텍스트 사용량 표시
현재 세션의 토큰 사용량과 비용을 보여준다. all 을 추가하면 세션 전체 사용량을, 없으면 마지막 응답만 보여준다. 느려졌을 때 원인을 파악하는 데 유용하다.
/config
설정 패널 열기
/status
세션 상태·진행 작업 표시
/doctor
설정 진단 및 문제 해결
/usage, /cost
토큰 사용량·비용 표시
/model [model]
세션 내 모델 변경
/effort [level|auto]
추론 강도 조정
/resume
다른 대화로 돌아가기
/rename [name]
현재 세션 이름 변경
/branch [name]
현재 지점에서 대화 분기
/export [filename]
대화를 텍스트로 내보내기
/diff
변경사항 대화형 뷰어
/ide
IDE 연동 관리·상태 표시
/mcp
MCP 서버 연결 관리
손이 기억하면 가장 빨라지는 것들. Shift+Tab(권한 모드)과 Esc(중단) 둘만 익혀도 체감 큼.
Ctrl+C
중단 (2회=종료)
Ctrl+D
Claude Code 종료
Ctrl+O
트랜스크립트 뷰어 토글
Ctrl+R
명령어 히스토리 역검색
Ctrl+T
작업(task) 목록 토글
Ctrl+B
실행 중 작업을 백그라운드로 (tmux는 2회)
Ctrl+X Ctrl+K
백그라운드 서브에이전트 전부 중단 (3초 내 2회)
Ctrl+S
프롬프트 보관 · 빈 입력에서 다시 누르면 복원
Ctrl+V / Alt+V
클립보드 이미지 붙여넣기
Ctrl+L
화면 다시 그리기 (풀스크린에서 2회=/clear)
Ctrl+Z
프로세스 일시 중지 (Unix, fg 로 복귀)
Ctrl+G
프롬프트/응답을 기본 편집기로 열기
readline 식 Ctrl+X Ctrl+E 도 같은 동작이다. /config 에서 Show last response in external editor 를 켜면 직전 응답이 # 주석으로 함께 열린다.
Esc
응답·도구 호출 중단, 대화상자 닫기
Esc Esc
초안 삭제, 비어있으면 되돌리기
Shift+Tab
권한 모드 순환 전환
Windows 에서 런타임이 VT 입력 모드를 못 켜면 Alt+M 이 같은 역할을 한다. 순환 순서는 Manual(default) → acceptEdits → plan → (가능하면) bypassPermissions → auto.
Alt+P / Option+P
모델 전환
Alt+T / Option+T
확장 사고 토글
Alt+O / Option+O
패스트 모드 토글
@
파일 경로 언급 자동완성
!
셸 모드 진입
컨텍스트를 따로 쓰는 별도 에이전트. 실질 이점은 전문성이 아니라 격리 — 넓게 훑어야 하는데 결론만 필요할 때 본 대화가 무거워지지 않음.
Task 도구로 호출: subagent_type=이름 · .claude/agents/*.md frontmatter(name/description/tools/model)로 정의 · --agent/--agents 플래그로도 지정 가능
실질 이점은 전문성이 아니라 컨텍스트 격리다. 탐색으로 파일 50개를 훑어야 하는데 그 내용이 본 대화에 다 쌓이면 이후 작업이 계속 무거워진다. 서브에이전트에 맡기면 결론만 돌아온다.
쓸 자리는 셋이다 — 넓게 훑고 결론만 필요할 때, 같은 일을 여러 관점으로 각각 돌릴 때, 실패해도 본 대화가 안 다쳐야 할 때. 반대로 맥락이 계속 이어져야 하는 작업은 쪼개면 오히려 나빠진다.
결과는 요약이라 근거가 잘려 있다. 중요한 판정은 파일 경로와 재현 명령을 같이 요구하고, 받은 뒤 직접 확인할 것.
frontend-developer
UI/컴포넌트/스타일링
backend-developer
서버, API, 아키텍처
api-developer
API 설계·문서화·통합
mobile-developer
iOS/Android 앱
python-developer
javascript-developer · typescript-developer
php-developer
wordpress-developer · ios-developer
database-designer
설계·최적화·모델링
code-reviewer
code-debugger · code-documenter
code-refactor
code-security-auditor
code-standards-enforcer
스타일/일관성
위 17종은 원본 프로젝트에서 온 개발직군 롤 템플릿이다 (legacy/subagents/)
이 목록은 이 리포가 갈라져 나온 원본(Njengah/claude-code-cheat-sheet)의 템플릿이고, wordpress-developer·php-developer 처럼 특정 직군에 묶인 것이 많다. 내 작업과 맞는지 확인된 바 없으므로 그대로 쓰기보다 필요한 것만 골라 다시 쓰는 편이 낫다.
원문은 legacy/subagents/*.md 에 그대로 남겨뒀다(MIT, 본문은 한국어). 쓸 만한 게 있으면 거기서 가져와 .claude/agents/ 에 두면 된다.
세션 도중 Shift+Tab 으로 순환 전환. 시작할 때 고정하려면 --permission-mode. 모드는 "무엇을 물어보는가"만 결정, "무엇을 할 수 있는가"는 allow/deny 규칙과 샌드박스가 별도 결정.
default (Manual)
읽기만 자동 승인. 쓰기·실행은 매번 물어본다.
가장 보수적인 값이다. Read/Glob/Grep 계열은 확인 없이 돌고 Edit/Write/Bash 는 호출마다 승인 카드가 뜬다.
카드에서 "이 명령은 다시 묻지 않기"를 고르면 그 패턴이 .claude/settings.local.json 의 permissions.allow 에 누적된다. 즉 default 로 며칠 쓰면 내 작업 패턴에 맞는 allow 목록이 저절로 만들어지고, 그 목록을 그대로 들고 상위 모드로 옮길 수 있다. 처음엔 default 로 며칠 → 쌓인 allow 확인 → 모드 상향이 실무 순서다.
claude --permission-mode default
누적된 allow 규칙은 .claude/settings.local.json 에 남고 여기엔 내 로컬 경로가 섞인다. 리포를 공개할 거면 이 파일이 .gitignore 에 있는지 먼저 볼 것.
→ 처음 깔았다, 무엇부터 해야 하나 · → 승인 창이 너무 자주 떠서 흐름이 끊긴다 · dontAsk · /permissions
acceptEdits
파일 편집·기본 파일시스템 명령을 자동 승인한다.
Edit/Write 와 mkdir·mv 같은 기본 파일시스템 명령이 확인 없이 돈다. 네트워크 호출이나 패키지 설치처럼 바깥에 영향을 주는 동작은 여전히 물어본다.
"코드를 계속 고치는 중이라 편집 승인만 귀찮다"는 상황에 정확히 맞는 값이다. auto 로 한 번에 올리는 것보다 여기서 멈추는 편이 통제 범위를 이해하기 쉽다.
plan
읽기 전용 탐색만 하고, 편집 전에 계획을 먼저 내놓는다.
탐색 단계에서 파일이 고쳐지는 사고를 구조적으로 막는다. 낯선 코드베이스를 파악할 때, 또는 "일단 어떻게 할 건지 보고 결정하겠다"일 때 쓴다.
Ctrl+G 로 계획 결과를 편집기에서 열 수 있다. 계획에 동의하면 모드를 내려서 실행한다.
auto
분류기가 위험도를 판정해 대부분의 도구 호출을 자동 승인한다.
분류기의 기준은 되돌릴 수 있는가다. rm -rf, force push, 프로덕션 배포, 시크릿이 나갈 수 있는 동작은 auto 에서도 카드가 뜬다.
2026-08-14 부터 Pro/Max/Team 의 신규 세션 기본값이 이 모드로 바뀐다. 기존 세션은 재개해도 이전 모드를 유지하므로, 어느 날 갑자기 승인 카드가 덜 뜨기 시작하면 이 전환을 먼저 의심할 것.
"대부분 자동 승인"이지 "전부"가 아니다. CI 처럼 사람이 없는 환경에서 쓰면 카드가 뜨는 순간 그 자리에서 사람을 기다리며 멈춘다. 무인 실행은 dontAsk 다.
→ 승인 창이 너무 자주 떠서 흐름이 끊긴다 · → CI나 스크립트에서 사람 없이 돌리고 싶다 · dontAsk · /sandbox
dontAsk
사전 승인된 도구만 실행하고 나머지는 그냥 실패시킨다. CI용.
auto 와의 차이가 핵심이다 — auto 는 판단이 안 서면 묻고 멈추지만, dontAsk 는 묻지 않고 실패한다. 무인 실행에서는 멈춤보다 실패가 낫다. 로그에 남고, 재시도할지 사람이 정할 수 있기 때문이다.
default 로 며칠 쓰며 쌓아둔 permissions.allow 목록이 여기서 그대로 재사용된다.
claude -p "커버리지 분석" --permission-mode dontAsk --max-turns 3
bypassPermissions
모든 검사를 생략한다. 격리 환경 전용.
--dangerously-skip-permissions 와 같은 자리다. 이름에 dangerously 가 들어간 이유가 있다 — 되돌릴 수 없는 동작이 확인 없이 지나간다.
쓸 만한 자리는 하나뿐이다: 버려도 되는 컨테이너 안. 로컬 작업 디렉터리에서 "귀찮아서" 켜는 용도가 아니다. 승인 창이 잦은 게 문제라면 allow 규칙을 쌓거나 샌드박스를 켜는 쪽이 맞다.
이 모드를 쓰기 전에 되돌릴 수 있는 상태인지 먼저 볼 것 — 커밋했는지, 브랜치를 팠는지. /rewind 는 Claude 가 추적하는 변경만 되돌린다.
→ 건드리면 안 되는 걸 건드릴까 봐 불안하다 · --allowedTools "Bash(git log:*)" \ · /sandbox
2026-08-14부터 Pro/Max/Team 신규 세션 기본값이 auto 모드로 전환
Hooks 는 Claude가 도구를 쓰는 시점에 개입, 플러그인은 명령·스킬·훅·MCP를 한 묶음으로 배포. 둘 다 "내 워크플로를 Claude 쪽에 심는" 장치.
Hooks
settings.json의 hooks.<Event>[] (PreToolUse/PostToolUse/SessionStart/Stop 등), /hooks로 확인
settings.json 의 hooks.<Event>[] 에 matcher 와 실행할 명령을 적는다. 주요 이벤트: PreToolUse(도구 호출 직전) · PostToolUse(성공 직후) · SessionStart · Stop(응답 종료).
차단은 PreToolUse 에서 exit code 2 로만 된다. stdout 이 Claude 에게 사유로 전달되므로 "왜 막혔는지"를 사람이 아니라 Claude 가 읽고 스스로 고친다. PostToolUse 는 이미 실행된 뒤라 차단이 아니라 뒷정리(포매터 등)용이다.
중요한 경계 하나 — 훅은 Claude 의 도구 호출에만 걸린다. 내가 터미널에서 직접 치는 git commit 은 막지 못한다. 그건 husky·lefthook 같은 git 훅의 몫이고, 둘은 층이 다르다.
// .claude/settings.json
{
"hooks": {
"PreToolUse": [{
"matcher": "Bash(git commit:*)",
"hooks": [{ "type": "command", "command": "npm test --silent" }]
}]
}
}
훅은 매 도구 호출마다 돈다. 전체 테스트를 PreToolUse 에 걸면 파일 하나 고칠 때마다 몇 분씩 멈춘다. matcher 를 좁히거나 빠른 검사만 걸 것. 설정에 썼는데 /hooks 목록에 안 보이면 JSON 문법 오류이거나 파일 위치가 틀린 것이다.
→ 커밋 전에 자동으로 뭔가 돌리고 싶다 · → 건드리면 안 되는 걸 건드릴까 봐 불안하다 · .claude/commands/*.md · 설명
.claude-plugin/plugin.json 매니페스트, claude plugin install <name>@<marketplace>, /plugin
플러그인은 슬래시 명령·스킬·훅·MCP 서버·에이전트를 한 묶음으로 배포하는 단위다. .claude-plugin/plugin.json 이 매니페스트이고, 마켓플레이스에서 설치하거나 로컬 디렉터리를 --plugin-dir 로 바로 물릴 수 있다.
직접 만들기 전에 순서를 지키면 헛수고를 줄인다 — 이미 있는 커넥터 → 마켓플레이스 플러그인 → 그래도 없으면 직접. /plugin 으로 마켓플레이스를 연다.
→ 같은 지시를 매번 치기 싫다 · → 외부 서비스나 내 도구를 붙이고 싶다 · Project · --mcp-config / --plugin-dir
프로젝트 규칙·빌드 명령·하지 말 것을 적어두는 자리. 이게 없으면 매 세션 같은 설명 반복.
로드 순서: managed policy → ~/.claude/CLAUDE.md → ./CLAUDE.md → CLAUDE.local.md
뒤에 오는 것이 앞을 덮는 게 아니라 전부 함께 로드된다. 그래서 층을 나눠 쓴다 — 전역(~/.claude/CLAUDE.md)에는 어느 프로젝트에서나 통하는 내 작업 방식, 프로젝트(./CLAUDE.md)에는 이 리포의 규칙, CLAUDE.local.md 에는 커밋하지 않을 개인 메모.
managed policy 는 조직이 배포하는 것이라 개인 설정으로 뒤집을 수 없다.
상위 디렉터리의 CLAUDE.md 는 시작 시 전부 로드되지만, 하위 디렉터리의 것은 그 디렉터리 파일을 읽을 때 비로소 로드된다.
CLAUDE.local.md 는 .gitignore 에 넣을 것. 로컬 경로나 개인 메모가 그대로 커밋된다.
@path/to/file
@path/to/file 로 다른 문서 import(최대 4단계)
CLAUDE.md 가 길어지면 @docs/architecture.md 처럼 쪼개 넣는다. 최대 4단계까지 중첩 import 된다.
쪼개는 기준은 "매 세션 필요한가"다. 항상 필요한 것만 CLAUDE.md 본문에 두고, 가끔 필요한 것은 별도 파일로 두었다가 그때만 @ 로 붙이는 편이 컨텍스트를 아낀다.
/memory
/memory 로 편집 · Auto Memory: 학습 내용을 스스로 기록
/memory 는 어느 CLAUDE.md 를 고칠지 고르는 편집기를 연다. Auto Memory 는 작업 중 알게 된 것을 Claude 가 스스로 기록하는 기능이다.
자동 메모리는 기본 켜짐 — /memory 안의 토글이나 autoMemoryEnabled 설정으로 끈다. 저장 위치는 ~/.claude/projects/<프로젝트>/memory/ 이고 git 저장소 단위라 같은 리포의 worktree 들이 하나를 공유한다(머신 로컬, 클라우드 미공유). 인덱스 MEMORY.md 는 매 세션 처음 200줄/25KB만 로드되므로 짧게 유지해야 한다.
실무 팁 — 탐색을 마친 직후가 가장 좋은 기록 시점이다. 그때 적어두지 않으면 다음 세션에서 같은 탐색을 처음부터 반복하게 된다.
권한을 넓히는 대신 피해 범위를 좁히는 층. 파일시스템과 나가는 네트워크를 제한. 네이티브 Windows 는 미지원.
/sandbox
/sandbox, settings.json의 sandbox.enabled / filesystem.* / network.allowedDomains
권한 모드가 "무엇을 물어보는가"를 정한다면, 샌드박스는 "물어보지 않고 실행돼도 어디까지 망가질 수 있는가" 를 정한다. 두 축이 독립이라 같이 쓸 때 의미가 있다 — allow 규칙을 넓히더라도 샌드박스가 반경을 잡아준다.
network.allowedDomains 가 특히 값을 한다. MCP 커넥터나 스크립트가 예상 밖의 곳으로 데이터를 보내는 경로를 도메인 화이트리스트로 막는다.
// .claude/settings.json
{
"sandbox": {
"enabled": true,
"network": { "allowedDomains": ["registry.npmjs.org", "github.com"] }
}
}
→ 건드리면 안 되는 걸 건드릴까 봐 불안하다 · bypassPermissions · sandbox.network.allowedDomains
macOS=Seatbelt, Linux/WSL2=bubblewrap
OS 기본 격리 기술을 그대로 쓴다 — macOS 는 Seatbelt, Linux/WSL2 는 bubblewrap. 별도 컨테이너 런타임을 깔지 않아도 되는 대신, 그 기술이 없는 플랫폼에서는 동작하지 않는다. Windows 에 구현이 없는 이유가 이것이다.
네이티브 Windows 미지원 — WSL2 필요
세션을 붙잡고 기다릴 필요가 없는 작업을 떼어내는 층. 떼어내는 방식은 셋, "지금 대화를 분리할 것인가 / 새로 띄울 것인가 / 기기를 옮길 것인가"로 구분.
백그라운드·클라우드 세션 명령 모음
--bg 는 처음부터 세션에 묶이지 않게 띄운다. claude agents 로 목록을 보고 attach 로 붙었다가 떼어낼 수 있다. 진행만 보려면 logs.
--cloud 는 실행 자체를 웹으로 올린다. 노트북을 닫아도 계속 돌고, 나중에 --teleport 로 로컬로 가져온다. 오래 걸리는 작업을 퇴근길에 걸어둘 때 쓰는 경로다.
claude --bg "작업 지시" # 백그라운드 실행
claude agents # 목록/대시보드
claude attach|logs|stop <id> # 연결/로그/중지
claude respawn <id> # 재시작
claude --cloud "작업" # 웹 세션 생성
claude --teleport # 웹 세션→로컬 이동
백그라운드 작업도 토큰을 쓴다. 여러 개를 걸어두면 사용량이 눈에 안 보이는 채로 늘어난다. 일회성 작업에는 --max-turns 를 걸고 /usage 로 주기적으로 확인할 것.
/background
/background(/bg), /tasks 로 세션 내 관리
이미 진행 중인 대화를 떼어낼 때 쓴다. --bg 가 "처음부터 백그라운드"라면 /background 는 "하던 걸 백그라운드로". /tasks 로 목록을, Ctrl+T 로 토글한다.
비슷해 보이지만 다른 것 — /fork 는 대화를 복사해 새 백그라운드 세션을 만든다. 원본을 남겨두고 다른 접근을 병렬로 시험할 때 이쪽이다.
→ 오래 걸리는 작업을 걸어두고 다른 걸 하고 싶다 · → 작업이 커서 하나의 대화로는 안 될 것 같다 · /fork · Ctrl+T
비교적 최근에 붙은 플래그들. 문제 발생 시 원인을 좁히는 --safe-mode·--bare 가 특히 실전에서 유용.
--permission-mode <mode>
시작 권한 모드 지정
--agent / --agents
세션 에이전트 지정/JSON 정의
--safe-mode
커스터마이제이션 전체 비활성화
--bare
훅·스킬·플러그인·MCP 생략
--settings <path|json>
설정 파일/인라인 JSON 지정
--autocompact <auto|tokens>
자동 컴팩트 기준 설정
과부하 시 폴백 모델
지출 상한 (프린트 모드)
--system-prompt[-file]
시스템 프롬프트 교체/추가
--mcp-config / --plugin-dir
MCP·플러그인 로컬 로드
되돌리기·검토·백그라운드처럼 상태를 크게 바꾸는 명령들. /rewind 는 커밋하지 않은 변경도 되돌림.
/rewind [turn#]
코드+대화 체크포인트 롤백
/agents
서브에이전트 관리
/sandbox
격리 환경에서 실행
/permissions
도구 권한 규칙 관리
/plan
계획 모드 진입
/code-review, /review
현재 diff·PR 검토
/security-review
diff 보안 취약점 검사
/background, /bg
세션을 백그라운드로 분리
/tasks
백그라운드 작업 목록
/fork
대화를 새 백그라운드 세션으로 복사
/loop
프롬프트 반복 실행
/goal
완료 조건 설정 후 자동 진행
/recap
세션 한 줄 요약
/insights
세션 사용 패턴 분석
작업 난이도에 맞춰 비용을 조절하는 축. 단순 반복에 최고 강도 불필요.
--model sonnet/opus/haiku/fable
별칭 전체: default, best, fable, sonnet, opus, haiku, sonnet[1m], opus[1m], opusplan
default 는 오버라이드 해제(계정 기본으로 복귀), best 는 조직에 Fable 5 가 있으면 Fable, 없으면 최신 Opus. [1m] 접미사는 100만 토큰 컨텍스트 창, opusplan 은 plan 모드에서 opus·실행에서 sonnet 을 쓰는 혼합 모드다.
--model claude-sonnet-5
특정 모델 버전 지정
--effort <level>
low, medium, high, xhigh, max — 기본 high, max 는 세션 한정
모델이 지원 안 하는 레벨을 주면 그 아래 최고 지원 레벨로 폴백한다. low~xhigh 는 대화형 세션에서 설정하면 세션 간 유지되고, max 는 CLAUDE_CODE_EFFORT_LEVEL 환경변수로 주지 않는 한 현재 세션에만 적용된다. (ultracode 는 effort 레벨이 아니라 워크플로 오케스트레이션 키워드다 — 2026-08-20 정정)
--advisor opus
어드바이저 모델 활성화
/model, /effort
세션 내 변경
실행한 디렉터리가 기본 작업 범위. 코드가 여러 곳에 흩어져 있으면 탐색 시작 전에 추가 필요.
--add-dir ../apps ../lib
추가 작업 디렉토리 등록
--add-dir /path/to/project
디렉토리 경로 유효성 확인
--add-dir ../fe ../be ../shared
여러 디렉토리 동시 접근
사람이 읽는 출력 대신 기계가 파싱할 출력을 받는 축. 자동화의 출발점.
--output-format json
JSON 출력 (스크립팅용)
사람이 읽는 출력 대신 파싱 가능한 출력을 받는다. 자동화의 출발점이고, jq 로 바로 필드를 꺼낼 수 있다. 세션 ID 를 여기서 뽑아 다음 호출로 이어 붙이는 패턴이 흔하다.
→ CI나 스크립트에서 사람 없이 돌리고 싶다 · SID=$(claude -p "start" --output-format json \
--output-format stream-json
실시간 처리용 스트림
한 번에 다 받지 않고 오는 대로 처리한다. 오래 걸리는 작업의 진행을 보여줘야 하거나, 출력이 커서 메모리에 다 올리기 곤란할 때 쓴다.
--input-format stream-json
프린트 모드 입력 형식
--json-schema '<schema>'
스키마 검증된 JSON 출력
스키마를 주면 모델이 그 형태를 지키도록 강제되고, 어긋나면 재시도한다. --output-format json 만으로는 필드 이름이 흔들릴 수 있어서 파싱 코드가 깨진다. 결과를 프로그램이 소비할 거면 이쪽이 맞다.
배치/1회성 처리
자주 만지는 키만 추렸다. 키보다 먼저 알아야 할 것은 파일 4층 구조와 우선순위다.
우선순위: managed → CLI 인자 → .claude/settings.local.json → .claude/settings.json → ~/.claude/settings.json
local 은 개인용(.gitignore 대상), project 는 팀 공유(커밋), user 는 내 전역. 같은 키가 겹치면 위 순서에서 앞선 층이 이긴다.
파일 첫 줄에 "$schema": "https://json.schemastore.org/claude-code-settings.json" 을 넣으면 에디터가 키 이름을 자동완성·검증해준다.
수명주기 훅도 이 파일의 hooks 키에 정의한다 — 상세는 「Hooks & 플러그인」 섹션.
permissions.defaultMode
세션 시작 권한 모드 (default/acceptEdits/plan/auto/dontAsk)
"auto" 값은 프로젝트·local 설정 파일에서는 무시된다 — auto 시작은 내장 기본값이나 user 설정으로만. 우선 규칙은 --permission-mode 플래그가 항상 이긴다.
permissions.allow / deny / ask
도구별 사전 승인·차단·확인 규칙
deny 는 모든 모드에서 막힌다 — bypassPermissions 에서도. allow 는 bypass 에선 무의미. 승인 창이 잦으면 /fewer-permission-prompts 가 이 규칙을 대신 만들어준다.
{ "permissions": { "allow": ["Bash(npm run lint)"], "deny": ["Read(./.env)"] } }
env
세션에 주입할 환경변수 묶음
자주 쓰는 값 — ANTHROPIC_DEFAULT_OPUS_MODEL/ANTHROPIC_DEFAULT_SONNET_MODEL (모델 별칭이 가리킬 버전 고정), CLAUDE_CODE_EFFORT_LEVEL(max 를 세션 넘어 유지), MAX_THINKING_TOKENS, CLAUDE_CODE_DISABLE_AUTO_MEMORY=1.
model / availableModels
기본 모델 지정 · 선택 가능한 모델 제한
sandbox.enabled
Bash 샌드박스를 설정으로 상시 켜기
/sandbox 로 세션마다 켜는 대신 파일에 고정한다. 나가는 네트워크는 sandbox.network.allowedDomains 로 좁힌다.
autoCompactEnabled / autoCompactWindow
자동 컴팩트 토글 · 발동 기준 컨텍스트 크기(100k~1M)
outputStyle
응답 스타일 지정 (/clear 후에도 유지)
autoMemoryEnabled / autoMemoryDirectory
자동 메모리 토글 · 저장 위치 변경
claudeMdExcludes
모노리포에서 남의 CLAUDE.md 를 글롭으로 제외
cleanupPeriodDays
대화 기록 보존 기간 (기본 30일)
자동 메모리 디렉터리는 이 청소에서 제외된다 — 기록은 사라져도 메모리는 남는다.
enabledPlugins / extraKnownMarketplaces
프로젝트에 플러그인·마켓플레이스를 고정해 팀과 공유
statusLine
터미널 하단 상태줄을 명령 출력으로 커스텀
attribution
커밋·PR 에 붙는 서명 문구 변경
defaultShell
! 셸 모드의 셸 선택 (bash / powershell)
무한 반복으로 새어나가는 비용을 구조적으로 막는 장치들. 일회성 작업에는 상한 설정이 안전.
-p --max-turns 3
프린트 모드 턴 수 제한
--max-budget-usd 5.00
지출 상한 설정
--verbose
상세 로그 출력
/usage, /cost
토큰 사용량·비용 표시
모드보다 강한 층. --disallowedTools 는 우회되지 않으므로 위험한 명령은 여기서 상시 차단.
--allowedTools "Bash(git log:*)" \
도구 허용·금지 규칙을 명령줄에서 지정한다
권한 모드보다 강한 층이다. 모드는 "무엇을 물어보는가"를 정하지만 이 규칙은 무엇이 아예 불가능한가를 정한다.
--disallowedTools 가 특히 값을 한다. allow 목록은 승인 카드를 누르다 보면 실수로 넓어질 수 있지만 disallow 는 우회되지 않으므로, 되돌릴 수 없는 명령은 여기서 상시 차단한다.
--allowedTools "Bash(git log:*)" \
"Bash(git diff:*)" "Write"
--disallowedTools "Bash(rm:*)" "Bash(sudo:*)"
--permission-prompt-tool mcp_auth_tool
--dangerously-skip-permissions # 위험, 지양
--dangerously-skip-permissions 는 마지막 수단이다. 승인 창이 잦은 게 문제라면 allow 규칙을 쌓거나 샌드박스를 켜는 쪽이 맞다. 쓰기 전에 되돌릴 수 있는 상태인지 — 커밋했는지, 브랜치를 팠는지 — 먼저 볼 것.
→ 승인 창이 너무 자주 떠서 흐름이 끊긴다 · → 건드리면 안 되는 걸 건드릴까 봐 불안하다 · bypassPermissions · /sandbox
외부 서비스와 내 도구를 붙이는 표준 통로. 직접 만들기 전에 커넥터·플러그인부터 찾는 편이 빠름.
claude mcp
MCP 서버 설정
MCP 서버를 등록·확인·제거한다. --mcp-config 로 설정 파일이나 인라인 JSON 을 넘기면 프로젝트마다 다른 서버 구성을 쓸 수 있다.
직접 만들기 전에 순서를 지키면 헛수고를 줄인다 — 이미 있는 커넥터 → 마켓플레이스 플러그인 → 그래도 없으면 직접 MCP 서버.
MCP 서버가 돌려주는 내용은 데이터지 지시가 아니다. 외부 도구가 반환한 텍스트에 "이렇게 해라"가 섞여 있어도 그건 실행 근거가 아니다. 쓰기 권한이 있는 커넥터를 붙일 때는 샌드박스의 network.allowedDomains 로 나가는 곳을 제한하는 편이 안전하다.
→ 외부 서비스나 내 도구를 붙이고 싶다 · /sandbox · --mcp-config / --plugin-dir
claude mcp login/logout <s>
MCP OAuth 로그인/해제
/mcp
MCP 기능 접근
세션 안에서 연결 상태를 본다. 서버가 목록에 뜨고 도구 목록이 보여야 정상이다. 안 보이면 인증이 안 됐거나 서버 프로세스가 죽은 것이다.
예시
git log --oneline | claude -p "요약해줘"
cat error.log | claude -p "원인 찾아줘"
반복하는 지시를 파일 한 장으로 고정. 커스텀 명령은 스킬로 통합, 문법 동일.
.claude/commands/*.md
.claude/commands/*.md에 정의, frontmatter(name/description/aliases), 본문에 $ARGUMENTS 사용
파일 한 장이면 /명령 하나가 생긴다. 프로젝트 전용이면 .claude/commands/, 어디서나 쓰려면 ~/.claude/commands/.
커스텀 명령은 스킬로 통합됐다. .claude/commands/deploy.md 와 .claude/skills/deploy/SKILL.md 는 둘 다 /deploy 를 만들고 동작이 같다. 전자는 파일명이, 후자는 디렉터리명이 호출 이름이 된다. frontmatter 의 name 이 호출 이름이 되는 건 플러그인 스킬뿐이다.
인자 치환은 $ARGUMENTS(전체), $1·$2(위치 인자), 그리고 frontmatter 에 arguments: [issue, branch] 를 선언하면 $issue·$branch 로 이름을 붙여 쓴다. 리터럴 달러 기호는 백슬래시로 이스케이프한다.
Claude Code 는 frontmatter 키 20개를 받지만 claude.ai 업로드·Skills API 경로는 name, description, license, compatibility, metadata, allowed-tools 6개만 받고 그 외 키가 있으면 무시가 아니라 실패한다. 밖으로 내보낼 파일이면 6개로 제한할 것.
→ 같은 지시를 매번 치기 싫다 · 예: .claude/commands/deploy.md → /deploy 로 호출
/debug # .claude/commands/debug.md
파일명이 그대로 명령 이름이 된다
/debug # .claude/commands/debug.md
/test # .claude/commands/test.md
/deploy # .claude/commands/deploy.md
대화형이 아니라 한 번 돌고 끝나는 실행. 권한 모드·출력 형식·상한 셋을 반드시 함께 설정.
claude -p "analyze codebase" \
예시
#!/bin/bash
claude -p "analyze codebase" \
--output-format json > analysis.json
claude -p "generate tests" --max-turns 3 \
--output-format text > tests.txt
세션 ID 를 잡아 여러 단계를 이어 붙이거나, 파이프로 단계를 연결하는 패턴.
SID=$(claude -p "start" --output-format json \
예시
SID=$(claude -p "start" --output-format json \
| jq -r '.session_id')
claude -r "$SID" "continue analysis"
claude -p "구조 분석" | claude -p "개선안 제안" \
| claude -p "구현 계획 작성"
관점을 하나로 고정해 따로 돌리는 편이 한 번에 다 시키는 것보다 깊이 들어감.
예시
git diff HEAD~1 | claude -p "보안 이슈 리뷰" > security.md
git diff HEAD~1 | claude -p "성능 이슈 확인" > perf.md
git diff HEAD~1 | claude -p "개선안 제안" > improve.md
CI 에서 돌릴 때는 결과를 파싱 가능한 형식으로, 실패는 조용히 지나가지 않게.
예시
claude -p "커버리지 분석" --output-format json \
| jq '.coverage_percentage'
claude -p "커밋 기반 릴리스 노트 생성" \
--max-turns 2 > RELEASE_NOTES.md
find . -name "*.js" -exec claude -p "버그 분석: {}" \; \
> bug_report.txt
편집기와 붙이면 열려 있는 파일·선택 영역이 맥락으로 전달.
예시
/ide # IDE 연동 상태 표시/관리
claude --ide # 사용 가능한 IDE 자동 연결
claude --chrome # Chrome 브라우저 연동 켜기
claude --no-chrome # 이 세션만 Chrome 연동 끄기
표준 입력으로 무엇이든 전달 가능. git·docker·DB 출력이 그대로 입력.
예시
git log --oneline -10 | claude -p "체인지로그 작성"
git diff --name-only | claude -p "변경사항 설명"
mysql -e "SHOW TABLES" | claude -p "DB 구조 분석"
docker logs c | claude -p "로그에서 에러 찾기"
속도 저하의 원인은 대개 컨텍스트 과다, 또는 작업 전환 후 이전 대화 잔존.
예시
claude -p --max-turns 1 "빠른 분석" # 단일 턴
claude --autocompact auto # 자동 컨텍스트 압축
/usage # 세션 비용·한도 확인
/doctor # 설정 진단
이어가기로 컨텍스트 재사용, 과부하 시 폴백 모델로 전환.
예시
claude -c -p "이전 분석 이어가기" # 컨텍스트 재사용
claude -p "task1" & claude -p "task2" & wait # 병렬
claude --fallback-model sonnet,haiku "질의"
설정 파일 공유로 같은 기준 적용. CI·락다운 환경은 dontAsk 가 기본.
예시
claude --settings team-config.json "표준 분석"
claude -r "team-session-id" "팀 논의 이어가기"
claude --permission-mode dontAsk # CI·락다운 환경
조직이 배포하는 managed-settings.json 이 최상단, 개인 설정으로 뒤집기 불가.
설정 우선순위: managed-settings.json > CLI 인자 > .claude/settings.local.json > .claude/settings.json > ~/.claude/settings.json
managed-settings.json 이 최상단이라 개인 설정으로 뒤집을 수 없다. 조직이 배포하는 정책이고, 그 아래로 CLI 인자 → 프로젝트 local → 프로젝트 → 사용자 순이다.
개인 프로젝트에서 이 순서가 중요한 이유는 따로 있다 — .claude/settings.local.json 이 .claude/settings.json 을 덮으므로, 팀과 공유할 규칙은 local 이 아닌 쪽에 둬야 한다.
auto 모드는 프로덕션 배포·강제 푸시·시크릿 유출 등을 기본 차단
sandbox.network.allowedDomains
sandbox.network.allowedDomains 로 아웃바운드 도메인 제한
나가는 트래픽을 도메인 화이트리스트로 막는다. MCP 커넥터나 스크립트가 예상 밖의 곳으로 데이터를 보내는 경로를 차단하는 가장 직접적인 수단이다.
권한 확대 전에 피해 범위 축소를 먼저 검토.
작업 전환마다 /clear로 컨텍스트 초기화
--max-turns로 무한 반복 방지
장기 대화는 /compact로 압축
--dangerously-skip-permissions 사용 지양
위험 명령은 --disallowedTools로 상시 차단
도구 권한 주기적 점검, 항상 최신 버전 유지
반복이 보이면 명령어로 고정, 자동화할 거면 출력 형식부터 결정.
반복 작업 → .claude/commands/ 커스텀 명령어화
자동화 스크립트 → --output-format json
복합 작업 → 파이프로 단계별 연결
장시간 작업 → 세션 ID로 관리, 에러 처리 구현
팀 공유용 워크플로우는 문서화
무엇부터 익힐지 순서. 권한 모드와 컨텍스트 관리가 초반 체감 가장 큼.
기본 명령어부터 → /help 자주 활용 → 간단한 질의로 연습 → 작업 간 /clear
권한 모드·도구 권한 마스터 → JSON 출력 자동화 → MCP 연동 → 커스텀 명령어화
Hooks·플러그인·샌드박싱 활용 → 백그라운드/클라우드 세션 → 팀 협업·엔터프라이즈 정책 준수
설치·인증 문제는 doctor 로 상태를 먼저 읽고, 그래도 안 되면 네이티브 재설치.
claude --version && claude auth status && claude doctor
예시
claude --version && claude auth status && claude doctor
claude install stable # 네이티브 재설치
npm uninstall -g @anthropic-ai/claude-code
npm install -g @anthropic-ai/claude-code # npm 재설치
동작 이상 시 커스터마이제이션 배제로 범위를 반씩 줄이는 게 가장 빠름.
예시
/clear # 컨텍스트 비우기
claude -p --max-turns 3 "포커스 질의"
/compact "핵심만 유지"
/permissions # 권한 규칙 확인·관리
판정 근거가 되는 1차 출처. 이 사이트 내용과 어긋나면 이쪽이 맞음.
공식 문서: code.claude.com/docs/en/overview
CLI 레퍼런스: code.claude.com/docs/en/cli-reference
명령어 레퍼런스: code.claude.com/docs/en/commands
권한 모드: code.claude.com/docs/en/permission-modes
Hooks: code.claude.com/docs/en/hooks
Hooks: code.claude.com/docs/en/hooks
GitHub: github.com/anthropics/claude-code
GitHub: github.com/anthropics/claude-code
세션 안에서 치는 명령과 플러그인 생태계. · 섹션 21개 · 항목 120개
대화 자체를 다루는 명령들. 작업이 바뀌면 이어가지 말고 자르는 편이 나음.
/clear [name]
새 대화 시작
대화 요약
/context [all]
컨텍스트 사용량 표시
/resume
다른 대화로 전환
/rename [name]
세션 이름 변경
/branch [name]
대화 분기
/fork [prompt]
새 백그라운드 세션으로 복사
/export [filename]
대화 내보내기
/diff
변경사항 대화형 뷰어
/rewind [turn#]
코드+대화 체크포인트 롤백
모델·추론 강도를 세션 안에서 변경.
/model [model]
모델 변경
/effort [level|auto]
추론 강도 조정
/advisor [model|off]
어드바이저 모델 켜기/끄기
/autocompact [auto|tokens]
자동 컴팩트 기준 설정
/fast [on|off]
패스트 모드 토글
실행 전에 계획을 받거나, 완료 조건을 걸고 맡기는 축.
/plan [description]
계획 모드 진입
/background [prompt], /bg
세션을 백그라운드로 분리
/loop [interval] [prompt]
프롬프트 반복 실행
/goal [condition|clear]
완료 조건 설정 후 자동 진행
/subtask <prompt>
서브에이전트에 하위작업 할당
/batch <instruction>
병렬 대규모 변경 조직화
변경을 검토받는 명령들. 관점을 나눠 여러 번 돌리는 편이 더 깊이 들어감.
/code-review [level] [--fix]
diff·PR 검토 (별칭 /review)
/security-review
diff 보안 취약점 검사
/simplify
코드 단순화 제안
/verify
코드 검증(스킬)
/autofix-pr [prompt]
CI 실패 자동 수정 감시
지금 상태가 어떤지 읽는 명령들. 고치기 전에 여기부터 확인.
/status
세션 상태·진행 작업 표시
/usage, /cost
토큰 사용량·비용 표시
/doctor
설정 진단 및 문제 해결
/insights
세션 사용 패턴 분석 보고서
/recap
세션 한 줄 요약
/heapdump
메모리 진단 스냅샷
스킬·플러그인·MCP 처럼 기능을 늘리는 축.
/agents
서브에이전트 생성·관리
/hooks
이벤트 훅 설정 보기
/mcp [subcommand]
MCP 서버 연결 관리
/sandbox [action]
격리 환경에서 실행
/memory
CLAUDE.md 편집·자동 메모리
/permissions
도구 권한 규칙 관리
/list-agents
메시지 가능한 서브에이전트 목록
다른 서피스(웹·데스크톱)로 작업을 넘기거나 가져오는 축.
/desktop
세션을 데스크톱 앱으로 이동 (별칭 /app)
/mobile
모바일 앱 다운로드 QR
/remote-control
다른 기기에서 세션 계속
/teleport
웹 세션을 터미널로 가져오기
/bug [report]
버그 보고·대화 공유
/feedback [report]
제품 피드백 전송
설정과 개인화. 대부분 설정 파일에도 같은 항목 존재.
/config [key=value]
설정 열기/직접 지정
/color [color|default]
프롬프트 바 색상
/keybindings
단축키 파일 열기
/privacy-settings
개인정보보호 설정
/fewer-permission-prompts
권한 프롬프트 감소
자주 쓰이진 않지만 필요할 때 찾게 되는 것들.
/cd <path>
작업 디렉토리 이동
/add-dir <path>
작업 디렉토리 추가
/chrome
Claude in Chrome 설정
/web
웹 검색 도구 활성화
/copy [N]
마지막 응답 클립보드 복사
/login, /logout
계정 로그인/로그아웃
/upgrade
Claude Code 업그레이드
팀 연동과 조사 성격의 명령.
/install-github-app
Claude GitHub App 설치
/install-slack-app
Claude Slack 앱 설치
/release-notes
버전별 체인지로그 보기
/claude-api [subcommand]
Claude API 참고자료 로드
/deep-research <question>
웹 검색 기반 심화 조사
/dataviz [request]
차트·대시보드 설계 지침
/design-sync [hint]
디자인 시스템 업로드
부가 기능.
/focus
포커스 뷰 토글
/radio
Claude FM 로파이 라디오
/powerup
인터랙티브 기능 학습 레슨
/passes
Claude Code 무료 체험 공유
/design-login
디자인 시스템 접근 권한
플러그인이 제공하는 명령의 호출 문법.
/plugin # Discover/Installed/
예시
/plugin # Discover/Installed/
# Marketplaces/Errors 탭
/plugin marketplace add owner/repo | url | 경로
/plugin marketplace list / update <name> / remove <name>
/plugin install <name>@<marketplace>
/plugin uninstall / enable / disable <name>@<marketplace>
/plugin list [--enabled|--disabled]
/reload-plugins [--force] # 변경사항 즉시 적용
어느 범위에 설치되느냐가 어디서 쓸 수 있는지를 결정.
User
내 계정, 모든 프로젝트에 설치
Project
.claude/settings.json에 기록, 협업자 공유
Local
이 저장소에서 나만(.local.json)
스킬은 plugin-name:command 형태로 네임스페이스 (예: /commit-commands:commit)
설치 요약에 "Run /reload-plugins to activate." 표시되면 반드시 실행
실사용 빈도가 높은 것들. 직접 만들기 전에 여기 있는지 먼저 확인.
1. frontend-design
(공식 마켓) 디자인 토큰·레이아웃 추론으로 UI 품질 향상
/plugin install frontend-design@claude-plugins-official
2. superpowers
(커뮤니티) 브레인스토밍·서브에이전트 개발·TDD 등 워크플로우 모음
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
3. context7
(커뮤니티) 최신 라이브러리 문서를 온디맨드로 조회
/plugin marketplace add upstash/context7
/plugin install context7@context7-marketplace
4. claude-mem
세션 간 영구 메모리 추가 — 플러그인 시스템이 아닌 별도 설치
npx claude-mem install
5. caveman
(커뮤니티) 토큰 절약형 축약 응답 모드
/plugin marketplace add JuliusBrussee/caveman
/plugin install caveman@caveman
Anthropic은 설치 통계를 공개하지 않음 — 순위는 ClaudeMarketplaces 등 커뮤니티 집계 기준. 서드파티 플러그인은 설치 전 신뢰 여부 직접 확인 필요
언어 서버를 붙여 코드 인텔리전스를 얹는 계열.
C/C++
clangd-lsp
C#
csharp-lsp
Go
gopls-lsp
Java
jdtls-lsp
Kotlin
kotlin-lsp
Lua
lua-lsp
PHP
php-lsp
Python
pyright-lsp
Rust
rust-analyzer-lsp
Swift
swift-lsp
TypeScript
typescript-lsp
설치 후 해당 언어서버 바이너리 별도 설치 필요 — 자동 진단(에러·타입) + 정밀 코드 탐색 제공
외부 서비스 연동 계열.
github, gitlab PM: atlassian, asana, linear, notion
figma 인프라: vercel, firebase, supabase
slack 모니터링: sentry
explanatory-output-style
구현 선택의 이유를 설명해주는 출력 스타일
learning-output-style
대화형 학습 모드 출력 스타일
security-guidance
변경마다 자동 보안 리뷰
commit-commands
커밋·푸시·PR 생성 스킬
pr-review-toolkit
PR 리뷰 전용 에이전트
agent-sdk-dev, plugin-dev
SDK·플러그인 개발 도구
설치·관리에서 겪는 실무 문제들.
설치 전 출처 신뢰도 확인 — Anthropic은 서드파티 플러그인 내용을 검증하지 않음
Context cost
설치 화면의 로 매 턴 추가되는 토큰 비용 확인
Installed
2주·10세션 이상 미사용 플러그인은 탭에서 정리
스크립팅 설치: claude plugin install <name>@<marketplace> --scope project
한 번 쓰고 말 것과 배포할 것의 구분.
내장 슬래시 명령어 → 세션·모델·진단 등 Claude Code 자체 기능 제어
플러그인 → 스킬·에이전트·MCP·Hooks를 패키지로 확장, 설치 후 plugin:command 형태로 사용
파일 한 장이면 명령 하나 생성. 커스텀 명령은 스킬로 통합, 문법은 동일.
.claude/commands/*.md
.claude/commands/*.md 에 정의
frontmatter: name, description, aliases
frontmatter: name, description, aliases
본문에 $ARGUMENTS 로 인자 전달
예: .claude/commands/deploy.md → /deploy 로 호출
명령을 이어 붙여 쓰는 실전 조합.
새 기능 개발: /plan → 승인 → 구현 → /code-review → /security-review
디버깅 막힐 때: /rewind 로 되돌린 뒤 원인 파악 후 재시도
PR 마무리: /diff 로 검토 → 커밋 → /release-notes
판정 근거가 되는 1차 출처.
명령어 전체: code.claude.com/docs/en/commands
플러그인 설치: code.claude.com/docs/en/discover-plugins
플러그인 제작: code.claude.com/docs/en/plugins
공식 마켓: claude.com/plugins
커뮤니티 순위: claudemarketplaces.com