Files

김보곤 553e1e387a docs: [claude-code] /btw 사이드 질문 기능 가이드 추가

- v2.1.72에서 도입된 /btw 기능 상세 설명
- 사용법, 특징, 서브에이전트 비교, 베스트 프랙티스
- INDEX.md에 문서 등록

2026-03-14 08:13:12 +09:00

4.0 KiB

Raw Blame History

Claude Code /btw (Side Question) 기능 가이드

작성일: 2026-03-14 상태: 확정 도입 버전: Claude Code v2.1.72 (2026-03-10)

1. 개요

1.1 목적

/btw (By The Way)는 Claude Code에서 작업 중단 없이 빠른 질문을 할 수 있는 사이드 질문 기능이다. 대화 이력에 추가되지 않으며, 현재 세션의 컨텍스트를 기반으로 즉답을 제공한다.

1.2 핵심 원칙

대화 이력을 오염시키지 않는 임시 질문
Claude가 작업 중일 때도 사용 가능
도구(파일 읽기, 명령 실행 등)에 접근하지 않고 이미 알고 있는 정보만 활용
프롬프트 캐시를 재사용하여 토큰 비용 최소화

2. 사용법

2.1 기본 문법

/btw 질문 내용

2.2 사용 예시

/btw 아까 수정한 설정 파일 이름이 뭐였지?
/btw 우리 DB 커넥션 이름이 뭐야?
/btw 방금 만든 API 엔드포인트 경로가 뭐지?
/btw tenant_id 컬럼 타입이 뭐였지?
/btw 아까 논의한 마이그레이션 순서 알려줘

2.3 답변 닫기

답변은 오버레이 형태로 표시되며, 아래 키로 닫을 수 있다:

키	동작
`Space`	닫기
`Enter`	닫기
`Escape`	닫기

3. 특징

3.1 작업 중에도 사용 가능

Claude가 코드를 작성하거나 파일을 읽는 중에도 /btw를 실행할 수 있다. 메인 작업을 중단하지 않는다.

3.2 전체 컨텍스트 접근

사이드 질문은 현재 대화의 전체 컨텍스트를 볼 수 있다:

Claude가 이미 읽은 코드
이전 대화에서 논의한 아키텍처 결정
세션 중 수행한 모든 작업 내역

3.3 도구 접근 불가

❌ 파일 읽기/쓰기
❌ 명령어 실행 (bash, git 등)
❌ 웹 검색
❌ 새로운 정보 탐색

오직 현재 컨텍스트에 있는 정보만 사용하여 답변한다.

3.4 단발성 응답

후속 대화(follow-up)가 불가능하다. 추가 질문이 필요하면 일반 프롬프트를 사용한다.

3.5 비용 효율성

부모 대화의 프롬프트 캐시를 재사용
대화 이력에 추가되지 않아 이후 토큰 소비 없음
동일 정보를 일반 프롬프트로 물어보는 것 대비 비용 절감

4. /btw vs 서브에이전트 비교

항목	`/btw`	서브에이전트 (Agent)
컨텍스트	전체 대화 내용 접근 가능	빈 컨텍스트에서 시작
도구 접근	불가	전체 도구 사용 가능
용도	이미 아는 정보 조회	새로운 정보 탐색
작업 중단	없음	병렬 실행 가능
대화 이력	추가되지 않음	결과가 이력에 포함
비용	최소 (캐시 재사용)	별도 토큰 소비

4.1 판단 기준

"Claude가 이미 알고 있는 정보인가?"
  → Yes → /btw 사용
  → No  → 일반 프롬프트 또는 서브에이전트 사용

5. 사용 요건

항목	요건
환경	Claude Code CLI (터미널) 전용
버전	v2.1.72 이상
계정	Pro, Max, Teams, Enterprise, Console

6. 베스트 프랙티스

6.1 적합한 사용 사례

✅ 파일명, 경로, 변수명 등 참조 정보 확인
✅ 이전 논의에서 결정한 사항 재확인
✅ 현재 작업 컨텍스트에 대한 빠른 질문
✅ 코드 구조나 아키텍처 결정 사항 확인

6.2 부적합한 사용 사례

❌ 새 파일을 읽어야 하는 질문
❌ 명령어 실행이 필요한 작업
❌ 웹 검색이 필요한 조사
❌ 후속 대화가 필요한 복잡한 논의

4.0 KiB Raw Blame History