설치 직후 PATH 가 반영되지 않으면 새 터미널 창을 열어야 한다 — 이미 열려 있던 창에는 적용되지 않는다. "다른 설치가 진행 중"이라는 오류가 근거 없이 뜨면 설치 관리자를 관리자 권한으로 실행한다.

베타다. 업데이트는 패키지 관리자로 하고(자동 업데이트가 아니다), Computer Use 는 아직 Linux 앱에 없다.

설치 후 앱을 실행하고 Anthropic 계정으로 로그인한다. 세 탭 중 Code 탭을 클릭해서 소프트웨어 개발 기능을 사용한다. CLI와 세션과 설정을 공유한다.

CLI 와 같은 엔진에 그래픽 인터페이스를 얹은 것이라, 같은 기기·같은 프로젝트에서 둘을 동시에 돌려도 된다. 세션 이력만 각자 따로 남고 설정과 CLAUDE.md 는 공유한다.

버전 번호를 클릭하면 클립보드로 복사된다. 문제를 신고할 때는 앱 버전·OS·정확한 오류 메시지를 함께 넣는다. 패널 배치·터미널·파일 편집기·뷰 모드는 v1.2581.0 이상에서만 있다.

일반적인 텍스트 대화를 위한 탭. 코드 작성 없이 아이디어를 브레인스토밍하거나 설명을 요청할 때 사용한다.

장기 실행 작업과 에이전트 협업을 위한 탭. 백그라운드 작업을 관리하고 여러 에이전트가 같은 작업에 협력할 수 있다.

스킬·플러그인·커넥터의 출처가 Code 탭과 다르다 — Cowork 는 사이드바의 Customize 설정(claude.ai 계정으로 동기화)에서 가져오고, CLI 의 ~/.claude 디렉터리를 읽지 않는다. Dispatch 도 이 탭에 산다.

소프트웨어 개발을 위한 전용 탭. 파일 읽기·쓰기, 명령 실행, Git 작업 등 개발에 필요한 모든 기능이 여기에 있다. 이 치트시트는 주로 이 탭을 기준으로 작성되었다.

첫 메시지를 보내기 전에 정하는 값이고, 이후 기능 가용성의 대부분이 여기서 갈린다. @멘션·커넥터·플러그인·터미널·사이드 채팅이 환경에 따라 있거나 없다. Cloud 는 앱을 닫아도 계속 돌고, SSH 는 원격 머신에서 돌고, WSL 은 Windows 의 리눅스 쪽에서 돈다.

여기서 고른 폴더가 프리뷰 서버의 작업 디렉터리도 된다 — 부모 폴더를 고르면 하위 폴더의 dev 서버는 자동 감지되지 않는다. 클라우드 세션은 저장소를 여러 개 붙일 수 있다.

CLI 의 --model 과 ANTHROPIC_MODEL 환경변수에 대응한다. 세션 중간에 같은 드롭다운에서 바꿀 수 있고, 사용 가능한 모델 목록은 CLI 와 같다.

새 로컬 세션의 기본값은 설정 파일의 permissions.defaultMode 로 정한다. 선택기에서 고른 모드는 폴더별로 기억되고 그 폴더에서는 defaultMode 보다 우선한다 — Plan 만 예외로 현재 세션에만 적용된다.

설정 키는 default. 편집·명령 전에 매번 묻고, diff 를 보고 건별로 수락·거부한다. 예전 버전에서는 이 모드가 Ask permissions 라는 이름이었다.

설정 키는 acceptEdits. 파일 편집과 mkdir·touch·mv 같은 기본 파일시스템 명령은 자동 승인하고, 그 밖의 터미널 명령은 여전히 묻는다. 예전 이름은 Auto accept edits.

설정 키는 plan. 파일을 읽고 명령으로 탐색하되 소스는 고치지 않고 계획을 제시한다. 복잡한 작업은 Plan 으로 시작해 접근을 합의한 뒤 Accept edits 나 Manual 로 옮겨 실행하는 순서가 권장된다. 폴더별 기억 대상이 아니라 현재 세션에만 적용된다.

설정 키는 auto. 요청과의 정합성을 백그라운드 분류기가 검사하면서 대부분을 자동 실행한다 — 감독을 유지한 채 확인 횟수만 줄이는 쪽이다.

계정 조건을 만족하면 선택기에 나타나고 별도 설정 토글은 없다. Anthropic API 에서는 전체 사용자에게 열려 있고 Opus 4.6+ · Sonnet 4.6+ · Fable 5 가 필요하다. 조직은 disableAutoMode 로 끌 수 있다.

설정 키는 bypassPermissions, CLI 의 --dangerously-skip-permissions 와 같다. 그래도 예외는 남는다 — 어떤 모드도 자동 승인하지 않는 행위, 외부 사이트에서의 안전 분류기, 세션 보관처럼 데스크톱이 항상 먼저 묻는 조작.

클라우드 세션은 파일 편집을 미리 승인하므로 선택기에 Manual 대신 Accept edits 가 뜨고, 그것이 default 모드에 대응한다. Bypass permissions 는 없다. 엔터프라이즈 관리자는 어떤 모드를 쓸 수 있는지 제한할 수 있다.

키보드로는 Esc. 진행 중인 도구 호출까지 끊는다.

CLI 에는 없는 기능이다. 버그 스크린샷, 디자인 목업, 참고 문서를 그대로 넘길 때 쓴다. 첨부 버튼으로도 되고 입력창에 끌어다 놓아도 된다.

커넥터와 플러그인 항목은 로컬·SSH 세션에서만 뜬다(클라우드·WSL 에는 없다). 스킬은 / 를 직접 입력해 찾는 것과 같은 목록이다.

고르면 입력창에 강조된 채로 들어가고, 뒤에 할 일을 이어 적어 보낸다. Claude 가 작업 중일 때도 다른 메시지처럼 보낼 수 있다(v2.1.206+). 그 전 버전에서는 턴 중간에 보낸 명령이 세션을 실행 중 상태로 붙잡아 이후 메시지가 전달되지 않았다.

데스크톱은 컨텍스트가 차면 자동으로 요약하고 계속 진행한다 — /compact 는 그 시점을 앞당겨 직접 부르는 것이다. 사용량은 모델 선택기 옆 사용량 링에서도 볼 수 있다.

데스크톱에서는 diff 를 명령 없이도 볼 수 있다 — 변경 후 뜨는 +12 -1 표시를 클릭하거나 Cmd/Ctrl+Shift+D 로 diff 패널을 연다.

셋 다 UI 에 대응 메뉴가 있다 — Cmd/Ctrl+Shift+I(모델), Cmd/Ctrl+Shift+E(추론 강도), Cmd/Ctrl+Shift+M(권한 모드). 열린 메뉴에서는 1~9 로 바로 고른다.

이름 변경은 상단 툴바의 세션 제목을 클릭해서도 된다. 며칠 뒤 사이드바에서 찾을 때 이름이 붙어 있는지가 갈린다.

diff 뷰어 우상단의 Review code 버튼이 같은 성격의 UI 진입점이다. 그쪽은 컴파일 오류·명백한 논리 오류·보안 취약점·확실한 버그에 집중하고 스타일은 보지 않는다.

/tasks 가 여는 것과 같은 내용을 Views 메뉴의 Tasks 패널로 상시 띄워 둘 수 있다 — 서브에이전트·백그라운드 셸·동적 워크플로의 진행이 여기 모인다.

정기 반복은 데스크톱에는 Scheduled tasks 라는 별도 기능이 있다 — CLI 에서 cron·CI 로 하던 자리다. /insights 는 이 기기의 기록을 분석하므로 클라우드 세션에서는 못 쓴다.

Cmd/Ctrl+; 와 같은 것을 연다. 본 대화 컨텍스트는 읽지만 기록에는 남지 않는다.

터미널에서 실행하면 세션을 저장해 데스크톱 앱에서 열고 CLI 는 종료된다. macOS 와 x64 Windows, Claude 구독 로그인에서만 된다 — API 키 인증이나 Bedrock·Agent Platform·Foundry 에서는 쓸 수 없다.

MCP 는 데스크톱에서 Connectors UI 로도 관리된다. 사용량은 사용량 링이 같은 정보를 준다.

세션 툴바의 서버 드롭다운에서 시작·중지, 전체 중지, 그리고 Edit configuration 으로 .claude/launch.json 을 편집기에서 열 수 있다.

서버 드롭다운에서 켠다. 개발 중에 매번 다시 로그인하지 않아도 되는 것이 요점이다. 저장된 세션 데이터를 지우거나 Browser 를 아예 끄는 것은 설정 → Claude Code 쪽이다.

Browser pane 은 탭 브라우저다. 돌고 있는 앱 옆에 문서·이슈 트래커를 나란히 둘 수 있다. 채팅의 외부 링크를 클릭하면 앱 안에서 열지(Open in app) 기본 브라우저로 보낼지 묻고, Cmd(macOS)·Ctrl(Windows) 클릭은 곧바로 시스템 브라우저로 보낸다.

줄을 클릭하면 코멘트 상자가 열리고 Enter 로 코멘트가 붙는다. 여러 줄에 달아 두고 Cmd/Ctrl+Enter 로 한꺼번에 제출하면 Claude 가 그것들을 읽고 고친 결과를 새 diff 로 준다.

한 건씩 말로 지시하는 것보다 이쪽이 낫다 — 지적이 코드 위치에 붙어 있어 어디를 말하는지가 해석 대상이 되지 않는다.

diff 뷰어 우상단에 있다. 커밋 전에 변경을 평가하게 하고, 코멘트가 diff 뷰어 안에 달린다. 각 코멘트에 답하거나 수정을 요청할 수 있다.

보는 것: 컴파일 오류, 확실한 논리 오류, 보안 취약점, 명백한 버그. 보지 않는 것: 스타일·서식·기존 문제·린터가 잡을 것.

CI 상태 바의 토글로 켠다. 실패 출력을 읽고 고침을 반복한다 — 터미널 쪽 /autofix-pr 이 클라우드 세션으로 같은 일을 맡기는 형태다.

병합 방식은 squash 고정이다. GitHub 저장소 설정에서 auto-merge 를 먼저 켜 두지 않으면 Claude 가 병합할 수 없다 — 토글은 켜지지만 병합이 되지 않는 상태가 된다.

CI 가 끝나면 OS 알림이 온다. PR 이 병합·닫히면 세션까지 자동으로 보관하려면 설정 → Claude Code 의 auto-archive 를 켠다(로컬 세션 중 실행이 끝난 것에만 적용된다).

Code 탭 자체가 이 패널들을 임의 배치하는 구조로 되어 있다. CLI 와 데스크톱을 나누는 실질적인 차이가 이것이다 — 같은 엔진이지만 변경·미리보기·터미널을 한 화면에 나란히 둘 수 있다.

패널 배치·터미널·파일 편집기·뷰 모드는 Claude Desktop v1.2581.0 이상이 필요하다. macOS 는 Claude → Check for Updates, Windows 는 Help → Check for Updates.

세션 툴바의 Views 메뉴에서 패널을 추가한다. tasks·subagent 패널은 여기서만 열 수 있고, 이 둘이 백그라운드 작업의 진행과 출력을 보는 창구다.

세션 두 개를 분할해 보고 있을 때도 같은 키로 포커스된 쪽을 닫아 단일 세션으로 돌아온다.

로컬·SSH 세션에서만 된다(클라우드 세션은 Claude 에게 고치라고 하는 편이 맞다). HTML·PDF·이미지·영상은 파일 패널이 아니라 Browser pane 으로 열린다.

열어 둔 사이에 디스크에서 파일이 바뀌면 경고가 뜨고 덮어쓰기·버리기를 고르게 한다. 패널 헤더의 경로를 클릭하면 절대경로가 복사된다.

기본값. 도구 호출은 요약으로 접히고 텍스트 응답은 전문이 보인다.

Claude 가 왜 그 행동을 했는지 따질 때 쓴다. 모든 도구 호출·파일 읽기·중간 단계가 보인다. CLI 의 --verbose 에 대응한다.

세션을 여러 개 돌리며 결과만 빠르게 훑을 때 쓴다. 최종 응답과 변경만 남는다.

전송 버튼 옆 Transcript view 드롭다운에서도 고른다. Ctrl+O 는 macOS·Windows 모두 Ctrl 이다(Cmd 가 아니다).

Code 탭에서 쓸 수 있는 단축키 전체를 앱 안에서 띄운다. 아래 표가 낡았을 때의 정본이다.

정확히는 Ctrl+Tab / Ctrl+Shift+Tab 이고, 세션 순환·터미널 토글·뷰 모드 토글은 모든 플랫폼에서 Ctrl 이다(macOS 에서도 Cmd 가 아니다).

Ctrl+Tab 이 터미널 에뮬레이터나 창 관리자에 먹히는 환경에서 쓸 수 있는 같은 동작의 키다.

Browser pane 에서 요소를 집어 대화에 넘긴다 — "이 버튼"을 말로 설명하는 대신 지목한다.

모델(Cmd/Ctrl+Shift+I)·권한 모드(Cmd/Ctrl+Shift+M)·추론 강도(Cmd/Ctrl+Shift+E) 메뉴를 열고 숫자만 눌러 고르는 흐름이 가장 빠르다.

두 숫자의 층이 다르다. 컨텍스트 사용량은 세션별이고, 플랜 사용량은 모든 Claude Code 서피스가 공유한다 — 터미널에서 쓴 것도 여기 합산된다.

컨텍스트가 차면 데스크톱은 자동으로 대화를 요약하고 계속 간다. 그 시점을 앞당기려면 /compact 를 직접 부른다.

클라우드 세션도 별도의 컴퓨트 요금이 붙지 않고 구독 플랜 한도에 들어간다. 앱을 닫아도 계속 도는 성질과 합치면, 오래 걸리는 작업을 로컬에 붙잡아 둘 이유가 적다.

가장 넓고 가장 느린 수단이다. Claude 는 정밀한 것부터 시도한다 — 커넥터가 있으면 커넥터, 셸 명령이면 Bash, 브라우저 작업이고 Claude in Chrome 이 있으면 그것, iOS 앱 실행·테스트면 iOS 시뮬레이터 패널, 그 어느 것도 아닐 때 화면 조작이다.

그래서 화면 조작이 남는 자리는 다른 수단이 닿지 못하는 것 — 네이티브 앱, 하드웨어 제어판, API 없는 사내 도구다.

앱을 처음 쓸 때 세션에 카드가 뜨고 Allow for this session 또는 Deny 를 고른다.

설정 → General 에 두 가지가 더 있다 — Denied apps 는 묻지도 않고 거부할 앱 목록, Unhide apps when Claude finishes 는 작업 중 숨겨 둔 다른 창을 끝나고 되돌릴지 여부다 (작업 중에는 승인된 앱만 다루도록 나머지 창을 숨긴다).

iOS 앱을 돌리고 테스트할 때는 화면 조작이 아니라 전용 패널이 열린다. 이 패널은 computer use 를 켜지 않아도 쓸 수 있다. 조직은 disableMobileSimulatorTools 로 Claude 의 접근만 막을 수 있고(사람의 조작은 남는다).

사이드바의 + New session 과 같다. 세션마다 컨텍스트와 변경이 독립이다. 상단 컨트롤로 상태·프로젝트·환경별 필터와 프로젝트별 묶어 보기를 쓸 수 있고, 이름 변경은 활성 세션 툴바의 제목을 클릭해서 한다.

작업이 끝났는데 내가 그 세션을 보고 있지 않으면 OS 알림이 온다.

기본 위치는 <프로젝트 루트>/.claude/worktrees/ 이고, 설정 → Claude Code 의 Worktree location 에서 바꿀 수 있다. 브랜치 이름 앞에 붙일 접두어도 정할 수 있어 Claude 가 만든 브랜치를 묶어 두기 쉽다.

.env 처럼 gitignore 된 파일을 새 워크트리에 넣어야 하면 프로젝트 루트에 .worktreeinclude 파일을 만든다 — 이것을 모르면 새 세션마다 환경변수가 없어 서버가 안 뜬다.

분할 중에 사이드바의 다른 세션을 클릭하면 포커스가 있는 쪽이 교체된다. Cmd/Ctrl+\ 로 포커스된 패널을 닫으면 단일 세션으로 돌아온다.

한쪽 방향으로만 통한다 — 그 시점까지의 본 대화를 읽지만, 여기서 주고받은 것은 본 대화에 아무것도 남기지 않는다. 코드 한 조각을 이해하거나 가정을 확인하려고 본 작업의 방향을 틀지 않아도 되는 것이 요점이다.

끝나면 닫고 본 세션을 이어 간다. 디스크에 저장되지 않으므로 앱을 닫으면 돌아갈 수 없다 — 남겨야 하는 결론은 본 대화로 옮겨 적어야 한다.

데스크톱 앱이 직접 돌리는 세션만 보인다 — Code 탭의 로컬·SSH·WSL 세션. 클라우드 세션, 터미널 CLI 로 띄운 세션, VS Code 확장의 세션은 같은 프로젝트의 워크트리라도 보이지 않는다(터미널 워크트리 9개와 데스크톱 세션 2개가 열려 있으면, 한쪽에서 물었을 때 나머지 데스크톱 세션 1개만 답한다).

기본은 최근 활동 20개이고 보관된 것은 요청해야 포함된다. 지금 묻고 있는 세션 자신은 절대 목록에 넣지 않는다. 터미널 세션까지 메시지를 보내려면 교차 세션 메시징 쪽이다.

현재 작업 범위를 벗어나지만 고칠 만한 것을 발견하면 Claude 가 칩으로 제안한다. 누르면 자기 워크트리를 가진 새 세션에서 그 일이 시작되고, 지금 세션은 끊기지 않는다. 본 작업의 diff 를 부풀리지 않고 발견을 남기는 장치다.

클라우드 환경을 고른 뒤 저장소 칩 옆 + 로 추가하고, 저장소마다 브랜치 선택기가 따로 붙는다. 공용 라이브러리와 그것을 쓰는 쪽을 함께 고치는 작업에 쓴다. CLI 의 --add-dir 에 해당하는 자리다.

세션 툴바 오른쪽 아래의 VS Code 아이콘에서 연다.

웹으로 보내기 — 브랜치를 푸시하고 대화 요약을 만들어 전체 맥락을 가진 클라우드 세션을 새로 만든다. 로컬 세션은 보관하거나 남겨 둘 수 있다. 작업 트리가 깨끗해야 하고 SSH 세션에서는 쓸 수 없다.

IDE 로 열기 — 현재 작업 디렉터리에서 프로젝트를 지원 IDE 로 연다.

클라우드 세션은 내 기기에 없는 브랜치를 만들 수 있다. CLI 에서 열려다 "Branch doesn't exist yet" 이 나오면 세션 툴바의 브랜치 이름을 클릭해 복사한 뒤 가져온다.

터미널에서 떨어져 있을 때 쓰는 여러 방법 중 하나다 — 원격 제어(/remote-control)나 웹 세션과는 성격이 다르다. 이쪽은 일을 던져 두고 결과를 기다리는 형태다.

computer use 를 켜 두면 Dispatch 가 띄운 Code 세션도 화면 조작을 쓸 수 있는데, 이때 앱 승인이 30분마다 만료되고 다시 묻는다(일반 세션은 세션 내내 유지).

커넥터는 그래픽 설정 흐름이 붙은 MCP 서버다. 목록에 있는 서비스는 이쪽이 빠르고, 없는 것은 설정 파일로 MCP 서버를 직접 붙인다. 세션 시작 전에도 중간에도 추가할 수 있다.

붙이면 캘린더를 읽고 메시지를 보내고 이슈를 만드는 일을 바로 시킬 수 있다. 지금 세션에 무엇이 붙어 있는지 Claude 에게 물어봐도 된다.

프롬프트 박스의 Connectors 메뉴에서 Manage connectors 로도 같은 화면에 간다. 클라우드·WSL 세션에는 + 버튼이 없고, 클라우드에서 커넥터가 필요하면 루틴을 만들 때 함께 지정한다.

사이드바의 Customize 에서 셋을 함께 관리한다. 주의할 점은 출처다 — Cowork 탭은 이 Customize 설정(claude.ai 계정 동기화)에서 스킬·플러그인·커넥터를 가져오고, CLI 의 ~/.claude 디렉터리를 읽지 않는다. Code 탭의 로컬 세션과 서로 다른 목록을 볼 수 있다.

어느 스킬이 보이는지가 환경에 따라 다르다. 로컬 세션은 ~/.claude/skills/ 의 개인 스킬, SSH 세션은 원격 호스트의 ~/.claude/skills/(내 기기가 아니다), 클라우드 세션은 claude.ai 계정에서 켠 스킬을 불러온다.

터미널 없이 설치할 수 있다. Add plugin 이 플러그인 브라우저를 열고 설정된 마켓 (공식 Anthropic 마켓 포함)의 목록을 보여준다. Manage plugins 로 활성·비활성·삭제. 스코프는 CLI 와 같이 user·project·local 중에서 고른다.

정확히는 플러그인 브라우저가 클라우드 세션에 없고, 데스크톱에서 설치한 플러그인도 클라우드 세션에서는 쓰이지 않는다. 클라우드에서 쓰려면 둘 중 하나다 — 저장소 .claude/settings.json 의 enabledPlugins 에 적어 세션 시작 때 설치되게 하거나, claude.ai 계정에서 켜서 동기화된 플러그인으로 불러오게 하는 것. WSL 세션에는 아예 없다.

runtimeExecutable 은 npm·yarn·node 처럼 실행할 명령이다. 파일은 세션을 시작할 때 고른 폴더의 루트에 저장되고 그 폴더가 프리뷰의 작업 디렉터리가 된다 — 부모 폴더로 세션을 열면 하위 폴더의 dev 서버는 자동 감지되지 않는다.

configurations 배열에 여러 개를 정의해 프런트엔드와 API 를 같이 띄울 수 있다.

runtimeArgs 는 runtimeExecutable 에 넘기는 인자(["run", "dev"]), args 는 program 을 쓸 때만 쓰이는 인자다.

비워 두면 3000 이다. Claude 가 다른 포트를 잡게 되면 PORT 환경변수로 그 값을 서버에 넘긴다 — 서버가 그 변수를 읽지 않으면 엉뚱한 포트를 계속 열게 된다.

cwd 는 프로젝트 루트 기준 상대 경로이고, 루트를 명시하려면 ${workspaceFolder} 를 쓴다. env 는 { "NODE_ENV": "development" } 같은 추가 환경변수다.

세 가지 상태가 있고 기본값이 "묻는다" 라는 점이 중요하다.

true — 빈 포트를 찾아 쓴다(대부분의 dev 서버에 적합). false — 오류로 실패한다. OAuth 콜백이나 CORS 허용 목록처럼 그 포트여야 하는 서버에 쓴다. 지정하지 않음 — 그 포트가 꼭 필요한지 한 번 묻고 답을 저장한다.

program 은 node 로 바로 돌릴 단독 스크립트다("program": "server.js" → node server.js). 패키지 매니저를 거쳐 띄우는 것은 runtimeExecutable 쪽이다.

url 은 http://localhost:<port> 대신 열 주소다 — 로컬 HTTPS, *.localhost 서브도메인, 리다이렉트로 로그인하는 앱이 여기 해당한다. localhost 주소는 오리진만 허용된다 (경로·쿼리 불가, 포트는 항목의 port 와 일치해야 한다). 특정 페이지를 보려면 프리뷰가 열린 뒤 이동을 요청한다.

명령 없이 url 만 두면 내가 이미 돌리고 있는 서버에 프리뷰를 붙인다.

autoVerify 는 configurations 안이 아니라 최상위에 둔다. 켜져 있으면 파일을 고칠 때마다 스크린샷을 찍고 오류를 확인하고 동작을 검증한 뒤 응답을 끝낸다.

끄더라도 프리뷰 도구는 남아 있어 언제든 검증을 요청할 수 있다 — 자동인지 수동인지의 차이다.

앱이 내 셸 환경을 전부 물려받지는 않는다. macOS 에서 Dock·Finder 로 실행하면 ~/.zshrc·~/.bashrc 를 읽되 PATH 와 정해진 몇 개의 Claude Code 변수만 가져오고, 거기서 export 한 다른 변수는 오지 않는다. Windows 는 사용자·시스템 환경변수는 물려받지만 PowerShell 프로필은 읽지 않는다.

그래서 변수를 넣는 자리가 따로 있다 — 프롬프트 박스의 환경 드롭다운에서 Local 에 마우스를 올리고 톱니 아이콘을 누르면 로컬 환경변수 편집기가 열린다. 여기 넣은 값은 암호화되어 저장되고 모든 로컬 세션과 프리뷰 서버에 적용된다. ~/.claude/settings.json 의 env 키는 Claude 세션에만 닿고 dev 서버에는 닿지 않는다.

사용량은 구독 플랜 한도에 합산되고 별도 컴퓨트 과금은 없다. 네트워크 접근 수준과 환경변수가 다른 커스텀 클라우드 환경을 만들 수 있다 — 클라우드 세션을 시작할 때 환경 드롭다운에서 Add cloud environment.

제약도 함께 온다: @멘션·커넥터·플러그인 브라우저·터미널·파일 편집기·사이드 채팅이 없고, 권한 모드는 Accept edits·Plan·Auto 만 있다.

환경 드롭다운의 + Add SSH connection 으로 추가한다. 물어보는 값은 넷 — Name(표시용 이름), SSH Host(user@hostname 또는 ~/.ssh/config 의 호스트), SSH Port(비우면 22 또는 SSH 설정의 값), Identity File(비우면 기본 키·SSH 설정).

원격은 Linux 또는 macOS 여야 하고, 처음 붙을 때 Claude Code 를 자동으로 설치한다. 붙은 뒤에는 권한 모드·커넥터·플러그인·MCP 서버가 다 된다. 스킬은 원격 홈의 ~/.claude/skills/ 를 읽는다.

WSL 2 배포판 안에서 그쪽 리눅스 툴체인과 네이티브 경로를 쓴다. @멘션·커넥터·플러그인은 WSL 세션에 없다(사이드 채팅은 된다).

조직 단위로 SSO 를 필수화할 수 있다. SAML 설정은 지원 문서, OIDC 는 엔터프라이즈 관리자 가이드에 있다.

앱 코드와 사용자 콘텐츠를 Anthropic CDN 에서 받으므로 이들이 막히면 빈 화면이 된다. 와일드카드까지 포함한 목록에 *.claudemcpcontent.com 도 있다.

트래픽은 443 HTTPS 다 — OTLP 모니터링·LLM 게이트웨이·MCP 서버에 사용자 지정 포트를 쓰는 경우만 예외다.

api.anthropic.com · a-api.anthropic.com · a-cdn.anthropic.com · s-cdn.anthropic.com · assets-proxy.anthropic.com · a.claude.ai · a-cdn.claude.ai · assets.claude.ai · downloads.claude.ai · platform.claude.com 처럼 개별 호스트로 좁힐 수 있다.

와일드카드로 남겨야 하는 것: *.livepreview.claude.ai · *.livepreview.claude.app · *.claudeusercontent.com · *.claudemcpcontent.com.

정확히는 로컬·SSH 세션은 배포에 설정된 모델 공급자(기본은 Anthropic API)로 대화와 코드 컨텍스트를 보내고, 클라우드 세션은 Anthropic API 로 보낸다. 조직이 자체 호스팅 환경으로 라우팅하면 클라우드 세션의 실행 위치가 그쪽으로 바뀐다.

데스크톱은 세션이 사이드바에 상시 늘어서 있으므로 재개가 곧 클릭이다. 상태·프로젝트·환경으로 걸러 볼 수 있다.

Cmd/Ctrl+Shift+M 으로 열고 1~9 로 고른다. 고른 값은 폴더별로 기억된다.

Pro·Max 는 설정 → Claude Code 의 Allow bypass permissions mode 를 먼저 켜야 선택기에 나타나고, Team·Enterprise 는 개인 토글이 없고 조직 정책이 정한다.

클라우드 세션에만 있는 대응이다. 로컬 세션에서 다른 폴더를 붙이는 UI 는 없으므로, 필요하면 그 폴더에서 세션을 새로 시작하거나 CLI 를 쓴다.

세션 단위로 도구를 열고 닫는 UI 가 없다. 다만 설정 파일의 권한 규칙은 데스크톱 세션에도 그대로 적용된다 — ~/.claude/settings.json 이나 프로젝트 설정에 규칙으로 적는다.

데스크톱은 대화형 전용이다. 스크립팅·자동화는 CLI 의 --print 나 Agent SDK 쪽이고, 이 축은 데스크톱으로 옮겨오지 않는다.

환경변수로 모델을 고정하는 대신 드롭다운에서 고른다. 세션 중간에도 같은 곳에서 바꾼다.

확장 사고는 기본 켜짐이다. Anthropic API 에서 끄려면 로컬 환경변수 편집기에서 이 값을 0 으로 둔다 — 단, Fable 5 는 항상 확장 사고를 쓰므로 효과가 없다.

적응형 추론을 쓰는 모델에서는 0 이외의 값이 무시된다(추론 깊이를 적응형이 정한다). Opus 4.6·Sonnet 4.6 에서 고정 예산으로 돌리려면 CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1. Fable 5·Sonnet 5·Opus 4.7 이상은 항상 적응형이고 고정 예산 모드가 없다.

데스크톱은 Manual·Accept edits·Plan·Auto 이고, Bypass permissions 는 조건을 만족하면 선택기에 추가된다. dontAsk(미리 승인한 도구만 허용)는 CLI 전용이다.

데스크톱을 Bedrock·Agent Platform·Foundry 나 자체 호스팅 LLM 게이트웨이로 돌리는 경로는 따로 있다(게이트웨이 연결·3P 배포 문서). 기본 구성에서는 Anthropic API 다.

Connectors UI 는 로컬·SSH 세션에서만 뜬다. 목록에 없는 서비스는 양쪽 모두 설정 파일로 직접 붙인다.

데스크톱을 쓸 이유가 가장 분명한 항목이다 — 세션이 한 창에 모이고, 두 개를 나란히 볼 수 있고, 각자 워크트리가 자동으로 붙는다.

데스크톱의 전용 패널은 computer use 를 켜지 않아도 동작한다 — 화면 조작을 켜야만 되는 CLI 쪽과 다른 점이다.

팀장이 공용 작업 목록에서 동료에게 일을 배분하는 방식은 CLI 에만 있다. 데스크톱에서 한 세션 안의 다중 에이전트가 필요하면 동적 워크플로를 쓰거나, Claude 에게 다른 세션을 확인·메시지하게 한다.

데스크톱은 편집기 자동완성 같은 제안을 하지 않는다. 대화로 지시하고 명시적으로 코드를 바꾸는 방식이다 — IDE 확장을 대체하는 물건이 아니라는 뜻이다.

설정에 정의한 훅과 스킬이 양쪽에 적용된다. 다만 Cowork 탭은 예외로, Customize(claude.ai 계정)에서 가져오므로 ~/.claude 를 읽지 않는다.

셋 다 화면을 넓게 쓰는 일이다. 세션 여러 개를 한 창에서 돌리고, 미리보기·터미널·diff 를 나란히 두고, diff 의 줄에 코멘트를 달아 한꺼번에 넘긴다. 여기에 데스크톱만 있는 것이 더 붙는다 — 파일 첨부, iOS 시뮬레이터 패널, Dispatch, Scheduled tasks, 앱·화면 조작.

--print·Agent SDK·dontAsk 모드·에이전트 팀은 CLI 에만 있다. 파이프로 잇거나 CI 에서 돌리는 것도 이쪽이다.

둘을 고르는 문제가 아니다 — 같은 엔진이고 설정을 공유하므로 같은 프로젝트에서 동시에 쓰다가 /desktop 으로 세션을 옮길 수도 있다.

순서가 있다 — ① 앱 메뉴에서 로그아웃·재로그인(가장 흔한 해결) ② Pro·Max·Team· Enterprise 구독이 살아 있는지 ③ CLI 는 되는데 앱만 안 되면 창을 닫는 것이 아니라 앱을 완전히 종료한 뒤 다시 열어 로그인 ④ 네트워크·프록시 설정.

앱이 셸 프로필을 전부 읽지 않기 때문에 생긴다. 일반 터미널에서 그 도구가 되는지 확인하고, 셸 프로필이 PATH 를 제대로 세우는지 보고, 앱을 재시작해 환경변수를 다시 읽게 한다. 로컬 세션·dev 서버에 확실히 넘기려면 로컬 환경변수 편집기에 적는다.

macOS 는 Cmd+Q, 반응이 없으면 Cmd+Option+Esc 로 강제 종료. Windows 는 Ctrl+Shift+Esc 작업 관리자에서 Claude 프로세스를 끝낸다.

앱 버전·OS·정확한 오류 메시지·관련 로그. macOS 는 Console.app, Windows 는 이벤트 뷰어 → Windows 로그 → 응용 프로그램. 독립 claude CLI 에서도 재현되는 문제는 GitHub Issues 로 간다.

Cowork 탭과 Dispatch 쪽. Code 탭과 스킬·플러그인·커넥터의 출처가 다르다는 점이 실무에서 가장 자주 걸리는 지점이다.

Windows 에서 리눅스 툴체인으로 작업할 때. 이 세션에서는 @멘션·커넥터·플러그인이 빠진다는 제약을 먼저 확인한다.

apt 로 설치·갱신한다. Computer Use 는 아직 없다.

자연어로 연구 과제를 설명하면 Claude 가 Python·R·shell 코드를 샌드박스에서 쓰고 실행하고, 허락한 폴더를 읽고, 커넥터로 과학 데이터베이스에서 데이터를 가져와, 결과를 출처 기록이 붙은 버전 관리 아티팩트로 저장한다.

Jupyter 노트북처럼 셀 단위로 돌지만, 셀을 내가 쓰지 않는다는 것과 실행 기록이 결과에 묶여 남는다는 것이 다르다. macOS·Linux 베타다(네이티브 Windows 빌드는 아직 없다).

Anthropic 은 파일을 호스팅하지 않는다 — 브라우저 탭에서 열리지만 로컬 앱이고 공개 URL 이 없다.

다만 프롬프트에 답하려고 Claude 가 읽은 파일 내용은 그 대화의 일부로 API 에 전달되고 표준 보존 정책을 따른다. "로컬"은 저장 위치의 이야기이지 모델에 아무것도 가지 않는다는 뜻이 아니다.

예외 하나: 컴포저의 Attach files 는 파일을 앱 로컬 데이터 폴더로 복사해 대화에 붙인다 (제자리 읽기가 아니다).

승인 카드가 대화 안에 뜨고 무엇을 요구하는지 정확히 이름을 밝힌다. 종류마다 지속 범위가 다르다 — 폴더는 읽기 전용/읽기·쓰기를 골라 철회할 때까지, 코드 실행은 Once 또는 Always, 네트워크 호스트는 철회할 때까지, 커넥터 도구와 원격 잡은 Once·이 대화·이 프로젝트·Global.

상시 허가는 전부 Settings > Permissions 에 나열되고 거기서 철회한다.

재실행은 하지 않는다 — 응답·승인된 plan·아티팩트·실행 기록을 다시 읽어 주장이 실제로 돌아간 것과 맞는지 본다. 그래서 "방법이 이 연구 질문에 맞았는가"는 판단하지 않는다.

Team·Enterprise 는 Owner 가 조직에 대해 먼저 활성화해야 구성원이 로그인할 수 있다. 사인인이 claude.ai 에서 멈추면 셋 중 하나다 — Free 플랜, 리다이렉트 실패(Paste a code 사용), 조직 미활성화.

다운로드 페이지에서 Mac(Intel) / Mac(Apple Silicon) 을 골라야 한다 — 잘못 받으면 "지원되지 않는 앱"이라 하거나 아이콘에 사선이 그어진다. 내 칩은 Apple 메뉴 → 이 Mac에 관하여의 칩/프로세서 줄에서 확인한다.

claude-science 명령은 ~/.local/bin 에 깔린다 — command not found 면 PATH 문제이므로 . ~/.profile 을 돌리거나 새 터미널을 연다.

런타임과 스타터 Python·R 환경이 차지한다. 이후 task environment 를 만들면 그만큼 더 늘어난다 (환경은 머신 전체가 공유한다).

설치에 sudo 가 필요하다. Ubuntu 22.04 의 bubblewrap 은 너무 낮고 24.04 는 괜찮다 — 배포판과 무관하게 시작 전에 bwrap --version 으로 0.8.0 이상인지 확인한다.

리눅스가 시작을 거부하면 대개 이 의존성이 없거나 낮거나 커널이 유저 네임스페이스를 막은 것이다.

첫 실행이 런타임과 스타터 Python·R 환경을 구성하는데 수 분 걸린다(느린 회선이면 더). 그 사이 일부 커넥터가 로드 오류를 보일 수 있고 대개 설치가 끝나면 스스로 풀린다 — "자동 재시도가 멈췄다"는 오류면 Settings > Connectors 에서 껐다 켜거나 앱을 재시작한다.

브라우저 탭이 안 뜨면 메뉴 바 아이콘에서 Open 을 고른다.

OAuth 리다이렉트가 앱으로 돌아올 수 없는 환경(SSH 터널 등)에서는 사인인 화면의 Paste a code 를 쓴다. API 키는 필요 없다.

기존 conda 설치·R 라이브러리·셸 설정을 건드리지 않는다. Linux 에서 claude-science 명령 자체는 ~/.local/bin 에 깔린다.

네이티브 Windows 빌드가 없어서 리눅스 바이너리를 WSL 2 안에서 돌리는 것이다. 설치는 5분쯤 걸린다. Ubuntu 24.04 이상을 쓰는 이유는 샌드박스가 bubblewrap 0.8.0 이상을 요구하는데 22.04 가 그보다 낮기 때문이다.

설치는 Ubuntu 안에서 해야 한다 — Windows 브라우저로 바이너리를 받아 복사해 오면 검증과 안정 채널을 건너뛴다.

출력된 URL 에는 1회용 사인인 토큰이 들어 있다(약 3분 후 만료). 나중에 새로 받으려면 claude-science url 이다.

증상별 원인 — command not found 는 PATH(. ~/.profile), bwrap too old 는 Ubuntu 버전, daemon already running on port ... 은 이미 돌고 있는 것(claude-science url 로 링크만 받으면 된다), port ... is already in use 는 다른 프로그램이 쓰는 것(--port 8080), 브라우저가 localhost 로 못 닿으면 커스텀 .wslconfig 네트워크 모드일 수 있으니 Ubuntu 안에서 hostname -I 로 나온 주소를 쓴다.

앱은 WSL 가상머신 안에서 돌기 때문에 VM 이 내려가면 함께 멈춘다. 마지막 Ubuntu 터미널을 닫으면 잠시 뒤 VM 이 내려가고, wsl --shutdown 은 즉시 내린다.

프로젝트를 지우면 그 안의 세션·아티팩트·프로젝트 범위 메모리가 함께 사라진다. 반대로 세션만 지우면 아티팩트와 출처 기록은 남는다.

약 30분 유휴, 패키지 설치로 환경이 재시작될 때, 세션 종료 시 끝난다 — 그때 메모리의 변수도 사라지므로 오래 걸리는 중간 결과는 파일로 저장해 두는 편이 안전하다.

머신 전체의 모든 프로젝트가 공유한다 — 한 프로젝트에서 만든 환경이 다른 프로젝트에도 보인다. 목록·삭제는 설정 화면이 없으므로 Claude 에게 요청한다.

위치는 Settings > Storage > Data location 에서 확인한다. 유일한 사본이므로 백업 대상이다.

Claude 가 필요할 때 스킬을 자동으로 불러오므로 직접 고르는 것은 강제 지정에 해당한다.

검색 가능한 그리드다. 주석(annotation)은 이 그리드에 나타나지 않고 다운로드에도 포함되지 않는다.

찾는 것이 어디 있는지 — 상시 허가 철회는 Permissions, 리뷰어 커스터마이즈는 Specialists, 샌드박스 허용 호스트는 Network, GPU·SSH 호스트·Modal·모델 엔드포인트는 Compute, 클라우드 스토리지·문헌 키·GitHub 토큰은 Credentials, 데이터 폴더 위치는 Storage.

메모리는 기본 꺼짐이고 Memory 에서 켠다 — 저장된 사실은 로컬 DB 에만 있고 Anthropic 으로 동기화되지 않는다. 세션별로 끄는 토글도 있다.

위치를 산문으로 설명하는 대신 아티팩트의 그 부분에 코멘트를 붙이는 것이다. 텍스트는 강조 배지로, 이미지는 번호 핀으로 표시되고, 올려서 읽고 눌러서 수정·삭제한다.

커널이 살아 있는 동안 변수가 메모리에 남으므로 단계를 나눠 진행할 수 있다. 재시작 조건 셋을 기억할 것 — 유휴 30분, 패키지 설치로 환경이 바뀔 때, 세션 종료. 재시작되면 메모리의 변수는 사라진다.

패키지 소스를 다른 서버로 돌릴 수 없다 — 사내 미러가 필요하면 config.toml 의 [conda] 미러 키를 쓴다. 패키지가 아예 없는 도구는 소스를 받아 샌드박스에서 conda-forge 컴파일러로 빌드하고 그 빌드를 아티팩트로 저장해 재사용한다.

멀티 GPU 머신도 지원한다. GPU 가 없는 머신에서 GPU 가 필요한 작업이 오면 Claude 가 그 사실을 알리고 연결해 둔 원격 컴퓨트로 돌릴 수 있다.

남길 스크래치 파일은 저장해 달라고 말해야 한다. 아티팩트는 앱 데이터 폴더에 있고 내가 지울 때까지 남는다. 밖으로 꺼낼 때는 파일 하나면 Download, 여러 개면 ~/.claude-science 아래 프로젝트 폴더에서 직접 복사한다.

diff 모드에서는 비교 대상 버전을 고를 수 있다(기본은 직전 버전). 이름을 바꿔도 링크는 깨지지 않지만 Delete 는 모든 버전을 영구 삭제한다.

모든 아티팩트 버전이 어떻게 만들어졌는지를 기록한다 — 저장 시점 전후의 대화(Messages), 재현 가능한 스크립트(Code), 실행된 모든 명령(Execution Log), 환경과 패키지 버전(Environment), 리뷰어가 남긴 findings(Review).

응답 뒤 자동으로 돌고, 긴 작업 중에는 주기적으로 돌고, Request review 로 언제든 부를 수 있다.

한계를 정확히 알아 두는 것이 중요하다 — 주장이 기록과 맞는지를 보되 분석을 다시 돌리지는 않는다. 쓰인 방법에서 결론이 안 나오는 것은 잡지만, 그 방법이 내 연구 질문에 맞는 선택이었는지는 판단하지 않는다.

카드가 뜨면 Claude 가 그 findings 를 읽고 다음 메시지에서 고치거나 왜 해당하지 않는지 설명한다. 카드에서 리뷰어의 전체 추론을 펼쳐 볼 수 있다.

자동 리뷰는 세션별 토글이다(세션 설정 메뉴). 리뷰도 내 플랜 사용량을 쓴다 — 켜 두면 그만큼 소모된다.

Settings > Specialists 에서 리뷰어를 손보거나 내 방식에 맞춘 별도 specialist 를 만들어 추가 검토를 붙일 수 있다.

데이터 디렉터리당 하나만 돌고 Ctrl-C 로 멈춘다. 평소 쓰는 명령은 이것 하나이고, 나머지는 돌고 있는 프로그램을 관리하는 것들이다.

링크의 nonce 는 1회용 비밀번호로 브라우저 탭 하나를 로그인시키고 약 3분 뒤 만료된다. 로그인된 탭은 프로그램을 재시작할 때까지 유지되므로 링크를 보관할 필요가 없다.

--check 는 확인만 한다. 업데이트는 서명 검증 후 바이너리를 원자적으로 교체한다. 특정 버전을 지정하는 --to 가 롤백 수단이기도 하다.

다른 데이터 디렉터리나 그 DB 파일을 이쪽으로 합친다. 같은 임포트를 두 번 돌리는 것은 안전하다(멱등) — 위험한 것은 되돌릴 수 없다는 점이다.

port ... is already in use 는 다른 프로그램이 쓰는 것이고, daemon already running on port ... 은 이미 Claude Science 가 돌고 있는 것이다 — 후자는 다시 띄울 필요 없이 claude-science url 로 링크만 받으면 된다.

--no-browser 를 함축한다. WSL 처럼 터미널을 닫으면 VM 이 내려가는 환경에서는 detached 라도 VM 이 살아 있어야 한다.

기본값이라 내 기기에서만 닿는다. 다른 주소로 바꾸면 네트워크에 노출되므로, 원격 접속이 필요하면 이 값을 바꾸는 대신 SSH 터널을 쓰는 편이 맞다.

브라우저 Origin 을 하나 더 허용한다 — Claude 가 닿을 수 있는 사이트와는 무관하다 (그쪽은 샌드박스 네트워크 허용목록이다).

생성된 HTML 미리보기를 별도 오리진에서 서비스해, 미리보기 페이지가 내 세션을 읽지 못하게 한다. SSH 터널을 쓸 때 이 포트를 안 열면 인터랙티브 차트가 정적 스냅샷으로 보인다.

기본적으로 시작·정보 로그는 로그 파일에만 간다 — 콘솔에서 보려면 이 플래그다. 기록된 로그는 claude-science logs --tail 로 따라간다.

앱이 127.0.0.1 에만 붙기 때문에 터널이 정석이다. 두 포트를 함께 여는 이유는 8000 이 앱, 8001(기본 port+1)이 HTML 미리보기 오리진이기 때문이다.

링크는 약 3분 만료이므로 터널을 먼저 세워 두고 서버에서 claude-science url 로 새로 받는다. 여러 컴퓨터에서 같은 프로젝트를 보려면 이렇게 리눅스 서버에 한 번 설치해 터널로 접속하는 것이 유일한 방법이다(계정으로 동기화되지 않는다).

OAuth 리다이렉트가 앱으로 돌아올 수 없는 환경이라서 생기는 일이다 — 오류가 아니라 예상된 경로이므로 사인인 화면의 Paste a code 를 쓴다.

전부 읽기 전용이고 기본으로 켜져 있다. 요청에 데이터 소스 이름을 직접 대도 되고, 필요한 것만 설명하면 Claude 가 도구를 고른다 — 커넥터 질의는 대화에 펼칠 수 있는 코드 단계로 뜬다.

뒤에 있는 데이터베이스들은 Settings > Network 의 허용목록에 그룹 단위로 올라가 있어서, 그룹을 끄면 그것에 의존하는 커넥터가 함께 꺼진다.

ZINC 는 구매 가능한 화학 공간, CellGuide 는 CELLxGENE 세포 유형이다. 직접 추가한 커넥터는 이들과 달리 도구마다 승인 카드가 뜬다(Once·이 대화·이 프로젝트·Global).

Featured 커넥터와 달리 커넥터 디렉터리에서 오고 다른 Claude 제품에서도 쓰인다. 그래서 조직의 커넥터 권한 정책이 이쪽에는 적용된다 — 로컬로 추가한 커넥터에는 적용되지 않는다.

디렉터리 커넥터는 Anthropic 호스팅 커넥터 서비스를 경유한다 — 관리자가 걸어 둔 권한과 터널이 그대로 적용되는 이유다.

스킬은 방법·도구·확인할 것을 적어 둔 지시문 묶음이다. 작업이 그것을 요구하면 Claude 가 자동으로 불러오고, / 로 직접 지정할 수도 있다.

조직이 배포한 스킬과 내가 앱에서 퍼블리시한 스킬은 다른 컴퓨터에서 로그인해도 다시 나타난다 (메모리·설정·앱에서 추가한 커넥터는 컴퓨터별로 남는다).

Settings > Skills 의 Add skill 이다. 넷 중 어느 방식이든 결과는 같은 스킬 한 개다.

토큰은 api.github.com 레이트리밋 완화에도 쓰인다(GITHUB_TOKEN 환경변수로도 줄 수 있다). 방화벽에서는 api.github.com 과 codeload.github.com 이 스킬 설치 경로다.

한 번 잘 돌아간 분석 흐름을 다음에도 같은 방식으로 돌리게 만드는 가장 싼 길이다 — 절차를 문서로 적어 두는 것보다 실행되는 형태로 남기는 편이 낫다.

~/.ssh/config 의 값을 그 호스트에 대해서만 덮어쓴다 — config 를 고치지 않고 예외를 두는 자리다.

SLURM 클러스터면 파티션까지 읽는다. 결과는 호스트 상세 페이지의 편집 가능한 메모로 저장되고, Claude 가 작업하면서 이 Details 문서를 갱신한다 — 환경 활성화 방법, 데이터·패키지 위치, 스케줄링 관례 같은 것이 여기 쌓인다.

승인 카드에 명령과 스크립트가 그대로 표시되고, 승인하면 스크립트와 입력이 scratch 아래 잡 디렉터리로 복사된다. Scratch 디렉터리는 SLURM 이면 공유 파일시스템에 있어야 한다.

30분보다 오래 걸릴 작업은 제출 전에 미리 말해야 한다. 끝나면 출력이 세션으로 당겨지지만, 크기 임계치를 넘는 파일은 호스트에 남고 경로만 기록된다.

로컬 컨테이너로 돌리려면 NVIDIA GPU 가 있는 머신이 필요하다. 붙인 뒤에는 특정 NIM 스킬에 대해 로컬 Docker 컨테이너를 띄우거나 원격 연결을 설정하라고 Claude 에게 요청한다.

자격증명은 내 컴퓨터에서 암호화되고 해당 제공자에게만 전송된다. S3 호환 스토어는 AWS 폼의 S3-compatible endpoint 필드를 쓰고, 그 엔드포인트 호스트는 따로 허용목록에 올려야 한다.

DOI 나 제목을 주면 이 순서로 시도하고, 받은 파일(PDF·XML·텍스트)은 세션에 저장된다.

요청 예절도 정해져 있다 — 제공자마다 초당 1건으로 조절하고, 요청받으면 물러나고, 매 요청에 자신을 밝히고, 페이월 HTML 은 스크랩하지 않는다.

OpenAlex 는 모든 요청에 키를 요구하므로 OpenAlex 기반 문헌 검색은 키가 없으면 아예 안 돈다. 키는 OpenAlex API 설정 페이지에서 무료로 만든다.

직접 추가한 커넥터의 모든 도구는 Ask each time 에서 시작한다 — Featured 커넥터가 카드 없이 도는 것과 다른 점이다. 커넥터 단위로 Skip approvals 를 켜면 그 커넥터의 모든 도구에서 호출별 카드가 사라진다.

샌드박스 밖이 아니다 — Claude 가 쓰는 코드와 같은 네트워크 제한을 받고 자기 쓰기 디렉터리를 하나 갖는다. 대신 환경변수가 암호화 없이 설정 파일에 저장되므로(내 계정만 읽을 수 있다) 고가치 시크릿은 넣지 않는다.

종류마다 고를 수 있는 범위가 다르다 — 폴더는 읽기 전용/읽기·쓰기를 고르고 철회할 때까지 유지, 코드 실행은 Once 또는 Always, 네트워크 호스트는 철회할 때까지, 커넥터 도구와 원격 잡은 아래 네 범위 전부.

상시 허가는 Settings > Permissions 한 곳에 모여 있고 거기서 철회한다.

가장 넓은 범위다. 원격 잡·커넥터 도구에 Global 을 주면 이후 어느 프로젝트에서든 묻지 않는다 — 되돌리려면 Settings > Permissions 에서 철회해야 한다.

모든 키에 기본값이 있어 파일이 없어도 앱이 돈다 — 관리자가 기기 관리로 배포해 정책을 세우는 용도다. 한 번만 다른 파일로 돌리려면 claude-science --config <file>.

우선순위가 키마다 다르다. 프록시와 패키지 미러 키는 파일이 Settings 보다 우선하고, 그때 Settings 화면에는 "조직 관리"로 표시돼 구성원이 바꿀 수 없다. 반면 [sandbox.network] 목록은 덮어쓰는 것이 아니라 더해지고 아무것도 잠그지 않는다.

환경변수 예외 하나 — 앱 환경의 프록시 변수(ALL_PROXY 포함)가 [network] proxy 보다 우선한다. http:// 미러를 쓰려면 allow_insecure_mirror 를 켜야 하는데, 평문 미러는 경로상의 공격자가 패키지를 갈아치울 수 있어 기본이 꺼져 있다.

설정 파일의 disable_telemetry = true 와 같은 스위치다. 보내지는 것은 이벤트 수·소요 시간 같은 제품 사용 지표이고 대화 내용은 아니다.

api.github.com 에만 쓰인다 — GitHub 저장소에서 스킬을 설치할 때의 레이트리밋을 올리는 용도다.

환경변수가 설정 파일을 이기는 유일한 경우다. 그 밖의 설정은 전부 config.toml 쪽에 둔다. https://(프록시까지 TLS) 주소는 앱 자체 연결에만 적용되고 샌드박스의 패키지 다운로드는 직접 연결하므로, 프록시는 http:// 를 쓰는 편이 낫다.

다른 값들은 덮어쓰지만 NO_PROXY 만 no_proxy 키와 합쳐진다 — 한쪽에만 적어도 둘 다 적용된다.

Anthropic 이 브라우즈·동기화·내보낼 대상이 아예 없다는 뜻이다. 그래서 조직의 데이터 통제 수단(Custom Data Retention·조직 내보내기·Compliance API)이 이 데이터에는 닿지 않는다 — 기기 관리(MDM·EDR)가 유일한 통제 수단이다.

모델을 호출할 때마다 프롬프트와 응답이 전송되고 모델 트래픽에 대한 표준 보존 정책을 따른다 — 다른 Claude 제품과 같은 정책이다. 조직의 Custom Data Retention 설정은 이 보존 기간을 바꾸지 않는다.

로컬에서 데이터를 지워도 서버 측 모델 트래픽 로그가 먼저 지워지지는 않는다(표준 보존 기간까지 남는다).

내가 통제하는 서버·클라우드 계정으로 코드와 데이터가 직접 간다. 관리자가 구성원의 원격 컴퓨트 연결을 막을 수단은 아직 없다.

Admin 역할로는 켤 수 없다 — 구성원 추가와 좌석 배정은 되지만 활성화는 Owner·Primary Owner 만 할 수 있다. 사용량은 구성원의 평소 주간 한도에 합산되고 claude.ai 와 같은 좌석을 쓴다.

마법사가 아직 지원되지 않는 것, 접근 역할, 퍼블리시할 커넥터를 차례로 훑는다. 도입 현황은 Analytics 의 Claude Science 탭에서 보고, Enterprise 는 Admin API 의 science_metrics(세션 수·메시지 수·delegation 수·원격 잡 수·스킬 호출 수)로도 받는다.

조직의 커넥터·도메인 허용목록은 관리자가 퍼블리시한 Directory 커넥터에만 적용되고, 구성원이 로컬에서 추가한 커넥터(자기 컴퓨터에서 돌거나 커스텀 URL 을 가리키는 것)는 제한하지 못한다. 스킬도 같다 — 조직 스킬은 보이지만 어떤 featured 스킬을 켤지에 대한 관리자 통제는 없다. 로컬·커스텀 커넥터 통제는 로드맵에 있다.

앱이 Anthropic 과 통신하는 최소 집합이다. 이것이 막히면 사인인과 모델 호출 자체가 안 된다.

샌드박스의 패키지 설치 경로다. 패키지 소스를 다른 서버로 돌릴 수는 없고, 사내 미러가 필요하면 config.toml 의 [conda] channel_mirror·pip_index_url 을 쓴다 (pip_index_url 을 설정하면 공개 Python 호스트가 샌드박스 허용목록에서 빠진다).

데이터가 빠져나갈 통로를 구조적으로 막아 둔 목록이라 해제할 수 없다. GCS 를 코드에서 다룰 때 gsutil·gcloud storage·google-cloud-storage 라이브러리가 막히는 것도 같은 이유(path-style 주소)이고, 그래서 HMAC 키 + boto3 나 import/export 를 쓴다.

--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 으로 눌러서 시작·정지 방식으로 바꿀 수 있다.

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

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

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

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

가장 보수적인 값이다. 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 규칙을 쌓거나 샌드박스를 켜는 쪽이 맞다.

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 으로 마켓플레이스를 연다.

뒤에 오는 것이 앞을 덮는 게 아니라 전부 함께 로드된다. 그래서 층을 나눠 쓴다 — 전역(~/.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 에 구현이 없는 이유가 이것이다.

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

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

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 보고서를 만든다 — 클라우드 세션에서는 쓸 수 없다.

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 목록에도 잡힌다.

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

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

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

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

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

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 는 우회되지 않으므로, 되돌릴 수 없는 명령은 여기서 상시 차단한다.

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 로 이름을 붙여 쓴다. 리터럴 달러 기호는 백슬래시로 이스케이프한다.

프린트 모드는 한 번 돌고 끝난다. 셋을 같이 걸어야 안전하다 — 권한 모드(--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 로 떼어낸다. 팀에 배포할 것은 스킬 → 플러그인 순으로 올린다.

컨텍스트를 비우고 새 대화를 연다. 이름을 붙여 두면 /resume 목록에서 방금 자른 대화가 무엇이었는지 알아볼 수 있다 — 이름 없이 자르면 나중에 목록에서 구분이 안 된다.

같은 대화를 이어가면서 자리만 확보하려면 /clear 가 아니라 /compact 다. 잘라 놓고 후회했으면 /resume 으로 돌아가거나, 같은 프로세스 안이라면 /rewind 메뉴의 '이전 세션' 항목으로 복원한다.

지금까지의 대화를 요약해 컨텍스트를 비운다. 뒤에 지시를 붙이면 무엇을 남길지 지정할 수 있다(/compact 실측 수치와 결정만 남겨). 규칙·스킬·메모리 파일이 압축 후에 어떻게 남는지는 공식 문서의 context-window 문서에 정리돼 있다.

무엇이 컨텍스트를 먹고 있는지 색 격자로 보여준다. 컨텍스트를 많이 쓰는 도구, 비대해진 메모리 파일, 한계 임박 경고까지 함께 뜬다. 감으로 자르지 말고 여기서 원인을 본 다음 /clear 냐 /compact 냐를 정하는 순서가 맞다.

한계를 넘긴 상태면 얼마나 초과했는지와 어느 명령이 자리를 비우는지도 출력에 붙는다. 전체화면 모드에서는 격자를 살리려고 항목별 내역을 접는데, all 을 주면 펼친다.

ID·이름으로 대화를 재개하거나, 인자 없이 실행해 세션 선택기를 연다. 백그라운드 세션은 목록에 bg 로 표시되고, 아직 돌고 있는 것은 여기서 재개할 수 없다 — claude agents 에서 붙거나 거기서 먼저 세우고 와야 한다.

현재 세션 이름을 바꾸고 프롬프트 바에 띄운다. 이름을 생략하면 대화 이력에서 자동 생성한다. -p 비대화 모드에서도 쓸 수 있다(v2.1.205+).

제어문자·보이지 않는 문자는 공백으로 치환되고 200자에서 잘린다. 그 처리 후 빈 이름이 되면 거부된다. 같은 기기의 다른 세션이 이미 쓰는 이름이면 변형된 이름이 붙는다.

지금 지점에서 대화를 분기해 분기 쪽으로 들어간다. 원본은 그대로 남고 /resume 으로 돌아올 수 있다. 다른 접근을 시험해 보고 싶은데 지금까지의 대화를 잃고 싶지 않을 때 쓴다.

셋의 차이: 들어가는 것이 /branch, 복사본을 백그라운드로 띄우고 나는 여기 남는 것이 /fork, 곁가지를 서브에이전트에 맡겨 결과만 이 대화로 받는 것이 /subtask 다.

현재 대화를 백그라운드 세션으로 복사하고 나는 여기서 계속 작업한다. 프롬프트를 주면 복사본이 바로 그 일을 시작하고, 없으면 에이전트 뷰에서 첫 지시를 기다린다.

제자리 편집을 하는 경우를 빼면 복사본은 코드 변경 전에 자기 워크트리를 만들도록 지시받는다 (v2.1.221+). v2.1.212 미만이거나 에이전트 뷰를 끈 환경에서는 /fork 가 대신 포크된 서브에이전트로 동작한다.

현재 대화를 평문으로 내보낸다. 파일명을 주면 그 파일로 바로 쓰고, 없으면 클립보드 복사와 파일 저장을 고르는 대화상자가 열린다. 리뷰 근거나 인수인계 기록을 남길 때 쓴다.

커밋 안 된 변경과 턴별 diff 를 대화형으로 본다. 좌우 화살표로 현재 git diff 와 개별 Claude 턴을 넘기고, 위아래로 파일을 훑고, Enter 로 해당 파일 diff 를 연다. Esc 로 파일 목록으로 돌아온다.

열린 뷰어는 다른 터미널에서 브랜치를 바꾸거나 커밋해도 자동으로 갱신된다(v2.1.198+).

대화만, 코드만, 또는 둘 다 이전 지점으로 되돌린다. 선택한 메시지 지점부터 요약하는 선택지도 같은 메뉴에 있다.

되돌리기 전에 무엇을 되돌리는지 확인할 것 — 코드까지 되돌리면 그 사이의 수동 편집도 함께 사라진다. 잘못 고친 것을 되돌릴 때는 git 이 아니라 이쪽이 대화까지 같이 맞춰 준다.

현재 세션에 대해 대화 이력에 쌓지 않고 질문한다. "지금 무슨 작업 중이었지" 같은 확인을 본 대화의 컨텍스트를 늘리지 않고 물을 수 있다.

질문 없이 실행하면 가장 최근 곁질문을 보여줘 이전 답을 다시 훑을 수 있다(v2.1.212+).

모델을 바꾸고 새 세션의 기본값으로도 저장한다. 이번 세션만 바꾸려면 선택기에서 해당 줄에 s 를 누른다 — 이 구분을 모르면 잠깐 내렸던 모델이 다음 세션까지 따라온다.

선택기에서 좌우 화살표로 추론 강도까지 같이 조정할 수 있다. 확인을 거치면 진행 중인 응답이 끝나기를 기다리지 않고 바로 적용된다. -p 비대화 모드에서는 인자로 지정하며, 그때는 세션에만 적용되고 기본값으로 저장되지 않는다(v2.1.205+).

low ~ xhigh, max, ultracode, auto 중에서 고른다. status 를 주면 현재 값을 출력한다. max 와 ultracode 는 세션 한정이고, ultracode 설정 키 자체는 남는다.

단순 반복 작업에 최고 강도를 쓸 이유가 없다. 비용이 빨리 닳으면 모델보다 먼저 이쪽을 내려 보는 편이 회복이 빠르다.

작업 중 중요한 지점에서 두 번째 모델에게 조언을 구하는 도구를 켜거나 끈다. fable·opus·sonnet 또는 전체 모델 ID 를 받고, 인자 없이 실행하면 선택기가 열린다. fable 은 Fable 5 접근 권한이 필요하다.

컨텍스트가 얼마나 차면 자동으로 압축할지를 정한다. 500k 처럼 크기를 주거나, auto 로 모델에 맞춰진 기본값으로 되돌린다. 값은 사용자 설정에 저장되고 현재 세션에도 바로 적용된다. 인자 없이 실행하면 현재 창을 보여주는 대화상자가 열린다(v2.1.221+).

패스트 모드를 켜고 끈다(v2.1.205+). 작은 모델로 내려가는 것이 아니라 같은 Opus 를 더 빠른 출력으로 돌리는 것 — 품질을 낮춰 속도를 사는 옵션으로 오해하기 쉬운 지점이다. Opus 5 / 4.8 계열에서 쓸 수 있다.

-p 비대화 모드에서의 사용 가능 범위는 제한적이다.

프롬프트에서 바로 계획 모드로 들어간다. 설명을 붙이면 그 작업으로 계획을 시작한다 (/plan 인증 버그 고치기).

비자명한 변경은 여기서 시작하는 편이 싸다. 방향이 틀린 구현은 품질과 무관하게 전부 버려지므로, 편집을 막아 둔 상태에서 계획을 먼저 받고 합의한 뒤 실행으로 넘긴다.

현재 세션을 백그라운드 에이전트로 떼어내고 터미널을 돌려받는다. 프롬프트를 붙이면 떼어내기 전에 지시를 하나 더 보낸다. 진행은 claude agents 로 확인한다.

이 세션을 그대로 두고 복사본만 백그라운드로 띄우려면 /fork 다.

세션이 열려 있는 동안 프롬프트를 반복 실행하는 번들 스킬이다 (/loop 5m 배포 끝났는지 확인).

간격을 생략하면 Claude 가 스스로 간격을 정한다. 프롬프트까지 생략하면 자율 점검이나 .claude/loop.md 의 내용을 돌린다. 짧은 간격으로 폴링하면 매 회차가 비용이므로, 기다리는 대상이 실제로 얼마나 빨리 바뀌는지에 간격을 맞추는 편이 낫다.

조건을 걸면 그 조건이 충족될 때까지 턴을 넘어 계속 작업한다. 인자 없이 실행하면 현재 목표나 마지막으로 달성한 목표를 보여준다. clear·stop·off·reset·none·cancel 중 아무 것이나 주면 활성 목표를 먼저 해제한다.

전체 대화를 물려받은 백그라운드 서브에이전트를 띄우고, 나는 계속 작업한다. 끝나면 결과가 이 대화로 돌아온다(v2.1.212+).

실질 이점은 전문성이 아니라 컨텍스트 격리다 — 파일 50개를 훑어야 하는 조사를 본 대화에 쌓지 않고 결론만 받는다. 복사본을 별도 세션으로 띄우려면 /fork 다.

코드베이스 전반의 대규모 변경을 병렬로 조직하는 번들 스킬이다 (/batch src/ 를 Solid 에서 React 로 옮겨).

코드베이스를 조사해 독립 단위 5~30개로 쪼개고 계획을 먼저 제시한다. 승인하면 단위마다 백그라운드 서브에이전트를 격리된 git 워크트리에 띄우고, 각자 구현·테스트·PR 까지 낸다. git 저장소가 아니면 쓸 수 없다.

이 세션의 백그라운드 작업을 보고 관리한다 — 끝난 서브에이전트도 포함되므로 결과를 놓쳤을 때 여기서 찾는다. 응답 중에도 즉시 실행되는 명령 중 하나다.

돌고 있는 워크플로의 진행 화면을 연다. 지켜보기·일시정지·재개, 그리고 완료된 워크플로 저장까지 여기서 한다. 서브에이전트를 여러 개 부채꼴로 펼치는 작업의 실제 진행을 확인할 수 있는 유일한 창구다.

클라우드에서 도는 루틴을 만들고 고치고 목록으로 보고 즉시 실행한다. 설정은 대화로 진행되고, 루틴의 최근 실행 결과도 물어볼 수 있다.

/loop 는 세션이 열려 있는 동안만 도는 반복이고, 이쪽은 세션을 닫아도 남는 예약이다. GitHub 연결이 안 돼 있으면 /web-setup 을 먼저 물어본다.

현재 diff 또는 넘긴 PR 번호·브랜치·경로를 정확성 버그와 정리 기회 관점으로 검토한다. 강도는 low·medium·high·xhigh·max·ultra 이고, 낮으면 확신 높은 소수만, 높이면 넓게 보되 불확실한 지적도 섞인다.

--fix 는 찾은 것을 작업 트리에 적용하고, --comment 는 GitHub PR 인라인 코멘트로 올린다. ultra 는 클라우드에서 도는 심층 다중 에이전트 리뷰다.

현재 브랜치와 origin 기본 브랜치의 차이를 보안 관점으로 본다 — 인젝션, 인증 문제, 데이터 노출 같은 위험을 찾는다. 커밋 안 된 변경만 보는 것이 아니라 브랜치 전체가 대상이다.

바뀐 코드를 재사용·단순화·효율·추상화 높이 네 관점의 에이전트가 병렬로 검토하고 고침까지 적용한다. 경로나 PR 참조를 주면 그 대상만 본다.

v2.1.154 부터 정확성 버그는 찾지 않는다 — 버그는 /code-review 쪽이다. 그 이전 버전에서는 /code-review --fix 와 같은 동작이었다.

테스트나 타입체크에 기대지 않고 프로젝트의 앱을 실제로 빌드·실행해 결과를 관찰하는 번들 스킬이다. 초록불이 대상을 보고 있지 않을 때를 잡는 쪽이 이 명령의 목적이다.

현재 브랜치의 PR 을 지켜보다가 CI 가 깨지거나 리뷰 코멘트가 달리면 수정을 밀어 넣는 웹 세션을 띄운다. 기본값은 모든 CI 실패와 리뷰 코멘트를 고치는 것이고, 프롬프트를 주면 범위를 좁힐 수 있다(/autofix-pr 린트와 타입 오류만 고쳐).

gh pr view 로 체크아웃된 브랜치의 PR 을 찾으므로, 다른 PR 을 맡기려면 그 브랜치로 먼저 옮겨야 한다. gh CLI 와 웹 접근 권한이 필요하다.

프로젝트의 앱을 실제로 띄우고 조작해 변경이 동작하는 것을 눈으로 본다. 테스트 통과가 아니라 실행 결과가 근거가 된다. 프로젝트에 실행 방법을 담은 스킬이 있으면 그것을 먼저 찾고, 없으면 프로젝트 종류별 기본 패턴(CLI·서버·TUI·브라우저)으로 띄운다.

클라우드 샌드박스에서 도는 깊은 다중 에이전트 리뷰다. PR 참조를 주면 그 PR 을, 브랜치 이름을 주면 비교 기준을 바꾼다.

권장 호출은 이제 /code-review ultra 이고 이 이름은 별칭으로 남아 있다. Pro·Max 는 3회 무료, 이후는 사용 크레딧이 필요하다.

차트·그래프·대시보드 디자인 가이드를 주는 번들 스킬이다. 데이터에 맞는 차트 형태를 고르고, 역할별 색을 할당하고, 색약 안전성과 대비율을 검증하며, 마크·인터랙션·접근성 규칙을 적용한다. 브랜드 중립 플레이스홀더 팔레트를 쓰고 나중에 자기 팔레트로 바꾼다(v2.1.198+).

설정 화면의 Status 탭을 열어 버전·모델·계정·연결 상태를 보여준다. Claude 가 응답 중일 때도 즉시 실행되는 명령 중 하나다.

Session kind 행으로 지금 세션이 대화형인지, 백그라운드 작업인지(터미널이 붙었는지까지) 구분할 수 있다(v2.1.221+).

세션 비용, 플랜 사용 한도, 활동 통계를 보여준다. 유료 플랜에서는 스킬·서브에이전트· 플러그인·MCP 서버별 내역까지 쪼개 준다 — 무엇이 비용을 먹는지 여기서 지목할 수 있다. /cost, /stats 는 별칭이다.

설치·설정을 점검하고 고쳐 주기까지 하는 번들 스킬이다. 중복·잔여 설치, PATH 문제, 파싱 안 되는 설정 파일을 잡고, 릴리스 채널에 새 버전이 있는지도 확인한다.

쓰지 않는 스킬·MCP 서버·플러그인을 그 컨텍스트 비용과 함께 지목하고, 느린 훅을 표시한다. 로컬 CLAUDE.md 와 체크인된 것의 중복을 정리하고, 너무 커진 CLAUDE.md 에서 코드베이스로 알 수 있는 내용을 덜어내 스킬·중첩 CLAUDE.md 로 옮기는 제안도 한다.

이 기기의 최근 세션들을 분석한 HTML 보고서를 만든다 — 어느 프로젝트에서 일했는지, 어떻게 쓰는지, 어디서 일이 틀어지는지, 써 볼 만한 기능은 무엇인지. 클라우드 세션에서는 쓸 수 없다(분석 대상이 이 기기의 기록이므로).

현재 세션을 한 줄로 요약한다. 자리를 비웠다 돌아왔을 때 자동으로 뜨는 요약과 같은 것을 필요할 때 직접 부르는 형태다. 컨텍스트를 줄이는 /compact 와 달리 대화를 건드리지 않는다.

JS 힙 스냅샷과 메모리 내역을 ~/Desktop(Linux 에 Desktop 이 없으면 홈)에 쓴다. 메모리 사용량이 비정상적으로 높을 때의 진단용이다. 명령 메뉴에 뜨지 않으므로 이름을 전부 입력해야 한다.

내가 소유하거나 공유받은 아티팩트를 나열하고 세션에 첨부하거나 브라우저에서 열거나 링크를 복사한다. 아티팩트가 지원되는 환경에서만 사용 가능하다(v2.1.208+). Enter 로 첨부하려면 v2.1.216+ 이 필요하다.

claude.ai 사용 한도로 요청이 차단될 때 계속 작업하는 방법을 보여준다 — 한도가 리셋될 때까지 기다리고 자동으로 계속, 사용 크레딧 추가, 플랜 업그레이드 등. 터미널에서 한도에 부딪히면 자동으로 이 메뉴를 열 수도 있다(v2.1.234+). 명령 메뉴에 보이지 않으므로 전체 이름을 입력해야 한다.

사용 크레딧을 구성하거나 한도에 도달했을 때 관리자에게 요청한다. 브라우저에서 사용 크레딧 청구 설정을 연다(v2.1.205+ 이전에는 브라우저가 없을 때 아무것도 표시하지 않음). Team·Enterprise 멤버는 CLI에서 관리자에게 요청을 보낸다.

v2.1.198 부터는 관리 화면이 아니라 안내를 출력한다 — 서브에이전트는 Claude 에게 만들라고 말하거나 .claude/agents/·~/.claude/agents/ 를 직접 편집한다. v2.1.197 이하에서는 대화형 관리 화면이 열렸다.

도구 이벤트에 걸린 훅 설정을 확인한다. "매번 X 하게 해 줘" 같은 자동 동작은 메모리나 선호가 아니라 훅이 담당한다 — 훅은 Claude 가 아니라 하네스가 실행하기 때문이다.

MCP 서버 연결과 OAuth 인증을 관리한다. 인자 없이 실행하면 대화형 목록이 열리고, reconnect <server> 로 끊긴 서버 하나만 다시 붙이고, enable/disable 에 서버 이름이나 all 을 주면 대화상자 없이 연결 상태만 바꾼다.

-p 비대화 모드에서도 쓸 수 있고, 그때는 목록 대신 상태 요약을 텍스트로 출력한다(v2.1.205+).

샌드박스 모드를 켜고 끈다. 지원되는 플랫폼에서만 보인다. 권한 확인이 잦다고 --dangerously-skip-permissions 로 가는 대신 격리로 위험을 낮추는 쪽이 이 명령의 방향이다.

CLAUDE.md 파일을 편집하고, 자동 메모리를 켜거나 끄고, 적립된 자동 메모리 항목을 본다. 코드베이스에서 알 수 있는 사실을 메모리에 넣으면 매 세션 컨텍스트 비용만 늘고 낡는다 — 비자명한 결정과 제약만 남기는 편이 낫다.

allow·ask·deny 규칙을 관리하는 대화형 화면을 연다. 스코프별 규칙 보기, 추가·삭제, 작업 디렉터리 관리, 오토 모드의 최근 거부 검토까지 여기서 한다.

응답 중에 실행하면 대화상자가 즉시 열리고, 바꾼 규칙은 같은 턴의 다음 도구 호출부터 적용된다(v2.1.234+).

메시지를 보낼 수 있는 서브에이전트·팀 동료·다른 Claude Code 세션을 주소로 쓸 이름과 함께 나열한다(v2.1.224+). 교차 세션 메시징이 켜진 세션에서만 쓸 수 있다.

쓸 수 있는 스킬을 나열한다. 이름으로 필터하고, t 로 토큰 비용 순 정렬, Space 로 Claude 와 / 메뉴에 대한 노출을 순환시키고 Enter 로 저장한다. 컨텍스트가 비싸진 원인이 스킬 더미인지 여기서 확인할 수 있다.

세션 중에 디스크에서 추가·수정된 스킬과 명령을 재시작 없이 인식시킨다. 몇 개가 사용 가능하고 몇 개가 추가·삭제됐는지 보고한다(v2.1.152+). 스킬을 만들며 시험할 때 쓴다.

현재 세션에 디버그 로그를 활성화하고 세션 디버그 로그를 읽어 문제를 해결한다. 기본값은 claude --debug 로 시작하지 않은 한 디버그 로그가 꺼져 있으므로, 세션 중간에 /debug 를 실행하면 그 시점부터 로그를 캡처한다. 문제 설명을 붙이면 분석에 초점을 맞춘다.

질문에 대해 웹 검색을 펼쳐 소스를 가져와 교차 검증하고 인용이 포함된 보고서를 종합한다. 클라우드에서 도는 워크플로우다(v2.1.218+ 이후에는 명시적으로 호출할 때만 실행).

/design-sync 를 위한 디자인 시스템 접근 권한을 claude.ai 계정으로 인증한다.

리포의 React 디자인 시스템을 변환해 Claude Design(https://claude.ai/design)에 올려서 Claude 가 만든 디자인이 실제 컴포넌트를 쓰게 한다. 이름을 붙일 수도 있다(/design-sync Acme DS). 첫 동기화는 모든 컴포넌트를 검증하므로 큰 리포에서는 몇 시간이 걸릴 수 있다. Anthropic API 에서 사용 가능하며, 일부 플랫폼에서는 claude.ai 에 접근할 수 없어 사용할 수 없다.

프로젝트와 최근 세션에서 autoMode.environment 항목을 초안으로 작성하고, 초안을 검토한 뒤 사용자 설정에 저장한다. Pro·Max·Team 플랜과 Claude Code v2.1.228+ 이 필요하다. 네이티브 Windows 에서는 v2.1.233+ 이 필요하다.

클라우드 에이전트의 기본 환경을 선택한다.

이 기기의 다른 코딩 에이전트(현재 OpenAI Codex, Google Gemini CLI) 설정을 가져온다 — 지시 파일·MCP 서버·명령·서브에이전트·스킬까지. --dry-run 은 아무것도 쓰지 않고 미리 보고, --yes 는 선택 화면을 건너뛴다(v2.1.213+).

Claude Code 플러그인을 관리한다. 인자 없이 실행하면 플러그인 메뉴가 열리고, list·install·enable·disable 같은 하위 명령을 직접 실행할 수도 있다. 설치할 때 플러그인을 바로 활성화할 수도 있고, 설치 요약에서 다시 로드가 필요한지 알려준다.

활성 플러그인을 다시 로드해 보류 중인 변경사항을 적용한다. 재로드된 구성요소 수를 보고하고 로드 오류를 표시한다. 재로드로 MCP 도구가 바뀌어 프롬프트 캐시가 무효화되면 경고하고 건너뛴다. --force 를 주면 강제로 진행한다.

지금 세션을 데스크톱 앱에서 이어 간다. macOS 또는 x64 Windows 와 Claude 구독이 필요하다. 터미널에서 시작한 작업을 diff 뷰어·브라우저 창이 있는 화면으로 옮길 때 쓴다.

모바일 앱을 받을 QR 코드를 띄운다. 원격으로 세션을 지켜보려면 앱 설치 후 /remote-control 로 이 세션을 연결한다.

이 세션을 claude.ai 에서 원격 조작할 수 있게 연다 — 세션은 이 기기에서 계속 돌고, 조작 창구만 밖으로 나간다. 로그아웃 상태에서 실행하면 구독이 필요하다는 안내와 로그인 방법을 알려준다(v2.1.206 이전에는 알 수 없는 명령으로 떴다).

웹에서 돌던 세션을 이 터미널로 끌어온다. 선택기가 열리고 브랜치와 대화를 함께 가져온다. claude.ai 구독이 필요하다. 방향이 반대인 것은 /background(터미널 → 백그라운드)와 /desktop(터미널 → 데스크톱)이다.

버그를 신고하거나 대화를 공유한다. 얼마나 많은 세션 기록을 포함할지 고르고 동의 화면에서 확인한 뒤에 전송된다.

Anthropic 계정으로 1st-party 연결에 로그인돼 있으면 Anthropic 으로 가고, 서드파티 공급자나 자격증명이 없으면 ~/.claude/feedback-bundles/ 아래 로컬 묶음으로 저장돼 직접 전달하게 된다.

제품 피드백을 보낸다. /bug 과 같은 대화상자·동의 절차·전송 규칙을 쓴다 — 차이는 신고의 성격뿐이다.

로컬 gh CLI 자격증명으로 GitHub 계정을 웹(Claude Code on the web)에 연결한다. /schedule 처럼 클라우드에서 도는 기능이 GitHub 연결을 필요로 하면 자동으로 이것을 물어본다.

저장소에 Claude GitHub 앱을 설치하고, GitHub Actions 워크플로와 시크릿을 설정하는 선택 단계를 거친다. 저장소 선택과 통합 설정을 안내하는 마법사가 실행된다.

Claude Slack 앱을 설치한다. OAuth 흐름을 완료하기 위해 브라우저를 연다.

Claude Code 사용 기록에서 팀 온보딩 가이드를 생성한다. 지난 30일간의 세션·명령·MCP 서버 사용을 분석해 팀원이 첫 메시지로 붙여넣어 빠르게 설정할 수 있는 마크다운 가이드를 만든다. claude.ai 구독자(Pro·Max·Team·Enterprise)에서는 바로 열 수 있는 공유 링크도 제공한다.

설정 화면을 열어 테마·모델·출력 스타일 등을 조정한다. 화면을 열지 않고 값만 바꿀 수도 있다 — /config thinking=false 처럼 key=value 를 넘기면 된다(v2.1.181+). theme=dark, model=sonnet 같은 축약 키도 받는다(v2.1.182+).

/config --help 로 설정 가능한 키 전체와 각 선택지를 볼 수 있다. key=value 형태는 -p 비대화 모드와 모바일 원격 제어에서도 동작한다.

프롬프트 바 색을 이번 세션에 대해 정한다. red·blue·green·yellow·purple·orange·pink·cyan 중에서 고르고, default 로 되돌리고, 인자 없이 실행하면 무작위로 고른다.

여러 세션을 동시에 띄워 두는 환경에서 어느 터미널이 어느 작업인지 구분하는 용도로 쓸 만하다. 원격 제어가 붙어 있으면 색이 claude.ai 쪽에도 동기화된다.

키보드 단축키 파일(~/.claude/keybindings.json)을 연다. 기본 제출 키를 바꾸거나 코드 방식 단축키를 추가하는 것도 여기서 한다.

과거 대화 기록을 훑어 자주 쓰인 읽기 전용 Bash·MCP 호출을 찾아, 우선순위를 매긴 허용 목록을 프로젝트 .claude/settings.json 에 추가하는 번들 스킬이다.

실제로 쓴 것만 근거로 허용하므로, 권한을 통째로 끄는 것(--dangerously-skip-permissions)과 성질이 다르다.

색 테마를 바꾼다. 터미널 배경의 명암을 따라가는 auto, 라이트·다크 변형, 색약 대응(daltonized) 테마, 터미널 팔레트를 그대로 쓰는 ANSI 테마, 그리고 ~/.claude/themes/ 나 플러그인에서 온 커스텀 테마까지 고를 수 있다. 목록의 New custom theme… 로 새로 만들 수도 있다.

상태줄을 구성한다. 원하는 내용을 말로 설명하거나, 인자 없이 실행하면 현재 셸 프롬프트에서 자동으로 구성해 준다. 모델·브랜치·비용 같은 것을 항상 눈에 두고 싶을 때 쓴다.

Shift+Enter 같은 단축키가 먹지 않는 터미널에서 키 바인딩을 설정한다. 필요한 터미널에서만 명령 목록에 보인다 — VS Code, Cursor, Devin Desktop, Alacritty, Zed 등. 줄바꿈이 안 되고 바로 전송돼 버릴 때 찾을 명령이다.

터미널 UI 렌더러를 설정하고 대화를 유지한 채 다시 시작한다. fullscreen 은 깜빡임 없는 alt-screen 렌더러를 켠다. 인자 없이 실행하면 활성 렌더러를 출력한다.

음성 받아쓰기를 켜거나 끄거나 특정 모드로 설정한다. hold·tap·off 중에서 고르고, claude.ai 계정이 필요하다.

대화와 프롬프트 캐시를 유지한 채 세션의 작업 디렉터리를 옮긴다(v2.1.169+). 부분 경로를 입력하면 후보가 뜨고 Tab 으로 채운다. 처음 다루는 위치면 워크스페이스를 신뢰할지 먼저 묻고, 이후 --resume 이 옮겨진 세션을 찾아낸다.

세션을 옮기지 않고 접근 권한만 추가하려면 /add-dir 다. 이동 대상을 제한하려면 Cd 권한 규칙을 쓴다.

현재 세션에서 파일 접근이 가능한 작업 디렉터리를 추가한다. 성공하면 DirectoryAdded 훅이 돈다. 응답 중에 실행하면 바로 확인을 묻고, 확인하면 같은 턴의 다음 도구 호출부터 접근된다 (v2.1.234+).

Claude in Chrome 설정을 구성한다. 내 실제 Chrome 의 로그인 세션을 그대로 쓰는 경로이므로, 로그인이 필요한 화면을 다뤄야 할 때 쓴다.

마지막 응답을 클립보드로 복사한다. 숫자를 주면 N번째 최신 응답을 복사한다(/copy 2). 코드 블록이 있으면 블록 단위로 고르는 선택기가 뜨고, 거기서 w 를 누르면 클립보드 대신 파일로 쓴다 — SSH 로 붙어 있을 때 유용하다.

Anthropic 계정에 로그인·로그아웃한다. 개인 계정과 업무 계정을 오갈 때, 그리고 구독이 필요한 기능(원격 제어·텔레포트 등)이 인증을 요구할 때 쓴다.

상위 플랜으로 바꾸는 페이지를 브라우저에서 연다. CLI 자체를 업데이트하는 명령이 아니라 요금제 변경이다 — 버전 업데이트는 릴리스 채널 쪽이고 /doctor 가 새 버전 유무를 알려준다.

현재 백그라운드 세션을 세운다. 붙어 있는 동안만 쓸 수 있고, 대화 기록과 워크트리는 남는다. 세우지 않고 빠져나오려면 /exit 이나 왼쪽 화살표를 쓴다.

초벌 이관 때 "웹 검색 도구 활성화"로 적혀 있었으나, 공식 명령 표(2026-08-24 확인)에 /web 이 없다. 이름이 바뀌었거나 사라진 것으로 보인다.

대신 찾을 곳: 웹 세션용 GitHub 연결은 /web-setup, 도구 허용·차단은 /permissions, 웹 검색 자체는 도구 권한과 설정에서 다룬다.

포커스 뷰를 토글한다 — 마지막 프롬프트, 요약된 도구 호출 통계, 최종 응답만 보여준다. 도구 호출 요약에서 이번 턴에 시작된 서브에이전트 수도 세고, 완료된 백그라운드 작업 알림을 하나로 합친다. 전체화면 렌더링에서만 사용 가능하다. 설정의 viewMode 로 덮어쓸 수 있다.

IDE 통합을 관리하고 상태를 보여준다. VS Code 등 IDE에서 Claude Code를 사용할 때 연결 상태와 설정을 확인하는 용도다.

대화형 버전 선택기로 변경 로그를 연다. 특정 버전을 선택해 해당 버전의 릴리스 노트를 보거나, 모든 버전을 표시할 수도 있다. 노트는 대화 기록에 추가되지만 Claude 가 보는 대화에는 들어가지 않는다.

Claude Code 스티커를 주문하는 페이지를 연다.

친구와 Claude Code를 무료로 1주일 공유할 수 있는 패스를 제공한다. 계정이 자격이 있을 때만 보인다.

브라우저에서 Claude FM lo-fi 라디오를 연다. 브라우저가 없으면 스트림 URL을 출력한다. 일부 플랫폼(Amazon Bedrock, Google Cloud Agent Platform, Microsoft Foundry, Claude Platform on AWS)에서는 사용할 수 없다.

애니메이션 데모가 있는 빠른 대화형 레슨으로 Claude Code 기능을 발견한다.

마우스 휠 스크롤 속도를 대화형으로 조정한다. 대화상자가 열린 상태에서 눈금을 스크롤하며 변경사항을 미리 볼 수 있다. 전체화면 렌더링에서만 사용 가능하며 JetBrains IDE 터미널에서는 사용할 수 없다.

Amazon Bedrock 인증·리전·모델 핀을 대화형 마법사로 설정한다. CLAUDE_CODE_USE_BEDROCK=1 이 설정되기 전까지는 명령 메뉴에 보이지 않으므로 전체 이름을 입력해야 한다. 첫 Amazon Bedrock 사용자는 로그인 화면에서도 이 마법사에 접근할 수 있다.

Google Cloud Agent Platform 인증·프로젝트·리전·모델 핀을 대화형 마법사로 설정한다. CLAUDE_CODE_USE_VERTEX=1 이 설정되기 전까지는 명령 메뉴에 보이지 않으므로 전체 이름을 입력해야 한다. 첫 Google Cloud Agent Platform 사용자는 로그인 화면에서도 이 마법사에 접근할 수 있다.

저장소에 Claude GitHub App 을 설치한다. 저장소를 고르는 단계와 연동 설정을 안내하고, GitHub Actions 워크플로와 시크릿까지 같이 잡아 주는 선택 단계가 붙는다. PR 에서 Claude 를 부르거나 CI 안에서 돌리려면 여기가 출발점이다.

Claude Slack 앱을 설치한다. 브라우저가 열려 OAuth 흐름을 마치면 워크스페이스에서 Claude 를 부를 수 있다.

대화형 버전 선택기로 체인지로그를 본다. 특정 버전의 노트만 보거나 전체를 펼칠 수 있다.

노트는 화면에만 뜨고 Claude 가 보는 대화에는 들어가지 않는다 — 긴 릴리스 노트를 읽어도 컨텍스트가 늘지 않는다.

프로젝트 언어에 맞는 Claude API·Managed Agents 참고자료를 불러오는 번들 스킬이다. 코드가 anthropic 이나 @anthropic-ai/sdk 를 임포트하면 자동으로도 켜진다.

하위 명령: migrate 는 기존 API 코드를 새 모델로, upgrade 는 SDK 의존성을 메이저 버전 너머로, managed-agents-onboard 는 Managed Agent 생성 안내, prompt-audit 는 옛 모델 기준으로 쓰인 지시를 찾아 수정안을 diff 로 제시한다.

질문 하나에 대해 웹 검색을 부채꼴로 펼치고, 출처를 가져와 교차 확인한 뒤 인용이 붙은 보고서로 합치는 번들 워크플로다. 백그라운드에서 돌고, 내가 부를 때만 시작한다 (v2.1.218 이전에는 Claude 가 스스로 시작할 수도 있었다).

차트·그래프·대시보드의 설계 지침을 불러오는 번들 스킬이다(v2.1.198+). 데이터에 맞는 차트 형태를 고르고, 색을 역할에 따라 배정하고, 번들 스크립트로 색약 안전성과 명암비를 검증하고, 마크·인터랙션·접근성 규칙을 적용한다. 팔레트는 브랜드 중립 자리표시자이므로 내 것으로 교체한다.

저장소의 React 디자인 시스템을 변환해 Claude Design 에 올린다 — 이후 생성되는 디자인이 내 실제 컴포넌트를 쓰게 된다. 이름을 붙일 수도 있다(/design-sync Acme DS).

첫 동기화는 모든 컴포넌트를 검증하므로 큰 저장소에서는 몇 시간이 걸릴 수 있다. Bedrock·Vertex·Foundry 등에서는 claude.ai 에 닿지 못해 쓸 수 없다.

최근 30일의 세션·명령·MCP 사용 기록을 분석해 팀 온보딩 가이드를 마크다운으로 만든다. 동료가 첫 메시지로 붙여 넣으면 바로 세팅이 되는 형태다. claude.ai 유료 플랜에서는 Claude Code 에서 바로 열리는 공유 링크도 돌려준다.

마지막 프롬프트, 한 줄로 요약된 도구 호출(편집 diffstat 포함), 최종 응답만 남기는 화면으로 바꾼다. 요약 줄은 그 턴에 띄운 서브에이전트 수를 세고, 끝난 백그라운드 작업 알림을 하나로 합친다.

선택은 세션을 넘어 유지되고, 설정의 viewMode 로 덮어쓸 수 있다. 전체화면 렌더링에서만 쓸 수 있다.

브라우저에서 Claude FM 로파이 라디오를 연다. 브라우저를 열 수 없는 환경에서는 스트림 URL 을 출력한다. Bedrock·Vertex·Foundry 등에서는 쓸 수 없다.

애니메이션 데모가 붙은 짧은 대화형 레슨으로 기능을 익힌다. 문서를 읽는 대신 한 기능씩 실제로 눌러 보는 방식이라 처음 붙는 사람에게 권할 만하다.

친구에게 Claude Code 1주 무료 체험을 공유한다. 계정이 대상일 때만 목록에 보인다.

claude.ai 계정으로 /design-sync 가 쓸 디자인 시스템 접근 권한을 승인한다. 동기화가 권한 문제로 막히면 여기부터 확인한다.

터미널 UI 렌더러를 정하고 대화를 유지한 채 그 렌더러로 다시 띄운다. fullscreen 은 깜빡임 없는 대체 화면 렌더러를 켠다. 인자 없이 실행하면 현재 렌더러를 출력한다. /focus 나 /scroll-speed 처럼 전체화면에서만 되는 기능의 전제 조건이다.

마우스 휠 스크롤 속도를 대화형으로 조정한다. 대화상자가 열린 상태에서 바로 굴려 보며 확인할 수 있는 자가 함께 뜬다. 전체화면 렌더링에서만 쓸 수 있고 JetBrains IDE 터미널에서는 쓸 수 없다.

음성 입력을 켜거나 특정 방식으로 지정한다 — hold 는 누르고 있는 동안, tap 은 눌러서 시작·정지. Claude.ai 계정이 필요하다.

내 계정 기준으로 모든 프로젝트에서 쓴다. 저장소에 흔적이 남지 않으므로 동료의 환경에는 영향이 없다 — 내 작업 습관에 속한 도구는 여기가 맞다.

.claude/settings.json 에 기록되므로 커밋되면 협업자 전원에게 같이 깔린다. 팀이 함께 쓰기로 합의한 것만 여기 넣는다.

나만 빼고 싶을 때는 제거가 아니라 .claude/settings.local.json 의 무효화로 처리된다 — 제거하면 남에게서도 사라진다.

이 저장소에서 나만 쓴다(.claude/settings.local.json). 프로젝트에 필요하지만 팀에 강요하고 싶지 않은 도구를 붙일 자리다.

관리자가 관리형 설정으로 설치한 것이라 내가 바꿀 수 없다. 목록에 보이는데 비활성화가 안 되면 이 스코프인지 확인한다.

플러그인 스킬은 plugin-name:skill-name 으로 네임스페이스가 붙는다. 그래서 내 프로젝트의 같은 이름 스킬과 충돌하지 않고 나란히 존재한다.

네임스페이스가 없는 쪽의 우선순위는 enterprise → personal → project 순으로 덮어쓰며, 같은 이름의 스킬과 .claude/commands/ 명령이 함께 있으면 스킬이 이긴다.

이 계열은 Claude Code 내장 LSP 도구를 켜는 설정 묶음이다. 바이너리는 플러그인이 깔아 주지 않으므로 표의 것을 직접 설치해야 한다. 얻는 것은 둘이다.

자동 진단 — 파일을 편집할 때마다 언어 서버가 에러·경고를 돌려준다. 컴파일러나 린터를 돌리지 않고도 타입 오류·누락된 임포트를 그 턴 안에서 알아채고 고친다. 직접 읽으려면 "Found N new diagnostic issues" 표시가 뜰 때 Ctrl+O 를 누른다.

정밀 탐색 — 정의로 이동, 참조 찾기, 타입 정보, 심볼 목록, 구현 찾기, 호출 계층. grep 기반 검색보다 정확하다(언어·환경에 따라 가용 범위는 다르다).

MCP 서버가 미리 구성된 채로 온다 — 토큰·엔드포인트를 손으로 적을 일이 없다. PR·이슈를 읽고 쓰는 작업이 잦으면 gh CLI 만으로 버티기보다 이쪽이 편하다.

Figma 연동. 저장소의 React 디자인 시스템을 Claude Design 에 올리는 /design-sync 와는 다른 축이다 — 이쪽은 디자인 파일을 읽는 연결이다.

Slack 연동. 워크스페이스에서 Claude 를 부르는 앱 설치는 /install-slack-app 쪽이고, 이것은 세션에서 Slack 을 읽고 쓰는 MCP 연결이다.

Claude 가 만드는 변경마다 흔한 취약점을 검토하고 같은 세션에서 고치도록 지시한다. 브랜치 전체를 한 번에 보는 /security-review 와 달리 변경 단위로 계속 붙는 방식이다. 프로젝트별 규칙을 추가할 수도 있다.

커밋·푸시·PR 생성 흐름을 스킬로 제공한다. 설치 후에는 /commit-commands:commit 처럼 네임스페이스가 붙은 이름으로 부른다.

PR 리뷰에 특화된 에이전트 묶음. 내장 /code-review 로 부족할 때, 관점을 나눠 여러 번 돌리는 용도로 얹는다.

agent-sdk-dev 는 Claude Agent SDK 로 만들 때, plugin-dev 는 플러그인을 직접 만들 때 쓰는 도구 묶음이다. 남의 플러그인을 쓰는 쪽이 아니라 만드는 쪽에 필요한 것들이다.

구현 선택의 근거를 함께 설명하는 출력 스타일. 남의 코드베이스에 처음 붙을 때, 결과만 받는 대신 왜 그렇게 했는지 같이 읽고 싶을 때 쓴다.

학습을 위한 대화형 모드. 답을 바로 주기보다 짚어 가며 익히게 한다. 출력 스타일 계열은 호출 기록이 남지 않아도 값을 주므로, 미사용 정리 대상에서 빠진다.

설치 화면에 그 플러그인이 매 턴 추가하는 토큰 비용이 표시된다. 기능이 마음에 들어도 이 값이 크면 상주 비용이 계속 나간다 — 자주 쓰지 않을 것이면 필요할 때만 켜는 편이 낫다.

Installed 탭은 2주 이상, 10세션 이상 쓰지 않은 플러그인을 "Not used recently" 머리말 아래로 모아 준다. 상세 화면에는 Last used 줄이 붙는다. 쓰지 않는데 시작·컨텍스트 비용만 내는 것을 여기서 골라 끄거나 지운다.

예외: 조직이 관리하는 것과 --plugin-dir 로 불러온 것, 그리고 테마·출력 스타일·모니터· 워크플로를 제공하는 것은 호출 기록 없이도 값을 주므로 미사용으로 분류되지 않는다. LSP 플러그인은 진단이나 탐색 요청에 응답하면 사용으로 집계된다(v2.1.203+).

공식 마켓(claude-plugins-official)은 첫 대화형 실행에서 자동으로 추가되지만, 커뮤니티 마켓은 직접 추가한다.

Anthropic 의 자동 검증·안전성 심사를 통과한 서드파티 플러그인이 올라가고, 각 항목이 특정 커밋 SHA 에 고정되어 있다. 설치 이름은 @claude-community 다.

재적용은 다음 요청에 비용을 남긴다 — 새로 올라온 구성 요소가 대화에 덧붙는 형태로 스스로를 알린다. MCP 서버를 제공하는 플러그인은 도구가 지연 로드되지 않는 경우 캐시가 깨져 대화 전체를 다시 읽는다.

캐시를 깨뜨릴 상황이면 명령이 경고하고 건너뛰며, --force 로 다시 불러야 진행한다.

내장 명령은 도구 자체를 조작한다 — 컨텍스트를 자르고, 모델을 바꾸고, 권한을 정하고, 상태를 읽는다. 동작이 CLI 에 박혀 있으므로 내가 바꿀 여지가 없고, 그래서 예측 가능하다.

일부는 내장이 아니라 번들 스킬이다(/code-review, /simplify, /verify, /doctor, /loop, /batch 등) — 프롬프트가 Claude 에게 넘겨지는 형태라 상황에 따라 Claude 가 스스로 부를 수도 있다.

플러그인은 스킬·에이전트·MCP 서버·훅·LSP 서버를 한 묶음으로 배포하는 단위다. 설치 후에는 plugin-name:skill-name 네임스페이스로 부른다.

판단 기준은 배포 여부다 — 나 혼자 반복하는 것은 .claude/skills/ 파일 한 장이면 끝이고, 팀·조직에 나눠 주고 버전을 관리해야 하는 것부터 플러그인이 값을 한다.

커스텀 명령은 스킬로 통합됐다. 같은 이름의 스킬과 명령이 둘 다 있으면 스킬이 이긴다 (.claude/commands/deploy.md 와 .claude/skills/deploy/SKILL.md 가 함께 있으면 /deploy 는 스킬을 실행한다).

스킬은 디렉터리라 보조 파일을 함께 담을 수 있고 프런트매터로 도구·모델·강도까지 지정한다 — 명령 파일에서 옮겨 갈 이유가 대개 여기 있다.

두는 위치가 누가 쓸 수 있는지를 정한다.

개인 ~/.claude/skills/<name>/SKILL.md — 내 모든 프로젝트. 프로젝트 .claude/skills/<name>/SKILL.md — 이 프로젝트만. 플러그인 <plugin>/skills/<name>/SKILL.md — 플러그인이 켜진 곳.

같은 이름이 겹치면 enterprise → personal → project 순으로 덮어쓴다. .claude/commands/*.md 도 같은 방식으로 동작하지만, 스킬과 이름이 겹치면 스킬이 이긴다.

자주 쓰는 필드: name(표시 이름, 기본값은 디렉터리 이름), description(무엇을·언제), when_to_use(트리거 문구), argument-hint(자동완성 힌트), arguments(이름 붙은 위치 인자), allowed-tools/disallowed-tools(그 턴 동안의 도구 허용·차단), model·effort(그 턴만 모델·추론 강도 덮어쓰기), context: fork(포크된 서브에이전트로 실행), paths(글롭에 맞는 파일을 다룰 때만 자동 로드), disable-model-invocation(내가 부를 때만), user-invocable: false(Claude 만 부름), hooks, shell, metadata, license.

description 과 when_to_use 를 합친 길이는 목록에서 1,536자에서 잘린다 — 핵심 용례를 앞에 둘 것.

$ARGUMENTS 는 명령 이름 뒤에 온 전체 문자열로 치환된다. 위치별로 쓰려면 $ARGUMENTS[N] 또는 짧게 $N 을 쓴다(/migrate-component SearchBar React Vue → $0=SearchBar, $1=React, $2=Vue).

인자를 넘겼는데 본문에 $ARGUMENTS 가 없으면 내용 끝에 ARGUMENTS: <입력> 이 덧붙는다 — 누락돼도 입력 자체는 Claude 에게 전달된다.

터미널을 열지 않고 카탈로그를 훑을 때. 설치는 결국 /plugin install <name>@claude-plugins-official 이다.

커뮤니티 집계다. Anthropic 은 설치 통계를 공개하지 않으므로 여기의 순위는 공식 수치가 아니다 — 참고로만 본다.

2026-08-25 실측. 여러 프로젝트·세션에서 같은 실패를 반복해서 겪었고, 원인은 코드가 아니라 브라우저 패널이 화면에 보이지 않는 것이었다.