Claude Code 가이드 #21 — Claude Code로 작업 중 궁금한 게 생겼을 때, 대화 히스토리를 오염시키지 않고 질문할 수 있는 방법이 있습니다. /btw (By The Way) 명령어는 현재 컨텍스트를 그대로 보면서 임시 질문을 던지는 사이드 채널입니다. /btw (“By The Way”)는 Claude Code v2.1.72(2026년 3월 10일)에서 도입된 사이드 체인 대화 기능입니다.
Claude Code 가이드 #21 — Claude Code로 작업 중 궁금한 게 생겼을 때, 대화 히스토리를 오염시키지 않고 질문할 수 있는 방법이 있습니다. /btw(By The Way) 명령어는 현재 컨텍스트를 그대로 보면서 임시 질문을 던지는 사이드 채널입니다. 프롬프트 캐시를 재사용해 비용도 절감됩니다. 이 편에서는 /btw의 동작 원리, 실전 활용법, 그리고 함께 추가된 최신 기능까지 정리합니다.
/btw(“By The Way”)는 Claude Code v2.1.72(2026년 3월 10일)에서 도입된 사이드 체인 대화 기능입니다. 메인 작업이 진행 중이더라도 임시 질문을 던져 즉시 답을 받을 수 있습니다.
핵심 특징:
임시(Ephemeral) — 답변 확인 후 닫으면 사라짐. 대화 히스토리에 남지 않음
읽기 전용(Read-only) — 현재 세션의 모든 컨텍스트를 볼 수 있지만, 파일 수정이나 명령 실행은 불가
비용 절감 — 부모 대화의 프롬프트 캐시를 재사용해 추가 토큰 소모 최소화
비중단(Non-interrupting) — 메인 작업이 돌아가는 중에도 병렬 실행 가능
Claude Code 가이드 #21 — /btw 실행 시 오버레이 창으로 답변이 표시되며, 닫으면 사라진다 (출처: 공식 문서 기반)
/btw는 어떻게 동작하나?
/btw의 동작 방식을 단계별로 정리하면:
/btw 질문 내용을 입력합니다 (작업 중에도 가능)
Claude Code가 현재 세션의 전체 컨텍스트를 읽기 전용으로 참조하는 임시 에이전트를 생성합니다
답변이 닫을 수 있는 오버레이 창에 표시됩니다
오버레이를 닫으면 질문과 답변 모두 삭제됩니다
이 과정에서 핵심은 프롬프트 캐시 재사용입니다. 일반 대화에서 질문을 하면 전체 컨텍스트를 다시 처리해야 하지만, /btw는 이미 캐시된 컨텍스트를 그대로 사용합니다.
/btw 사용 예시
# 작업 중 간단한 질문
/btw 이 함수에서 에러 처리를 이렇게 한 이유가 뭐야?
# 아키텍처 판단 확인
/btw 이 접근방식의 트레이드오프가 뭐야?
# 이전 내용 확인
/btw 아까 그 에러 메시지가 정확히 뭐였지?
⚠️ 막히는 케이스:/btw로 질문했는데 “해당 파일을 읽지 못했습니다”라고 답하는 경우 — /btw는 현재 세션에서 이미 읽은 정보만 참조할 수 있습니다. Claude Code가 아직 읽지 않은 파일에 대해서는 답할 수 없습니다. 해당 파일을 먼저 읽도록 요청한 후 /btw를 사용하세요.
🎓 유데미 강의 추천
Claude Code 실전 강의 — AI 코딩을 지금 시작하세요
설치부터 자동화·에이전트 활용까지, 실무에서 바로 쓰는 Claude Code 활용법을 단계별로 배울 수 있습니다.
Claude Code 가이드 #21 — v2.1.72~v2.1.86 주요 변경사항 타임라인 (출처: <a href="https://code.claude.com/docs/en/changelog" target="_blank">공식 Changelog</a>)
⚠️ 막히는 케이스: Computer Use를 쓰려고 하는데 작동하지 않는 경우 — Computer Use는 Pro/Max 플랜의 Cowork 모드에서만 사용 가능합니다. CLI 단독 실행에서는 지원되지 않습니다. Cowork 모드는 claude cowork으로 시작합니다.
⚠️ 막히는 케이스: /loop이 예상대로 동작하지 않는 경우 — /loop 명령어는 기본 10분 간격입니다. 간격을 변경하려면 /loop 5m /your-command 형식으로 시간을 명시하세요. 세션을 닫으면 loop도 종료됩니다.
요약 및 관련 편
정리하면:
/btw는 대화 히스토리를 오염시키지 않는 임시 질문 기능입니다
현재 세션 컨텍스트를 읽기 전용으로 참조하며, 도구 사용은 불가능합니다
프롬프트 캐시를 재사용해 비용을 크게 절감할 수 있습니다
서브에이전트와는 용도가 다릅니다 — 이미 있는 정보 확인은 /btw, 새 조사는 서브에이전트
2026년 3월 기준 Computer Use, /loop, MCP Elicitation 등 다수 신규 기능이 함께 추가됐습니다
먼저 본인의 Claude Code 버전부터 확인하셔야 합니다. /btw는 v2.1.72 이상에서만 동작하므로 터미널에서 claude --version 을 먼저 찍어 보시고, 그보다 낮으면 npm install -g 으로 업데이트하셔야 합니다. 버전이 맞으면 그다음은 사용 습관입니다. /btw는 지금 세션이 이미 읽은 파일과 대화 맥락만 참조하기 때문에, 아직 열어보지 않은 파일에 대해 물으면 답하지 못합니다. 그래서 도입 초기에는 작업이 어느 정도 진행돼 컨텍스트가 쌓인 뒤에 '이건 왜 이렇게 했어?' 같은 확인용 질문부터 써 보시는 것을 권합니다.
가장 자주 발생하는 실수나 함정은 무엇인가요?
가장 흔한 실수는 /btw를 일반 대화처럼 쓰려는 것입니다. /btw는 단일 질문과 단일 답변만 지원해서, 답을 받고 곧바로 후속 질문을 이어가려 하면 막힙니다. 멀티턴 논의가 필요하면 메인 대화로 돌아가거나 /fork로 별도 브랜치를 만드셔야 합니다. 두 번째 함정은 답변을 저장할 수 있다고 착각하는 것입니다. 오버레이 창을 닫으면 질문과 답이 완전히 사라지고 내보내기 기능이 없으므로, 중요한 답이면 닫기 전에 직접 복사해 두셔야 합니다. 세 번째는 아직 세션이 읽지 않은 파일에 대해 묻고 '파일을 읽지 못했습니다'라는 답을 받는 경우입니다.
/btw와 서브에이전트, 어떤 상황에 무엇이 적합한가요?
판단 기준은 단순합니다. 답에 필요한 정보가 이미 지금 세션에 있느냐입니다. 이건 왜 이렇게 했어, 아까 그 에러가 뭐였지, 이 함수가 뭘 하는 거야처럼 이미 읽은 코드와 대화 맥락만으로 답할 수 있으면 /btw가 적합합니다. 히스토리를 오염시키지 않고 캐시를 재사용해 비용도 거의 안 들죠. 대규모 리팩토링이나 긴 디버깅처럼 컨텍스트가 빠르게 커지는 세션일수록 효과가 큽니다. 반대로 아직 안 읽은 파일을 새로 읽거나, 명령을 실행하거나, 결과를 부모 대화에 남겨야 하면 /btw로는 안 되고 서브에이전트를 써야 합니다. /btw는 단일 질문·답변만 되므로 여러 번 이어지는 논의가 필요하면 메인 대화로 돌아가거나 /fork로 별도 브랜치를 만드는 편이 맞습니다.
더 깊게 공부하려면 어떤 자료를 보면 좋을까요?
/btw는 인터랙티브 모드 기능이라 공식 Interactive Mode 문서와 Changelog(code.claude.com/docs/en/changelog)를 보는 게 정확합니다. v2.1.72 도입 이후 /loop, Computer Use, MCP Elicitation 같은 후속 기능이 어느 버전에 들어왔는지 여기서 확인하세요. 비용 절감 원리를 제대로 이해하려면 프롬프트 캐싱(prompt caching)이 핵심 키워드입니다. 캐시된 컨텍스트를 재처리 없이 재사용한다는 개념을 잡으면 /btw가 왜 싼지 보입니다. 이어서 /fork, /rewind, /compact를 묶어 다루는 가이드 #18(컨텍스트 & 토큰 최적화)을 보면 컨텍스트 위생 전반을 설계할 수 있습니다.
Claude Code 가이드 #21, 한 줄로 정리하면 어떻게 되나요?
/btw는 메인 작업과 대화 히스토리를 건드리지 않고 임시 질문을 던지는 사이드 채널입니다. 현재 세션 컨텍스트를 읽기 전용으로만 참조하고, 답변은 닫으면 사라지는 오버레이에 뜨며, 프롬프트 캐시를 재사용해 추가 비용을 거의 안 들입니다. 새 파일을 읽거나 명령을 실행해야 하면 /btw 대신 서브에이전트를 써야 하고, 멀티턴 논의가 필요하면 메인 대화나 /fork로 가야 한다는 한계만 기억하면 됩니다.