Claude Code CLI

--email 로 주소를 미리 채우고, --sso 로 SSO 를 강제하고, --console 로 구독 대신 Anthropic Console(API 과금)로 붙는다.

JSON 으로 출력하고 로그인 상태면 0, 아니면 1 로 종료한다(--text 는 사람이 읽는 형태) — CI 에서 인증 여부를 판정하기에 이 종료 코드가 편하다.

설치·인증·경로·권한 설정을 한 번에 점검한다. 문제 발생 시 추측 전에 이 명령을 먼저 돌리는 게 시간을 절약한다. 출력을 복사해서 지원 요청에 쓸 수도 있다.

점검 항목: 설치 버전, 인증 상태, PATH 설정, 파일 권한, 프로젝트 구성, 훅/스킬 상태.

인터랙티브 셸을 시작한다. 프롬프트를 입력하고 응답을 받으면서 대화를 계속할 수 있다. 세션은 자동으로 저장되고 /resume 로 다시 불러올 수 있다.

첫 프롬프트를 한 줄로 입력해서 세션을 시작한다. 대화형 셸에 들어가지 않고 바로 답을 얻고 싶을 때 유용하다.

한 번만 실행하고 종료한다. 인터랙티브 세션을 남기지 않고 CI/CD 파이프라인이나 스크립트에서 쓰기 좋다.

표준입력을 그대로 받는다 — git diff, docker logs, DB 출력 무엇이든 된다. 넣은 만큼 컨텍스트를 먹으므로 먼저 걸러서 넘기는 편이 낫다.

현재 디렉터리의 가장 최근 대화를 불러온다. 백그라운드 세션·-p·SDK·첫 프롬프트가 /loop 인 세션은 건너뛴다 — 그것들까지 포함하려면 claude -p --continue 다. /add-dir 로 이 디렉터리를 추가했던 세션도 포함된다.

ID 나 이름으로 재개하고, 인자 없이 주면 선택기가 열린다. ID 를 주면 현재 프로젝트와 그 워크트리를 먼저 찾고 없으면 이 기기의 다른 프로젝트까지 찾는다(v2.1.223+).

/resume 목록과 터미널 제목에 뜨고, 그 이름으로 재개할 수도 있다(claude --resume <name>). 세션 도중에 바꾸려면 /rename 이다.

PR 번호, GitHub·GitHub Enterprise PR URL, GitLab MR URL, Bitbucket PR URL 을 받는다. Claude 가 PR 을 만들면 연결은 자동으로 걸린다.

특정 버전이나 채널을 지정하려면 claude install <version|stable|latest> 쪽이다.

2.1.118 같은 버전이나 stable·latest 를 받는다. npm 설치가 꼬였을 때 네이티브로 다시 깔아 원인을 가르는 데도 쓴다.

CI·스크립트용 장기 토큰을 만든다. 터미널에 출력만 하고 저장하지 않으므로 그 자리에서 비밀 저장소에 넣어야 한다. Claude 구독이 필요하다.

하위 명령으로 서버를 추가·삭제·조회한다. claude mcp login <name> 은 대화형 /mcp 패널을 열지 않고 OAuth 흐름만 돌리고(SSH 에서는 --no-browser 로 URL 을 출력), claude mcp logout <name> 은 저장된 자격증명을 지운다(v2.1.186+).

병렬 백그라운드 세션을 보고 새로 띄우는 화면을 연다. --cwd <path> 로 그 디렉터리 아래에서 시작된 것만, --json 으로 스크립트용 JSON 배열(--json --all 은 끝난 것도 포함)을 얻는다. --permission-mode·--model·--effort·--agent 로 디스패치될 세션의 기본값을 정한다.

세션을 시작하지 않고 설치 상태·설정 파일 파싱 오류·원격 제어 가능 여부를 찍는다. 고침까지 해 주는 것은 세션 안의 /doctor 쪽이다 — 이쪽은 읽기 전용이라 스크립트에 넣기 좋다.

대화 기록·작업 목록·디버그 로그·파일 편집 이력·프롬프트 이력과 ~/.claude.json 의 항목까지 지운다. --dry-run 으로 먼저 보고, -i 로 항목별 확인, --all 로 전 프로젝트.

최신 모델 별칭(sonnet·opus·haiku·fable) 또는 전체 모델 이름을 받는다. model 설정과 ANTHROPIC_MODEL 환경변수를 모두 덮어쓴다.

low·medium·high·xhigh·max·ultracode 중에서 고른다(모델에 따라 가용 범위가 다르다). ultracode 는 xhigh 로 시작하면서 ultracode 를 켠 상태다. effortLevel 설정을 이 세션에만 덮어쓰고 저장되지 않는다.

각 경로가 실제 디렉터리인지 검사한 뒤 읽기·편집 범위에 넣는다. 파일 접근만 늘어난다 — 그 디렉터리의 .claude/ 설정은 대부분 읽지 않는다. 세션마다 다시 주지 않으려면 설정의 permissions.additionalDirectories 에 적는다.

"확인 없이 실행"이지 "이 도구만 쓴다"가 아니다. 도구 자체를 제한하려면 --tools 쪽이다. 값은 권한 규칙 문법을 따른다 — "Bash(git log *)" "Bash(git diff *)" "Read".

이름만 주면 도구가 컨텍스트에서 사라지고, 범위를 주면 도구는 남고 그 호출만 막는다 — "Edit" 는 Edit 제거, "*" 는 전부 제거, "mcp__*" 는 MCP 도구 전부 제거, Bash(rm *) 는 Bash 는 남기고 rm 만 거부.

프린트 모드 전용. text·json·stream-json. 스크립트에서 결과를 파싱하려면 json, 진행을 흘려 받으려면 stream-json 이다.

프린트 모드 전용. text·stream-json. stream-json 으로 넣으면 작업 중에 보낸 메시지가 큐에 남아 자기 턴으로 실행된다(그 턴은 자기 --max-turns 한도를 따로 갖는다).

프린트 모드 전용이고 기본값은 무제한이다. 한도에 닿으면 오류로 종료한다 — 성공으로 끝나지 않으므로 스크립트가 조용히 잘린 결과를 쓰는 일은 없다.

턴 단위 출력을 전부 보여주고, 이 세션의 viewMode 설정을 덮어쓴다. stream-json 계열 플래그 몇 개는 이 플래그를 함께 요구한다.

--continue 는 현재 디렉터리의 가장 최근 대화를 불러오는데, 백그라운드 세션·claude -p· SDK·첫 프롬프트가 /loop 인 세션은 건너뛴다(claude -p --continue 는 그것들도 포함한다).

--resume 은 ID·이름으로 재개하거나 선택기를 연다. ID 를 주면 현재 프로젝트와 그 워크트리를 먼저 찾고, 없으면 이 기기의 다른 프로젝트까지 찾는다(v2.1.223+). 둘 다 /add-dir 로 이 디렉터리를 추가했던 세션까지 포함한다.

특정 PR 에 연결된 세션만 걸러 선택기를 연다. PR 번호, GitHub·GitHub Enterprise PR URL, GitLab MR URL, Bitbucket PR URL 을 받는다. Claude 가 PR 을 만들면 연결은 자동으로 걸린다.

--resume·--continue 와 함께 쓴다. 원래 세션 ID 를 재사용하지 않고 새 ID 를 만든다 — 원본을 남긴 채 다른 방향을 시험할 때 쓴다.

--permission-mode bypassPermissions 와 같다. 모든 것을 생략하는 것은 아니다 — 어떤 모드도 자동 승인하지 않는 행위는 그대로 남는다. --bg 로 띄운 세션에서는 감독 프로세스가 재시작해도 이 모드가 유지된다.

--allowedTools 와 축이 다르다 — 이쪽은 도구의 존재 여부를 정한다. "" 는 전부 끄기, "default" 는 전부, "Bash,Edit,Read" 처럼 이름 나열도 된다.

MCP 도구에는 영향이 없다 — 그쪽까지 막으려면 --disallowedTools "mcp__*" 를 같이 쓴다.

<repo>/.claude/worktrees/<name> 에 워크트리를 만들어 그 안에서 시작한다. 이름을 주지 않으면 자동 생성한다. #123 이나 PR·MR URL 을 주면 그 PR 을 origin 에서 가져와 거기서 분기한다.

--tmux 를 같이 주면 그 워크트리용 tmux 세션까지 만든다(iTerm2 가 있으면 네이티브 패널).

세션 ID 와 관리 명령을 출력하고 즉시 돌아온다. --agent 와 함께 특정 서브에이전트로 띄우거나, --exec 와 함께 Claude 세션이 아니라 셸 명령을 백그라운드 잡으로 돌릴 수 있다 (claude --bg --exec 'pytest -x').

--name(-n) 은 /resume 목록과 터미널 제목에 뜨는 이름이고, 그 이름으로 재개할 수도 있다 (claude --resume <name>). 같은 기기의 다른 세션이 쓰는 이름이면 변형된 이름이 붙는다.

--session-id 는 대화에 쓸 ID 를 직접 정한다(유효한 UUID 여야 한다) — 스크립트가 나중에 그 세션을 다시 찾아야 할 때 쓴다.

범주를 걸러 볼 수 있다 — --debug='mcp,startup', --debug='!1p'. 필터는 = 형태에서만 붙는다(공백으로 주면 필터 없이 디버그만 켜진다). --debug-file <path> 는 파일로 쓰면서 디버그를 자동으로 켜고 CLAUDE_CODE_DEBUG_LOGS_DIR 보다 우선한다.

사용 가능한 슬래시 명령어 전체 목록과 간단한 설명을 보여준다. 명령어 이름을 까먹었을 때 빠르게 찾을 수 있다.

이미 CLAUDE.md 가 있으면 덮어쓰지 않고 개선을 제안한다. CLAUDE_CODE_NEW_INIT=1 을 설정하면 스킬·훅까지 묻는 대화형 흐름이 되고, 다른 코딩 에이전트의 설정을 발견하면 /import 로 옮기길 제안한다.

백그라운드 세션에 붙어 있을 때는 세우지 않고 빠져나온다 — 세우려면 /stop 이다.

이름을 붙여 두면 /resume 목록에서 방금 자른 대화를 알아볼 수 있다. 이어가면서 자리만 확보하려면 /compact 다. 별칭은 /reset·/new.

지금까지의 대화를 요약해서 컨텍스트를 줄인다. 선택적으로 계속할 지시를 입력하면 요약된 상태에서 이어서 작업한다. 긴 대화가 느려졌을 때 유용하다.

비용이 아니라 컨텍스트 분포를 색 격자로 보여준다(비용은 /usage·/cost 쪽이다). 컨텍스트를 많이 쓰는 도구, 비대해진 메모리 파일, 한계 임박 경고가 함께 뜬다.

전체화면 모드에서는 격자를 살리려고 항목별 내역을 접는데, all 을 주면 펼친다.

key=value 를 넘기면 화면을 열지 않고 값만 바꾼다(/config thinking=false, /config theme=dark). /config --help 로 설정 가능한 키 전체를 볼 수 있다.

버전·모델·계정·연결 상태를 보여주고 응답 중에도 즉시 실행된다.

설치·PATH·설정 파일 파싱을 점검하고 고치기까지 한다. 쓰지 않는 스킬·MCP·플러그인을 컨텍스트 비용과 함께 지목하고, 커진 CLAUDE.md 를 덜어내는 제안도 한다. 세션을 열지 않고 읽기 전용으로만 보려면 셸에서 claude doctor 다.

유료 플랜에서는 스킬·서브에이전트·플러그인·MCP 서버별 내역까지 쪼개 준다. /stats 도 같은 것이다. 플랜 사용량은 터미널·데스크톱·웹이 공유한다.

새 세션의 기본값으로도 저장된다 — 이번 세션만 바꾸려면 선택기에서 그 줄에 s 를 누른다. 좌우 화살표로 추론 강도까지 같이 조정한다.

low~xhigh·max·ultracode·auto. status 는 현재 값을 찍는다. max 와 ultracode 는 세션 한정이다.

백그라운드 세션은 bg 로 표시되고 아직 돌고 있는 것은 여기서 재개할 수 없다 — claude agents 에서 붙거나 거기서 먼저 세운다.

이름을 생략하면 대화 이력에서 자동 생성한다. 제어문자는 공백으로 치환되고 200자에서 잘린다.

분기 쪽으로 들어간다. 원본은 남고 /resume 으로 돌아온다. 복사본을 백그라운드로 띄우고 나는 남으려면 /fork, 곁가지를 맡기려면 /subtask.

파일명을 주면 바로 쓰고, 없으면 클립보드 복사·파일 저장을 고르는 대화상자가 열린다.

커밋 안 된 변경과 턴별 diff 를 좌우 화살표로 넘겨 본다. git blob 원본에서 계산하므로 .gitattributes 의 diff 드라이버는 적용되지 않는다.

시작할 때 자동으로 붙이려면 claude --ide 인데, 유효한 IDE 가 정확히 하나일 때만 붙는다.

reconnect <server> 로 끊긴 하나만 다시 붙이고, enable/disable 에 이름이나 all 을 주면 대화상자 없이 상태만 바꾼다. -p 에서는 목록 대신 상태 요약을 텍스트로 찍는다.

돌고 있는 것이 있으면 중단, 없으면 입력 비우기다. 아무것도 안 돌고 있을 때 한 번 누르면 프롬프트가 비고, 한 번 더 누르면 Claude Code 가 종료된다.

첫 누름에 확인 안내가 뜨고 800ms 안에 다시 눌러야 종료된다. 입력창에 글자가 있으면 종료가 아니라 커서 뒤 한 글자를 지운다.

도구 사용과 실행을 자세히 보여주고, 어시스턴트 메시지마다 타임스탬프와 쓰인 모델이 붙는다. 기본적으로 "Called slack 3 times" 처럼 한 줄로 접히는 MCP 호출도 여기서 펼쳐진다.

전체화면 렌더링에서는 뷰어 안에서 {·}(이전·다음 사용자 프롬프트), [(대화를 터미널 스크롤백에 기록), v(임시 파일로 열기), q·Esc(나가기)가 동작한다.

Claude 의 할 일 체크리스트를 상태 영역에 보이거나 감추는 것이다 — 백그라운드 작업 보기가 아니다. 돌고 있는 셸·서브에이전트는 /tasks 쪽이다.

Bash 명령과 에이전트를 백그라운드로 보낸다. 세션 자체를 떼어내는 것은 /background 다.

이 세션의 백그라운드 서브에이전트를 모두 세우고, 남은 세션 동안 아티팩트 자동 답글도 끈다. 확인을 위해 3초 안에 두 번 눌러야 한다.

복원할 때 커서 위치와 붙여넣은 내용까지 같이 돌아온다. 쓰던 프롬프트를 버리지 않고 급한 질문을 먼저 보낼 때 쓴다.

커서 위치에 [Image #N] 칩이 들어가므로 프롬프트 안에서 위치로 참조할 수 있다 ("두 번째 이미지의 오류" 처럼). iTerm2 는 Cmd+V, Windows·WSL 은 Alt+V 이고, WSL 은 둘 다 걸려 있다(터미널이 Ctrl+V 를 가로채면 Alt+V).

화면이 깨지거나 일부가 비어 보일 때 강제로 다시 그린다. 입력과 대화는 그대로 남는다.

v2.1.238 부터는 두 번 눌러도 대화가 지워지지 않는다 — 그 전에는 2초 안에 Ctrl+L 이나 Cmd+K 를 두 번 누르면 /clear 가 돌았다. 지금 대화를 비우려면 /clear 를 직접 쓴다.

readline 식 Ctrl+X Ctrl+E 도 같은 동작이다. /config 에서 Show last response in external editor 를 켜면 직전 응답이 # 주석으로 함께 열린다.

턴 중간에 세워도 거기까지 한 일은 남는다. 큐에 넣어 둔 메시지가 있으면 그것을 다음으로 보낸다. 대화상자가 열려 있으면 닫고, 권한 프롬프트에서는 거부로 처리한다.

글자가 있으면 지우면서 초안을 히스토리에 저장하므로 Up 으로 되살릴 수 있다. 입력이 비어 있으면 되돌리기 메뉴가 열린다(코드·대화를 이전 지점으로).

Windows 에서 런타임이 VT 입력 모드를 못 켜면 Alt+M 이 같은 역할을 한다. 순환 순서는 Manual(default) → acceptEdits → plan → (가능하면) bypassPermissions → auto.

쓰던 프롬프트를 비우지 않고 바꾼다.

Fable 5 에는 효과가 없다(항상 확장 사고를 쓴다). macOS 에서는 Option 을 Meta 로 설정하지 않아도 동작하는 몇 안 되는 Alt 계열 키다.

교차 세션 메시징이 켜진 세션에서는 @ 뒤에 한 글자 이상 치면 이 기기의 다른 라이브 세션도 후보로 뜬다 — 골라서 그 세션에 메시지를 보내게 할 수 있다.

명령을 직접 돌리고 그 출력이 세션에 들어가며 Claude 가 그것에 대해 응답한다 — 결과를 복사해 붙여 넣는 왕복이 없어진다.

지운 것은 보관되므로 Ctrl+Y 로 붙여넣을 수 있고, 붙여넣은 뒤 Alt+Y 로 이전에 지운 것들을 순환한다. macOS 에서는 Cmd+Backspace 가 Ctrl+U, Option+Delete 가 Ctrl+W 에 매핑되고 Windows 는 Ctrl+Backspace 가 Ctrl+W 다.

Ctrl+W 가 공백 단위로 지우게 하려면 설정의 keybindingFlavor 를 "readline" 로 둔다. 되돌리기는 Ctrl+_(또는 Ctrl+Shift+-)다.

macOS 에서는 Option 을 Meta 로 설정해야 동작한다(터미널 설정). keybindingFlavor: "readline" 이면 Alt+F·Alt+D 의 경계 판정이 단어 끝 기준으로 바뀐다.

\ 뒤에 Enter 는 모든 터미널에서 되고, Ctrl+J 도 설정 없이 된다. Shift+Enter 는 iTerm2·WezTerm·Ghostty·Kitty·Warp·Apple Terminal·Windows Terminal 에서 기본 동작하고, 그 외 터미널은 /terminal-setup 으로 잡는다. Option+Enter 는 macOS 에서 Option 을 Meta 로 설정한 뒤.

입력이 비어 있을 때만 패널이 열린다 — 글자가 있으면 그냥 ? 가 입력된다. 전체화면 렌더링이 필요하다.

:name: 을 전부 치면 이모지가 들어가고, 두 글자 이상이면 후보가 뜬다(v2.1.217+). 스페이스를 누르고 있으면 음성 입력이 된다 — /voice 로 켜 두어야 하고 /voice tap 으로 눌러서 시작·정지 방식으로 바꿀 수 있다.

default·acceptEdits·plan·auto·dontAsk·bypassPermissions 를 받고, manual 은 default 의 별칭이다(UI 가 Manual 로 표기하는 그 모드, v2.1.200+). 설정 파일의 defaultMode 를 덮어쓴다.

--agent 는 이 세션이 쓸 에이전트를 정하고 agent 설정을 덮어쓴다. --agents 는 파일을 만들지 않고 JSON 으로 서브에이전트를 정의한다 — --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'.

설정이 깨졌을 때 원인을 가르는 도구다. CLAUDE.md·스킬·플러그인·훅·MCP 서버·커스텀 명령·에이전트·출력 스타일·워크플로·커스텀 테마·키바인딩·상태줄·LSP·자동 메모리가 전부 안 뜬다.

인증·모델 선택·내장 도구·권한은 정상 동작한다 — 이 점이 --bare 와 다르다.

목적이 진단이 아니라 속도다. 훅·스킬·커스텀 명령·서브에이전트·플러그인·MCP 서버· 자동 메모리·CLAUDE.md 의 자동 탐색을 건너뛰어 스크립트 호출이 빨리 시작된다. Bash·파일 읽기·파일 편집 도구는 남고, --add-dir 로 넘긴 디렉터리의 스킬은 여전히 로드된다. CLAUDE_CODE_SIMPLE 을 세운다.

여기서 준 키만 settings.json 의 같은 키를 이 세션에 대해 덮어쓴다 — 적지 않은 키는 파일 값을 그대로 쓴다. 파일이면 일반 파일이어야 하고 2 MiB 를 넘을 수 없다.

/autocompact 와 같은 값을 받되 저장된 설정을 바꾸지 않고 이 세션에만 적용한다 (claude --autocompact 500k). v2.1.221+.

주 모델이 과부하이거나 없을 때(예: 은퇴한 모델) 넘어갈 모델을 쉼표로 나열한 순서대로 시도한다. fallbackModel 설정을 덮어쓰고, 세션을 넘겨 유지하려면 그 설정에 적는다.

프린트 모드 전용. 서브에이전트의 지출도 합산된다. 상한에 닿으면 새 서브에이전트 생성이 Budget limit reached 로 실패하고, 돌고 있던 백그라운드 서브에이전트도 중단된다(v2.1.217+).

네 개가 짝을 이룬다 — --system-prompt(전체 교체) · --system-prompt-file(파일로 교체) · --append-system-prompt(뒤에 덧붙임) · --append-system-prompt-file(파일 내용을 덧붙임).

교체는 기본 프롬프트를 통째로 버린다 — 도구 사용 규칙까지 사라지므로, 지침을 더하고 싶은 것이라면 append 쪽이다.

--mcp-config 는 JSON 파일·문자열에서 MCP 서버를 읽는다. -p 와 함께 쓰면 첫 턴 전에 아직 연결되지 않은 서버를 기다린다(MCP_TIMEOUT, 기본 30초. 도구 목록이 캐시된 서버는 기다리지 않는다).

--plugin-dir 는 디렉터리나 .zip 에서 이 세션만 쓸 플러그인을 읽는다 — 플래그 하나에 경로 하나이므로 여러 개면 반복해서 준다.

다른 MCP 설정 전부를 무시한다. 재현 가능한 스크립트 실행에서 내 개인 MCP 설정이 섞여 들어오는 것을 막는 용도다.

쉼표로 나열한다(--setting-sources user,project). CI 에서 개발자 로컬 설정을 빼고 돌리고 싶을 때처럼, 어느 층까지 읽을지를 명시할 수 있다.

작업이 끝난 뒤 JSON Schema 에 맞는 출력을 받는다. 스키마가 잘못되면 오류로 종료하므로 파이프 뒤쪽이 깨진 JSON 을 받는 일이 없다. format 키워드는 주석으로만 받고 검증하지 않는다.

--cloud 에 작업 설명을 주면 claude.ai 에 새 웹 세션을 만들고, 세션 ID(session_...· cse_...)나 claude.ai/code URL 을 주면 그 세션을 지목한다 — -p 면 메시지를 큐에 넣고, -p 가 없으면 내 터미널을 붙인다. --remote 는 이것의 옛 별칭이다.

--teleport 는 반대 방향으로, 웹 세션을 로컬 터미널에서 이어받는다.

claude.ai 나 Claude 앱에서도 조작할 수 있는 상태로 시작한다. 이름을 붙일 수도 있다. 자동 생성 이름의 접두어는 기본이 호스트명이라 myhost-graceful-unicorn 같은 이름이 된다.

fable·opus·sonnet 또는 전체 모델 ID 를 받고, 이 세션에 대해 advisorModel 설정보다 우선한다. fable 은 Fable 5 접근 권한이 필요하다.

저장하지 않으므로 재개도 불가능하다. 어떤 모드에서든 같은 효과를 내는 환경변수는 CLAUDE_CODE_SKIP_PROMPT_HISTORY 다.

대화만·코드만·둘 다를 고를 수 있다. git 아래층이 아니라 위층이다 — 커밋하지 않은 변경과 대화를 함께 맞춰 되돌린다.

v2.1.198 부터는 관리 화면이 아니라 안내만 출력한다 — .claude/agents/ 를 직접 편집하거나 Claude 에게 만들라고 한다. 세션 단위로만 필요하면 --agents 로 JSON 을 넘길 수도 있다.

지원 플랫폼에서만 보인다. 권한 확인이 잦다고 우회로 가는 대신 격리로 위험을 낮추는 쪽이다.

응답 중에 실행해도 즉시 열리고, 바꾼 규칙은 같은 턴의 다음 도구 호출부터 적용된다. 데스크톱 앱에는 이 대화형 화면이 없다.

Shift+Tab 순환으로도 들어간다. 설명을 붙이면 그 작업으로 계획을 시작한다.

강도(low~max·ultra)와 대상(PR 번호·브랜치·경로)을 인자로 받고, --fix 는 고침까지 적용한다. /review 는 별칭이다.

커밋 안 된 변경이 아니라 브랜치와 origin 기본 브랜치의 차이를 본다 — origin 리모트가 없으면 실패한다.

터미널을 돌려받고 진행은 claude agents 로 확인한다. 처음부터 백그라운드로 띄우려면 claude --bg "..." 다.

끝난 서브에이전트도 포함되므로 결과를 놓쳤을 때 여기서 찾는다. 응답 중에도 즉시 실행된다.

복사본이 돌고 나는 여기 남는다. 에이전트 뷰를 끈 환경이나 v2.1.212 미만에서는 포크된 서브에이전트로 동작한다 — 별도 세션이 아니라 이 대화에 결과가 붙는다.

간격을 생략하면 Claude 가 스스로 정하고, 프롬프트까지 생략하면 자율 점검이나 .claude/loop.md 를 돌린다. --continue 는 첫 프롬프트가 /loop 인 세션을 건너뛴다.

조건이 충족될 때까지 턴을 넘어 계속 간다. clear·stop·off·reset·none·cancel 중 무엇으로든 해제한다.

자리를 비웠다 돌아오면 자동으로 뜨는 그 요약을 필요할 때 직접 부르는 것이다. /compact 와 달리 대화를 건드리지 않는다.

이 기기의 최근 세션을 분석한 HTML 보고서를 만든다 — 클라우드 세션에서는 쓸 수 없다.

실질 이점은 전문성이 아니라 컨텍스트 격리다. 탐색으로 파일 50개를 훑어야 하는데 그 내용이 본 대화에 다 쌓이면 이후 작업이 계속 무거워진다. 서브에이전트에 맡기면 결론만 돌아온다.

쓸 자리는 셋이다 — 넓게 훑고 결론만 필요할 때, 같은 일을 여러 관점으로 각각 돌릴 때, 실패해도 본 대화가 안 다쳐야 할 때. 반대로 맥락이 계속 이어져야 하는 작업은 쪼개면 오히려 나빠진다.

이 목록은 이 리포가 갈라져 나온 원본(Njengah/claude-code-cheat-sheet)의 템플릿이고, wordpress-developer·php-developer 처럼 특정 직군에 묶인 것이 많다. 내 작업과 맞는지 확인된 바 없으므로 그대로 쓰기보다 필요한 것만 골라 다시 쓰는 편이 낫다.

원문은 legacy/subagents/*.md 에 그대로 남겨뒀다(MIT, 본문은 한국어). 쓸 만한 게 있으면 거기서 가져와 .claude/agents/ 에 두면 된다.

settings.json 의 hooks.<Event>[] 에 matcher 와 실행할 명령을 적는다. 주요 이벤트: PreToolUse(도구 호출 직전) · PostToolUse(성공 직후) · SessionStart · Stop(응답 종료).

차단은 PreToolUse 에서 exit code 2 로만 된다. stdout 이 Claude 에게 사유로 전달되므로 "왜 막혔는지"를 사람이 아니라 Claude 가 읽고 스스로 고친다. PostToolUse 는 이미 실행된 뒤라 차단이 아니라 뒷정리(포매터 등)용이다.

중요한 경계 하나 — 훅은 Claude 의 도구 호출에만 걸린다. 내가 터미널에서 직접 치는 git commit 은 막지 못한다. 그건 husky·lefthook 같은 git 훅의 몫이고, 둘은 층이 다르다.

플러그인은 슬래시 명령·스킬·훅·MCP 서버·에이전트를 한 묶음으로 배포하는 단위다. .claude-plugin/plugin.json 이 매니페스트이고, 마켓플레이스에서 설치하거나 로컬 디렉터리를 --plugin-dir 로 바로 물릴 수 있다.

직접 만들기 전에 순서를 지키면 헛수고를 줄인다 — 이미 있는 커넥터 → 마켓플레이스 플러그인 → 그래도 없으면 직접. /plugin 으로 마켓플레이스를 연다.

MCP 서버를 등록·확인·제거한다. --mcp-config 로 설정 파일이나 인라인 JSON 을 넘기면 프로젝트마다 다른 서버 구성을 쓸 수 있다.

직접 만들기 전에 순서를 지키면 헛수고를 줄인다 — 이미 있는 커넥터 → 마켓플레이스 플러그인 → 그래도 없으면 직접 MCP 서버.

대화형 /mcp 패널을 열지 않고 OAuth 흐름만 돌린다(v2.1.186+). HTTP·SSE·claude.ai 커넥터 서버에서 되고, SSH 로 붙어 있으면 --no-browser 로 인증 URL 을 출력받아 리다이렉트 URL 을 되붙인다.

세션 안에서 연결 상태를 본다. 서버가 목록에 뜨고 도구 목록이 보여야 정상이다. 안 보이면 인증이 안 됐거나 서버 프로세스가 죽은 것이다.

파일 한 장이면 /명령 하나가 생긴다. 프로젝트 전용이면 .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 로 이름을 붙여 쓴다. 리터럴 달러 기호는 백슬래시로 이스케이프한다.

가장 보수적인 값이다. Read/Glob/Grep 계열은 확인 없이 돌고 Edit/Write/Bash 는 호출마다 승인 카드가 뜬다.

카드에서 "이 명령은 다시 묻지 않기"를 고르면 그 패턴이 .claude/settings.local.json 의 permissions.allow 에 누적된다. 즉 default 로 며칠 쓰면 내 작업 패턴에 맞는 allow 목록이 저절로 만들어지고, 그 목록을 그대로 들고 상위 모드로 옮길 수 있다. 처음엔 default 로 며칠 → 쌓인 allow 확인 → 모드 상향이 실무 순서다.

Edit/Write 와 mkdir·mv 같은 기본 파일시스템 명령이 확인 없이 돈다. 네트워크 호출이나 패키지 설치처럼 바깥에 영향을 주는 동작은 여전히 물어본다.

"코드를 계속 고치는 중이라 편집 승인만 귀찮다"는 상황에 정확히 맞는 값이다. auto 로 한 번에 올리는 것보다 여기서 멈추는 편이 통제 범위를 이해하기 쉽다.

탐색 단계에서 파일이 고쳐지는 사고를 구조적으로 막는다. 낯선 코드베이스를 파악할 때, 또는 "일단 어떻게 할 건지 보고 결정하겠다"일 때 쓴다.

Ctrl+G 로 계획 결과를 편집기에서 열 수 있다. 계획에 동의하면 모드를 내려서 실행한다.

분류기의 기준은 되돌릴 수 있는가다. rm -rf, force push, 프로덕션 배포, 시크릿이 나갈 수 있는 동작은 auto 에서도 카드가 뜬다.

2026-08-14 부터 Pro/Max/Team 의 신규 세션 기본값이 이 모드로 바뀐다. 기존 세션은 재개해도 이전 모드를 유지하므로, 어느 날 갑자기 승인 카드가 덜 뜨기 시작하면 이 전환을 먼저 의심할 것.

auto 와의 차이가 핵심이다 — auto 는 판단이 안 서면 묻고 멈추지만, dontAsk 는 묻지 않고 실패한다. 무인 실행에서는 멈춤보다 실패가 낫다. 로그에 남고, 재시도할지 사람이 정할 수 있기 때문이다.

default 로 며칠 쓰며 쌓아둔 permissions.allow 목록이 여기서 그대로 재사용된다.

--dangerously-skip-permissions 와 같은 자리다. 이름에 dangerously 가 들어간 이유가 있다 — 되돌릴 수 없는 동작이 확인 없이 지나간다.

쓸 만한 자리는 하나뿐이다: 버려도 되는 컨테이너 안. 로컬 작업 디렉터리에서 "귀찮아서" 켜는 용도가 아니다. 승인 창이 잦은 게 문제라면 allow 규칙을 쌓거나 샌드박스를 켜는 쪽이 맞다.

뒤에 오는 것이 앞을 덮는 게 아니라 전부 함께 로드된다. 그래서 층을 나눠 쓴다 — 전역(~/.claude/CLAUDE.md)에는 어느 프로젝트에서나 통하는 내 작업 방식, 프로젝트(./CLAUDE.md)에는 이 리포의 규칙, CLAUDE.local.md 에는 커밋하지 않을 개인 메모.

managed policy 는 조직이 배포하는 것이라 개인 설정으로 뒤집을 수 없다.

상위 디렉터리의 CLAUDE.md 는 시작 시 전부 로드되지만, 하위 디렉터리의 것은 그 디렉터리 파일을 읽을 때 비로소 로드된다.

CLAUDE.md 가 길어지면 @docs/architecture.md 처럼 쪼개 넣는다. 최대 4단계까지 중첩 import 된다.

쪼개는 기준은 "매 세션 필요한가"다. 항상 필요한 것만 CLAUDE.md 본문에 두고, 가끔 필요한 것은 별도 파일로 두었다가 그때만 @ 로 붙이는 편이 컨텍스트를 아낀다.

/memory 는 어느 CLAUDE.md 를 고칠지 고르는 편집기를 연다. Auto Memory 는 작업 중 알게 된 것을 Claude 가 스스로 기록하는 기능이다.

자동 메모리는 기본 켜짐 — /memory 안의 토글이나 autoMemoryEnabled 설정으로 끈다. 저장 위치는 ~/.claude/projects/<프로젝트>/memory/ 이고 git 저장소 단위라 같은 리포의 worktree 들이 하나를 공유한다(머신 로컬, 클라우드 미공유). 인덱스 MEMORY.md 는 매 세션 처음 200줄/25KB만 로드되므로 짧게 유지해야 한다.

실무 팁 — 탐색을 마친 직후가 가장 좋은 기록 시점이다. 그때 적어두지 않으면 다음 세션에서 같은 탐색을 처음부터 반복하게 된다.

권한 모드가 "무엇을 물어보는가"를 정한다면, 샌드박스는 "물어보지 않고 실행돼도 어디까지 망가질 수 있는가" 를 정한다. 두 축이 독립이라 같이 쓸 때 의미가 있다 — allow 규칙을 넓히더라도 샌드박스가 반경을 잡아준다.

network.allowedDomains 가 특히 값을 한다. MCP 커넥터나 스크립트가 예상 밖의 곳으로 데이터를 보내는 경로를 도메인 화이트리스트로 막는다.

OS 기본 격리 기술을 그대로 쓴다 — macOS 는 Seatbelt, Linux/WSL2 는 bubblewrap. 별도 컨테이너 런타임을 깔지 않아도 되는 대신, 그 기술이 없는 플랫폼에서는 동작하지 않는다. Windows 에 구현이 없는 이유가 이것이다.

default 는 오버라이드 해제(계정 기본으로 복귀), best 는 조직에 Fable 5 가 있으면 Fable, 없으면 최신 Opus. [1m] 접미사는 100만 토큰 컨텍스트 창, opusplan 은 plan 모드에서 opus·실행에서 sonnet 을 쓰는 혼합 모드다.

별칭 대신 전체 이름을 박으면 모델이 갱신돼도 그 버전에 고정된다 — 재현이 중요한 스크립트·평가에서 쓴다. 대신 은퇴하면 실패하므로 --fallback-model 을 같이 걸어 둔다.

모델이 지원 안 하는 레벨을 주면 그 아래 최고 지원 레벨로 폴백한다. low~xhigh 는 대화형 세션에서 설정하면 세션 간 유지되고, max 는 CLAUDE_CODE_EFFORT_LEVEL 환경변수로 주지 않는 한 현재 세션에만 적용된다. (ultracode 는 effort 레벨이 아니라 워크플로 오케스트레이션 키워드다 — 2026-08-20 정정)

중요한 지점에서 두 번째 모델에게 조언을 구하는 도구를 이 세션에서 켠다. advisorModel 설정보다 우선한다. 별도 모델 호출이라 그만큼 비용이 늘어난다.

/model 은 새 세션의 기본값으로도 저장된다 — 이번 세션만 바꾸려면 선택기에서 그 줄에 s 를 누른다. Alt+P(모델)로 프롬프트를 비우지 않고 바꿀 수도 있다.

공백으로 여러 경로를 한 번에 준다. 파일 접근만 늘어난다 — 그 디렉터리의 .claude/ 설정 (스킬·훅·권한 규칙)은 대부분 읽지 않으므로, 설정까지 필요하면 그 폴더에서 세션을 시작해야 한다.

각 경로가 실제로 존재하는 디렉터리인지 검사한다 — 오타는 시작 시점에 걸러진다. 세션 중간에 추가하려면 /add-dir 이고, 성공하면 DirectoryAdded 훅이 돈다.

세션마다 다시 적지 않으려면 설정의 permissions.additionalDirectories 에 올린다. /add-dir 로 이 디렉터리를 추가했던 세션은 나중에 --resume·--continue 목록에도 잡힌다.

local 은 개인용(.gitignore 대상), project 는 팀 공유(커밋), user 는 내 전역. 같은 키가 겹치면 위 순서에서 앞선 층이 이긴다.

파일 첫 줄에 "$schema": "https://json.schemastore.org/claude-code-settings.json" 을 넣으면 에디터가 키 이름을 자동완성·검증해준다.

수명주기 훅도 이 파일의 hooks 키에 정의한다 — 상세는 「Hooks & 플러그인」 섹션.

--permission-mode 플래그가 이 값을 세션 단위로 덮어쓴다. bypassPermissions 는 여기 적어도 조직 정책(permissions.disableBypassPermissionsMode)이 막으면 뜨지 않는다. 데스크톱 앱은 선택기에서 고른 모드를 폴더별로 기억하고 그 폴더에서는 이 값보다 우선한다.

deny 는 모든 모드에서 막힌다 — bypassPermissions 에서도. allow 는 bypass 에선 무의미. 승인 창이 잦으면 /fewer-permission-prompts 가 이 규칙을 대신 만들어준다.

자주 쓰는 값 — ANTHROPIC_DEFAULT_OPUS_MODEL/ANTHROPIC_DEFAULT_SONNET_MODEL (모델 별칭이 가리킬 버전 고정), CLAUDE_CODE_EFFORT_LEVEL(max 를 세션 넘어 유지), MAX_THINKING_TOKENS, CLAUDE_CODE_DISABLE_AUTO_MEMORY=1.

model 은 시작 모델, availableModels 는 고를 수 있는 목록 자체를 제한한다(조직용). --model 플래그와 /model 이 그 위에서 세션 값을 정하고, 허용 목록에서 빠진 값은 무시되어 현재 모델이 유지된다.

/sandbox 로 세션마다 켜는 대신 파일에 고정한다. 나가는 네트워크는 sandbox.network.allowedDomains 로 좁힌다.

Claude 의 역할·어조·출력 형식을 바꾼다. 공식 마켓의 explanatory-output-style· learning-output-style 이 플러그인으로 배포되는 예다.

메모리를 읽을 때 특정 CLAUDE.md 를 건너뛴다. 패키지가 많은 저장소에서 관계없는 지침이 전부 딸려 오는 것을 막는 용도다 — 반대로 그 패키지에서 일할 때만 붙게 하려면 중첩 .claude/skills/ 나 스킬의 paths 를 쓴다.

자동 메모리 디렉터리는 이 청소에서 제외된다 — 기록은 사라져도 메모리는 남는다.

내 명령의 출력을 프롬프트 아래에 렌더한다. 직접 JSON 을 쓰는 대신 /statusline 에게 원하는 것을 말하거나, 인자 없이 실행해 현재 셸 프롬프트에서 자동 구성하게 할 수 있다.

attribution.commit·attribution.pr·attribution.sessionUrl 로 나눠 끄거나 바꿀 수 있다 — 커밋 트레일러는 남기고 PR 본문의 문구만 없애는 식의 조정이 가능하다.

! 로 직접 돌리는 명령의 셸을 정한다. 스킬 단위로 바꾸려면 스킬 프런트매터의 shell: powershell 이 있다 — Windows 에서 두 셸이 섞여 스크립트가 깨지는 일을 줄인다.

한도에 닿으면 오류로 종료한다 — 잘린 결과가 성공처럼 다음 단계로 흐르지 않는다. 기본값은 무제한이므로 일회성 실행에는 걸어 두는 편이 안전하다.

프린트 모드 전용. 서브에이전트의 지출도 합산된다 — 상한에 닿으면 새 서브에이전트 생성이 Budget limit reached 로 실패하고 돌던 백그라운드 서브에이전트도 중단된다(v2.1.217+).

비용이 어디서 나가는지 볼 때 쓴다. 턴 단위 출력을 전부 보여주고 viewMode 설정을 덮어쓴다.

유료 플랜에서는 스킬·서브에이전트·플러그인·MCP 서버별 내역까지 쪼개 준다. 플랜 사용량은 터미널·데스크톱·웹이 공유하는 값이다. /stats 도 같은 것을 연다.

권한 모드보다 강한 층이다. 모드는 "무엇을 물어보는가"를 정하지만 이 규칙은 무엇이 아예 불가능한가를 정한다.

--disallowedTools 가 특히 값을 한다. allow 목록은 승인 카드를 누르다 보면 실수로 넓어질 수 있지만 disallow 는 우회되지 않으므로, 되돌릴 수 없는 명령은 여기서 상시 차단한다.

이미 진행 중인 대화를 떼어낼 때 쓴다. --bg 가 "처음부터 백그라운드"라면 /background 는 "하던 걸 백그라운드로". /tasks 로 목록을, Ctrl+T 로 토글한다.

비슷해 보이지만 다른 것 — /fork 는 대화를 복사해 새 백그라운드 세션을 만든다. 원본을 남겨두고 다른 접근을 병렬로 시험할 때 이쪽이다.

사람이 읽는 출력 대신 파싱 가능한 출력을 받는다. 자동화의 출발점이고, jq 로 바로 필드를 꺼낼 수 있다. 세션 ID 를 여기서 뽑아 다음 호출로 이어 붙이는 패턴이 흔하다.

한 번에 다 받지 않고 오는 대로 처리한다. 오래 걸리는 작업의 진행을 보여줘야 하거나, 출력이 커서 메모리에 다 올리기 곤란할 때 쓴다.

표준입력으로 메시지를 흘려 넣는다. 작업 중에 보낸 메시지는 큐에 남아 자기 턴으로 실행되고, 그 턴은 자기 --max-turns 한도를 따로 갖는다. 보낸 것을 확인받으려면 --replay-user-messages 로 되돌려 받는다.

스키마를 주면 모델이 그 형태를 지키도록 강제되고, 어긋나면 재시도한다. --output-format json 만으로는 필드 이름이 흔들릴 수 있어서 파싱 코드가 깨진다. 결과를 프로그램이 소비할 거면 이쪽이 맞다.

한도에 닿으면 오류로 종료하므로 잘린 결과가 성공처럼 흐르지 않는다. 돈으로도 막으려면 --max-budget-usd 를 같이 건다(서브에이전트 지출까지 합산된다).

프린트 모드는 한 번 돌고 끝난다. 셋을 같이 걸어야 안전하다 — 권한 모드(--permission-mode), 출력 형식(--output-format), 상한(--max-turns· --max-budget-usd). 상한에 닿으면 오류로 종료하므로 잘린 결과가 조용히 다음 단계로 흐르지 않는다.

시작을 빠르게 하려면 --bare 로 훅·스킬·MCP 자동 탐색을 건너뛴다. 이렇게 만든 -p 세션은 나중에 --continue 로 잡히지 않는다(claude -p --continue 는 포함한다).

managed-settings.json 이 최상단이라 개인 설정으로 뒤집을 수 없다. 조직이 배포하는 정책이고, 그 아래로 CLI 인자 → 프로젝트 local → 프로젝트 → 사용자 순이다.

개인 프로젝트에서 이 순서가 중요한 이유는 따로 있다 — .claude/settings.local.json 이 .claude/settings.json 을 덮으므로, 팀과 공유할 규칙은 local 이 아닌 쪽에 둬야 한다.

기본 규칙은 claude auto-mode defaults 로 JSON 으로 볼 수 있고(--label 'Git Destructive' 처럼 접두어로 걸러서), 내 설정이 적용된 실효 구성은 claude auto-mode config 다. 조직은 관리 설정의 autoMode 로 무엇을 신뢰·차단할지 조정하고 disableAutoMode 로 끈다.

되돌리려면 claude auto-mode reset(사용자 설정의 autoMode 섹션 제거, 확인 후 실행).

나가는 트래픽을 도메인 화이트리스트로 막는다. MCP 커넥터나 스크립트가 예상 밖의 곳으로 데이터를 보내는 경로를 차단하는 가장 직접적인 수단이다.

비용 문제만이 아니다 — 이전 작업의 파일 내용이 남아 있으면 다음 작업에서 엉뚱한 파일을 고칠 위험이 같이 생긴다. 이어가야 하는 대화라면 /clear 가 아니라 /compact 다.

프린트 모드 전용이고 한도에 닿으면 오류로 종료한다. 돈으로 막는 쪽은 --max-budget-usd 이고 서브에이전트 지출까지 합산된다 — 둘을 같이 거는 편이 안전하다.

압축은 정보를 잃는다. 방금 확인한 실측 수치나 파일 내용이 요약에 날아가면 그 다음 판단이 근거 없이 이뤄진다 — 중요한 숫자는 압축 전에 파일로 남긴다. 자동 압축 기준은 /autocompact 나 --autocompact 로 정한다.

범위를 준 규칙이 낫다 — Bash(rm *) 처럼 쓰면 Bash 는 남고 그 호출만 막힌다. 이름만 주면 도구가 컨텍스트에서 통째로 사라진다. 세션마다 다시 주지 않으려면 설정 파일의 deny 규칙으로 올린다.

/permissions 로 스코프별 규칙을 보고, 쓰지 않는 스킬·MCP 서버·플러그인은 /doctor 가 그 컨텍스트 비용과 함께 지목해 준다. 버전은 /doctor 가 릴리스 채널을 보고 알려준다.

내 커스터마이제이션(CLAUDE.md·스킬·플러그인·훅·MCP)이 원인인지 아닌지를 한 번의 실행으로 가른다. --safe-mode 로 되면 원인은 내 설정 쪽이고, 그래도 안 되면 설치·인증·네트워크 쪽이다. 속도를 위해 최소로 띄우는 --bare 와 목적이 다르다.

지금은 스킬이 정본이다 — .claude/skills/<name>/SKILL.md. .claude/commands/*.md 도 계속 동작하지만 이름이 겹치면 스킬이 이긴다. 스킬은 디렉터리라 보조 파일을 담고 프런트매터로 도구·모델·강도까지 정할 수 있다.

형식이 스키마까지 필요하면 --json-schema 를 쓴다 — 스키마에 맞지 않으면 오류로 종료하므로 파이프 뒤쪽이 깨진 값을 받지 않는다. 진행을 흘려 받아야 하면 stream-json 이다.

cat file | claude -p "..." 처럼 표준입력을 넘긴다. 여러 사람·여러 기기가 같은 작업을 돌린다면 --exclude-dynamic-system-prompt-sections 로 프롬프트 캐시 재사용률을 올릴 수 있다.

--session-id 로 ID 를 직접 정하면 나중에 스크립트가 그 세션을 다시 찾을 수 있고, --name 은 사람이 /resume 목록에서 알아볼 이름을 붙인다. 오래 걸리는 것은 --bg 로 떼어내고 claude agents 로 확인한다.

문서 대신 실행되는 것으로 남기는 편이 낫다 — 반복 절차는 스킬로, 자동 검사는 훅으로, 묶어 배포할 것은 플러그인으로. 지침이 지켜지길 바라는 것과 하네스가 강제하는 것은 다르다.

같은 저장소에서 세션 여러 개를 돌리면 서로의 편집이 섞인다. -w 는 <repo>/.claude/worktrees/<name> 에 격리된 워크트리를 만들고, #123 이나 PR URL 을 주면 그 PR 에서 분기한다. 커밋할 때는 git commit -- <경로> 로 지금 의도한 파일만 넣는다.

처음 붙는 사람에게 가장 빠른 것은 /powerup 이다 — 애니메이션 데모가 붙은 짧은 레슨으로 기능을 하나씩 눌러 본다. 그 다음은 /init 으로 CLAUDE.md 를 만들고 /clear 습관을 붙이는 것.

권한은 우회(--dangerously-skip-permissions)가 아니라 좁혀서 여는 것부터 익히는 게 맞다 — /fewer-permission-prompts 로 실제로 쓴 호출만 허용 목록에 올리는 흐름. 커스텀 명령은 이제 스킬이 정본(.claude/skills/<name>/SKILL.md)이다.

"매번 X 하게" 같은 자동 동작은 지침이 아니라 훅이 담당한다(하네스가 실행한다). 병렬 작업은 --worktree 로 격리하고, 오래 걸리는 것은 --bg 로 떼어낸다. 팀에 배포할 것은 스킬 → 플러그인 순으로 올린다.