예전에 이런 글을 쓴 적이 있어요.

그 뒤로 4개월 넘게 파고들어 쓰다 보니, 이제야 제법 다룰 줄 알게 됐다는 느낌이 들어요.

쓰면서 느끼는 건, 코드를 짜거나 툴·MCP를 호출하는 등 온갖 작업을 Claude에게 시키는 한편으로 Claude Code 자체의 조작·제어는 내가 직접 해야 한다는 점입니다. 세션 전환, 이상한 방향으로 흘렀을 때의 되감기, 설정과 스킬 개선…… 이런 걸 아느냐 모르느냐에 따라 사용 경험이 상당히 달라집니다.

이 글에서는 제가 매일같이 쓰는 커맨드·스킬 10개를 소개할게요.

세션 관리

Claude Code에서는 대화 이력 한 덩어리를 "세션"이라고 부릅니다. 태스크마다 세션을 바꿔 가며 쓰게 되므로, 이 카테고리의 커맨드는 필수급입니다.

/clear

지금 세션을 끝내고 빈 컨텍스트로 새 세션을 시작합니다.

포인트는 그때까지의 세션이 사라지는 게 아니라 /resume으로 언제든 돌아갈 수 있다는 것. 그러니 부담 없이 /clear 하셔도 됩니다. /clear 인증 버그 조사처럼 이름을 붙이면 방금 끝낸 세션에 라벨이 달려서, 나중에 /resume 목록에서 찾기 쉬워집니다.

같은 세션을 유지한 채 컨텍스트를 절약하는 /compact도 있지만, 개인적으로는 잘 안 씁니다. compact가 잘 안 되면 컨텍스트가 부분적으로 빠져서 이후 응답이 흔들리기 쉬우니, 그럴 바에는 인수인계 프롬프트를 출력하게 해서 새 세션에 넘기는 쪽이 안정적이라는 게 지금까지의 체감입니다.

/resume

과거 세션 목록에서 골라 재개합니다.

• 어제 하던 걸 이어서 하고 싶다
• /clear 했는데 역시 아까 컨텍스트가 필요했다
• 설정을 업데이트한 뒤 Claude Code 재시작이 필요해서, 재시작 후 아까 작업으로 돌아가고 싶다

이런 상황에서 자주 씁니다. 재시작이 필요할 때는 종료 시 claude --resume <session-id>로 재개하는 커맨드가 표시되므로, 그 커맨드로 돌아가기도 해요. /clear와 세트로 기억해 두면 좋아요.

/rewind

대화와 코드를 과거 상태로 되돌립니다. 프롬프트를 보낼 때마다 체크포인트가 자동으로 만들어지며, 메뉴에서 되돌리고 싶은 프롬프트를 고르면 다음 5가지 중에서 조작을 선택할 수 있습니다.

• 대화와 코드 둘 다 되돌리기
• 대화만 되돌리기 (코드는 지금 그대로)
• 코드만 되돌리기 (대화는 지금 그대로)
• 그 이후 요약하기: 선택한 지점보다 뒤의 대화를 요약으로 치환한다. 곁길로 샌 논의를 정리하고 초반 컨텍스트는 남기고 싶을 때 쓴다
• 그 이전 요약하기: 선택한 지점보다 앞의 대화를 요약으로 치환한다. 초반의 긴 서두를 정리하고 최근 대화는 남기고 싶을 때 쓴다

개인적으로는 대화와 코드 둘 다 되돌리기나 대화만 되돌리기를 쓸 때가 많습니다. "지시를 잘못해서 이상한 방향으로 가 버렸을" 때 대화만 되돌려 프롬프트를 다시 쓰는, 이런 식으로 쓸 수 있어 편리합니다.

입력란이 빈 상태에서 Esc를 두 번 눌러도 열 수 있습니다.

요약 계열 2개는 /compact의 부분판입니다. 앞에서 "/compact는 잘 안 쓴다"고 했지만, 이쪽은 "어디를 정리할지"를 직접 고를 수 있어서 사고가 덜 나므로 쓰는 상황이 있습니다.

주의할 점으로, rm이나 mv 같은 bash 커맨드에 의한 변경은 추적되지 않습니다. 되돌릴 수 있는 건 Claude의 편집 툴에 의한 파일 변경뿐입니다.

Claude Code 커스터마이즈

여기서부터는 Claude Code를 내 사용 방식에 맞게 키워 가기 위한 커맨드·스킬입니다. 개인적으로는 이 카테고리를 제일 추천합니다.

/insights

내 Claude Code 세션을 분석한 리포트를 HTML로 생성해 줍니다(~/.claude/usage-data/report-YYYY-MM-DD-HHMMSS.html에 저장되어 브라우저로 여는 형태).

내용물은 리포트 생성 시점의 버전에 따라 달라질 것 같지만, 제가 시험했을 때는 대략 이런 내용이 담겨 있었습니다.

• 기간 중 사용 현황 집계 (메시지 수, 편집 행 수, 자주 만지는 프로젝트 영역 등)
• 잘 돌아가고 있던 사용 패턴
• 어디서 자주 막히는가(friction points). Claude 쪽 문제(추측으로 단정한다, CLAUDE.md 규칙을 무시한다 등)와 사용자 쪽 문제(전제를 처음에 안 건넸다 등)를 구분해서 지적해 준다
• 아직 안 쓰고 있는 기능·패턴 제안
• 모델이 발전하면 가능해질 법한 자동화 워크플로 제안

이 리포트를 바탕으로 CLAUDE.md나 스킬을 개선하는 사이클을 정기적으로 돌리는 걸 추천해요.

다만 리포트는 영어 고정입니다(아마 한국어화되지 않을 겁니다). 읽기 힘들 때는 Claude Code에 "~/.claude/usage-data/report-...html 읽고 한국어로 요점만 설명해 줘"라고 부탁하면, HTML을 Read 해서 간추려 한국어로 풀어 줍니다. 리포트를 기점으로 "그럼 CLAUDE.md에 이 규칙을 추가할까" 같은 식으로 대화를 이어갈 수 있어서, 결과적으로 이쪽이 개선 사이클을 돌리기 더 쉬운 것 같기도 해요.

/update-config

settings.json(permissions, 환경 변수, hooks 등)의 변경을 Claude Code 자신에게 시키는 스킬입니다.

Claude Code 설정은 스코프(user / project / local) 구분이나 hooks 서식 등 제법 복잡해서, 손으로 쓰는 것보다 "gh pr view는 확인 없이 실행되게 해 줘", "응답이 끝나면 데스크톱 알림이 뜨게 hook 심어 줘"처럼 한국어로 부탁하는 게 빠르고 정확합니다. Claude Code의 설정은 Claude Code에게 맡깁시다.

다만 permissions.allow의 내용물은 Claude가 "하는 김에 범위를 넓혀" 버릴 때가 있습니다(Bash(gh pr view *) 의뢰에 Bash(gh *)를 제안해 오는 등). 적용 전 diff는 직접 읽고 확인해서, 너무 넓은 allow가 섞이지 않게 하세요.

설정 변경을 요청하면 자동으로 기동될 때도 있지만, 기동되지 않고 Claude가 settings.json을 직접 편집하려 들 때도 있습니다. 확실하게 스킬 경로를 거치게 하고 싶을 때는 /update-config라고 명시적으로 입력하는 게 안전합니다.

/skill-creator

스킬 작성·개선을 도와주는 Anthropic 공식 플러그인입니다. 기본으로는 들어 있지 않아서 /plugin에서 공식 마켓플레이스를 추가해 설치해야 합니다.

[역주 — 참고] 원문의 이 위치에는 설치 절차를 다룬 다른 Qiita 글의 임베드 카드가 있으나, 임베드 형식이라 URL을 추출할 수 없었습니다.

맨땅에서 새로 만드는 것뿐 아니라 기존 스킬 개선이나, 스킬이 의도대로 발동하는지 평가하는 데도 쓸 수 있습니다. 자기 방식대로 SKILL.md를 쓰는 것보다 베스트 프랙티스에 맞는 형태로 다듬어 준다는 게 장점이에요.

특히 효과가 큰 건 description 튜닝입니다. description은 Claude가 "지금 이 스킬을 써야 하나"를 판단하는 유일한 재료라서, 여기가 모호하면 auto-trigger 되지 않습니다. /skill-creator에 기존 스킬을 건네고 "더 잘 발동되게 해 줘"라고 부탁하면, 트리거가 될 만한 한국어 프레이즈를 description에 나열해 줍니다.

/fewer-permission-prompts

과거 세션 로그를 스캔해서 자주 실행하는 읽기 전용 Bash·MCP 툴 호출을 추려낸 다음, 프로젝트의 .claude/settings.json에 허용 리스트로 추가해 주는 스킬입니다.

"전부 허용하기는 무섭다. 그렇다고 매번 엔터 치기는 귀찮다"는 고민에 딱 맞는 절충점을 만들어 줍니다.

포인트가 몇 가지 있습니다.

• 읽기 전용 한정: gh pr view, gh issue list, aws ... describe-* 같은 부작용 없는 커맨드만 후보가 된다. rm이나 gh secret set 같은 쓰기 계열은 후보에서 빠지므로, 대충 승인해도 사고가 덜 난다
• 빈도순 제안: 몇 번 호출됐는지를 곁들여 나열해 주므로 "매일 치는 것부터 허용해 간다"는 판단이 쉽다
• 채택은 1건씩 고를 수 있다: 일괄 적용이 아니라 후보마다 OK/NG를 고를 수 있으므로, /update-config 절에서 쓴 "너무 넓은 allow가 끼어드는" 사고도 잘 안 난다
• 기본은 프로젝트 단위, 지시하면 user scope에도: 아무것도 지정하지 않으면 프로젝트의 .claude/settings.json에 추가된다. 리포지토리 횡단으로 허용하고 싶을 때는 "user scope에 해 줘"라고 부탁하면 ~/.claude/settings.json에 써 준다

/insights로 세션 돌아보기 → /fewer-permission-prompts로 허용 정리 → /update-config로 hook 심기, 이렇게 조합하면 Claude Code를 쓰면 쓸수록 내 손에 맞게 최적화되어 갑니다.

그 외

/copy

직전 응답을 클립보드에 복사합니다.

터미널에서 드래그로 선택해 복사하면 행 앞의 인덴트(스페이스 2칸)까지 같이 딸려 와서 은근히 스트레스인데, /copy를 쓰면 그럴 걱정이 없어요.

응답에 코드 블록이 들어 있으면 전체를 복사할지 특정 코드 블록만 복사할지 고르는 피커가 뜨는 것도 편리해요. /copy 2처럼 번호를 넘기면 두 개 전 응답을 복사할 수 있습니다.

참고로 /tui fullscreen으로 fullscreen rendering 모드를 켜 두면(버전에 따라서는 업데이트 후 첫 기동 때 다이얼로그로 물어보는데, 거기서 OK 했다면 이미 켜져 있습니다) 클릭&드래그로 고른 범위가 마우스를 떼는 순간 자동으로 클립보드에 들어갑니다. 터미널 쪽 선택이 아니라 Claude Code 내부 선택을 쓰므로 행 앞 인덴트를 끌어들이지 않습니다. 응답의 일부만 필요할 때는 이쪽이 빠르니 /copy와 구분해 쓰고 있습니다.

/loop와 /schedule

이 둘은 사실 커맨드가 아니라 스킬입니다(/로 호출할 수 있어서 사용감은 같습니다).

/loop는 세션을 연 채로 같은 프롬프트를 반복 실행합니다.

/loop 5m CI 통과하면 알려 줘

간격을 생략하면 Claude가 상황에 맞춰 스스로 실행 페이스를 정해 줍니다.

/schedule은 Anthropic 클라우드에서 정기 실행되는 태스크(Routine)를 대화식으로 만드는 스킬입니다. 로컬 세션을 열어 둬야 하는 /loop와 달리 PC를 닫아 놔도 돌아가는 게 특징이라, 매일 아침 정보 수집이나 정기 점검에 어울립니다.

요즘 Claude Code는 커맨드를 백그라운드 태스크로 실행해 완료를 기다릴 수 있게 되어서, CI 감시 같은 용도에서는 /loop를 꺼낼 일이 조금 줄었지만, 그래도 외부 상태를 정기적으로 확인하러 가고 싶을 때는 요긴합니다.

실무에서 알아 두면 좋은 제약을 덧붙입니다. /loop로 만든 반복 태스크는 세션 스코프라 새 세션을 시작하면 멈추고, 안전장치로 일정 기간(반복 태스크 기준 약 3일) 후 만료됩니다. 또 /schedule로 만든 Routine은 자율 실행 특성상 기본적으로 claude/ 접두사 브랜치에만 푸시할 수 있고 main에는 직접 푸시하지 못하도록 가드가 걸려 있습니다. 자세한 내용은 공식 문서를 참고하세요: https://code.claude.com/docs/en/scheduled-tasks

마치며

2개월 파고들어 쓰면서 손에 익은 커맨드를 모아 보니, 세션 전환과 Claude Code 자체의 커스터마이즈에 치우쳐 있었습니다. 실제 작업(코드 짜기, 조사, PR 올리기 등)은 Claude에게 프롬프트로 부탁할 뿐이라 커맨드를 직접 칠 일은 별로 없었다는 얘기인 것 같습니다. 코드를 짜는 건 Claude Code, Claude Code를 다듬는 게 사람의 일, 이런 식으로 역할이 나뉘어 가는 느낌입니다.

또 노하우가 쌓이면 글로 정리해 볼까 합니다.

덤: 이번에 소개한 커맨드 분류

/로 부를 수 있어서 사용감은 같지만, 내용물은 내장 커맨드·내장 스킬·플러그인으로 나뉩니다.