Claude Code를 오래 쓰게 되면, 실력 차이는 "프롬프트 문장력"보다 조작 숙련도에서 크게 벌어집니다. 같은 일을 하더라도, 어떤 사람은 화면을 덜 헤매고 더 적은 입력으로 끝냅니다. 그 차이는 곧 토큰(불필요한 대화), 시간(재실행/재설명), 주의력(맥락 전환) 낭비의 차이로 이어집니다.
이 챕터의 목표는 간단합니다. 작업 중 자주 쓰는 조작을 '손에 익힌 루틴'으로 만들어, Claude Code를 키보드 중심 작업대로 쓰는 감각을 갖추는 것입니다.
슬래시 커맨드: "말로 설명하지 말고, 버튼을 누른다"
Claude Code에서 /로 시작하는 커맨드는 "대화를 잘 쓰는 능력"과 별개로, 세션을 빠르게 제어하는 스위치입니다. 세션을 시작하면 /help로 가능한 명령을 확인하고, 이전 대화를 이어서 하려면 /resume을 쓰라고 안내합니다.1
반드시 외워야 할 3개: /help, /clear, /resume
/help는 길을 잃을 때의 나침반입니다. 기능이 기억나지 않으면, "설명해줘"가 아니라 /help로 목록을 보고 바로 이동하는 편이 빠릅니다.1
/clear는 현재 세션의 대화 히스토리를 초기화합니다. 중요한 포인트는 "기록을 지운다"가 아니라, 현재 작업의 맥락 오염을 끊는다는 데 있습니다. 명령 히스토리도 /clear 이후에는 새 세션 기준으로 리셋되지만, 이전 세션은 보존되어 재개(resume)할 수 있다는 점을 기억해 두세요.2
/resume은 "어제 하던 일을 오늘 이어서"의 기본입니다. 웰컴 화면에서도 /resume으로 이전 대화를 이어갈 수 있다고 안내합니다.1 그리고 CLI 차원에서도 claude -r <session> 형태로 세션 ID나 이름으로 재개할 수 있습니다.3
이 셋만 익히면, "하다가 꼬이면 처음부터 다시 설명" 같은 낭비가 크게 줄어듭니다.
슬래시 커맨드를 '입력 중간'에 끼워 넣는 습관
작업하다가 프롬프트를 길게 쓴 뒤에 "아, 이건 새 작업이라 /clear부터 해야 했는데" 같은 상황이 자주 생깁니다. 이때 중요한 습관은 하나입니다.
프롬프트를 버리지 말고, 먼저 세션 상태를 정리한 뒤 다시 제출한다.
/clear로 맥락을 비우고필요한 파일만 다시 참조(@참조, 다음 절)
같은 요청을 더 짧게 다시 제출
이 순서로 움직이면, 같은 내용을 두 번 설명하는 횟수가 줄어듭니다.
@참조(파일 멘션): 컨텍스트를 '정확히' 넣는 기술
Claude Code는 @로 파일 경로 자동완성(멘션)을 지원합니다.2 이 기능은 단순 편의가 아니라, "Claude가 어디를 보고 답했는지"를 명확히 하여 추측 기반 대화를 줄여 줍니다.
언제 @참조를 쓰는가
Claude에게 "이 코드가 왜 그래?"라고 묻고, 답이 애매하게 돌아오면 보통 원인은 둘 중 하나입니다.
첫째, Claude가 파일을 아직 안 읽었거나, 둘째, 너무 넓은 범위를 읽어 요지가 흐려진 경우입니다. 이럴 때는 파일을 직접 멘션해 대상을 고정하는 게 가장 빠릅니다.
예를 들어 이런 식입니다.
@src/auth/login.ts 이 파일에서 토큰 만료 처리 흐름을 10줄로 요약해줘@README.md 설치 단계 중 빠진 전제조건이 있는지 찾아서 수정 제안해줘
핵심은 "파일을 읽어줘"가 아니라 "이 파일을 기준으로, 무엇을 산출할지"를 함께 지정하는 것입니다.
'필요한 만큼만' 참조하는 요령
@참조는 강력하지만, 무조건 많이 붙인다고 좋은 답이 나오지 않습니다. 파일을 많이 붙일수록 컨텍스트가 비싸지고(토큰), 답이 산만해질 가능성이 커집니다.
이 챕터의 기준은 다음 두 문장으로 충분합니다.
하나는 "결정이 내려지는 파일 1개(엔트리포인트)"이고, 다른 하나는 "결정이 소비되는 파일 1개(호출부)"입니다. 대개 두 개면 흐름이 잡힙니다.
히스토리: '같은 명령을 두 번 치지 않는' 법
CLI에서 생산성이 떨어지는 순간은 보통 "방금 쓴 걸 다시 치는 시간"입니다. Claude Code는 세션 내 입력 히스토리를 제공하며, 작업 디렉터리별로 저장됩니다.2
Up/Down과 Ctrl+R(역방향 검색)을 루틴으로
Up/Down 화살표로 이전 입력을 불러올 수 있고, Ctrl+R로는 히스토리 역방향 검색이 가능합니다.2
Ctrl+R은 단순 '찾기'가 아니라, 자주 쓰는 작업을 사실상 "프롬프트 스니펫"처럼 재사용하게 해 줍니다. 예를 들어 test만 입력해도 과거의 ! pnpm test나 "테스트 실패 고쳐줘" 같은 문장이 빠르게 떠오릅니다.
검색 중에는 다음 동작을 기억해 두면 충분합니다.
Ctrl+R을 다시 누르면 더 이전 매치로 이동Enter로 즉시 실행,Tab또는Esc로 불러온 뒤 편집Ctrl+C로 취소하고 원래 입력 복원
모든 건 "다시 타이핑하지 말고, 찾아서 고쳐 쓰자"로 귀결됩니다.2
프롬프트를 '외부 편집기'로 빼는 Ctrl+G
길거나 구조적인 지시(예: 단계별 계획 + 검증 기준 + 산출물 형식)는 한 줄 입력창에서 쓰면 품질이 급격히 떨어집니다. Claude Code는 Ctrl+G로 기본 텍스트 편집기에서 프롬프트를 편집할 수 있게 해 줍니다.2
이 기능이 익숙해지면, 긴 프롬프트를 '한 번에 제대로' 써서 재질문을 줄이고, 결과적으로 토큰과 시간을 절약합니다.
큐잉(Queueing): "기다리지 않고, 쌓아두고, 이어서 한다"
여기서 말하는 큐잉은 메시지 큐 제품을 쓰는 이야기가 아닙니다. 감각을 만들기 위한 비유로, '지금 당장 처리할 일'과 '뒤에서 돌아가도 되는 일'을 분리하는 습관을 말합니다.
컴퓨팅에서 큐(queue)는 메시지를 중간 버퍼에 저장해 두고, 처리자가 준비되면 순서대로 꺼내 처리하게 해 생산자와 소비자를 분리합니다.4 Claude Code에서도 비슷한 사고방식이 유용합니다.
1) Bash 작업을 백그라운드로 보내기(Ctrl+B)
빌드, 테스트, 개발 서버처럼 오래 걸리는 작업은 "기다리는 동안" 집중력이 무너집니다. Claude Code는 Bash 명령이나 에이전트 작업을 비동기로 백그라운드 실행할 수 있고, Ctrl+B로 일반 실행을 백그라운드로 보낼 수 있습니다.2
예를 들어 이런 흐름이 가능합니다.
! pnpm test를 실행하다가 오래 걸리면Ctrl+B로 백그라운드 전환그동안
@파일기반으로 리팩터링 방향을 먼저 정리하거나, 실패 원인 후보를 좁히는 질문을 진행테스트 출력이 쌓이면 필요한 시점에 다시 확인
"테스트가 끝날 때까지 멍하니 대기"하는 시간을 줄이는 게 큐잉의 첫 단계입니다.2
2) 작업 목록(Task list)으로 '진행 중인 일'을 시각화(Ctrl+T)
여러 일이 동시에 돌아가기 시작하면, 사람은 금방 불안해집니다. Claude Code는 Ctrl+T로 작업 목록을 토글할 수 있어, 백그라운드 작업을 포함한 현재 상태를 확인하며 맥락을 유지하는 데 도움이 됩니다.2
3) 본 작업을 방해하지 않는 '옆 질문' /btw
작업이 진행 중일 때 "아까 그 파일 이름이 뭐였지?" 같은 질문을 본 대화에 끼워 넣으면, 대화가 길어지고 방향이 흔들립니다. Claude Code의 /btw는 현재 컨텍스트를 보되, 히스토리에 남기지 않는 일회성 질문을 제공하고, Claude가 응답을 생성하는 중에도 실행할 수 있습니다.2
즉, 본 작업은 그대로 두고 "작은 궁금증"만 짧게 해결하는 큐잉 방식입니다.
입력 편집: 멀티라인, 삭제/붙여넣기, 그리고 '실수 복구'
조작 숙련도는 거창한 기능보다, 자주 하는 편집 동작에서 갈립니다.
멀티라인 입력을 기본으로 만든다(/terminal-setup)
프롬프트가 길어지면 줄바꿈이 필수입니다. Claude Code는 멀티라인 입력을 지원하며, 터미널에 따라 Shift+Enter, Option+Enter 등으로 줄바꿈을 할 수 있습니다.2 설정이 애매하면 /terminal-setup으로 멀티라인 입력 지원을 구성하는 편이 안전합니다.2
멀티라인이 익숙해지면, "한 문장에 다 쑤셔 넣는" 프롬프트가 줄고, 요구사항·제약·검증을 자연스럽게 분리할 수 있습니다.
삭제/되돌리기 대신 '잘라두고 붙이기'(Ctrl+K, Ctrl+U, Ctrl+Y)
입력창에서 자주 하는 동작은 다음입니다.
Ctrl+K: 커서부터 줄 끝까지 삭제(잘라두기)Ctrl+U: 줄 전체 삭제(잘라두기)Ctrl+Y: 방금 삭제한 텍스트 붙여넣기
Claude Code는 이런 편집 키를 지원합니다.2 결과적으로 "문장을 다시 치지 않기"가 가능해집니다.
화면 정리(Ctrl+L)와 작업 취소(Ctrl+C)
Ctrl+L은 터미널 화면만 지웁니다. 대화 히스토리는 남습니다.2Ctrl+C는 현재 입력/생성을 취소합니다.2
둘을 구분하면, "정리하고 싶어서 /clear를 남발"하는 일이 줄어듭니다. 화면이 지저분하면 Ctrl+L, 맥락이 오염됐으면 /clear입니다.
10분 드릴: 오늘부터 바로 빨라지는 연습
아래 연습은 기능을 '알기'가 아니라 '자동으로 나오게' 만드는 목적입니다.
먼저 Claude Code를 저장소 루트에서 켜고, /help를 한 번 눌러 목록을 본 뒤 닫습니다.1 그다음 @README.md를 멘션해서 "설치 단계만 5줄로 요약"을 요청합니다.2
이제 Ctrl+R로 방금 쓴 문장을 찾아 다시 불러오고, 파일만 @package.json(또는 @pyproject.toml)로 바꿔 같은 요청을 실행해 보세요.2 같은 행동을 '재타이핑 없이' 반복하는 감각이 핵심입니다.
마지막으로 !로 테스트 명령을 실행해 보고(프로젝트에 맞게), 오래 걸리면 Ctrl+B로 백그라운드로 보내고 Ctrl+T로 작업 목록을 확인합니다.2 기다리는 동안에는 /btw로 "이 프로젝트 테스트는 어떤 프레임워크를 쓰지?" 같은 옆 질문을 한 번만 던져보면, 큐잉 감각이 바로 잡힙니다.2
참고
1Quickstart - Claude Code Docs
2Interactive mode - Claude Code Docs
이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.