151 lines
4.0 KiB
Markdown
151 lines
4.0 KiB
Markdown
# 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 부적합한 사용 사례
|
|
|
|
```
|
|
❌ 새 파일을 읽어야 하는 질문
|
|
❌ 명령어 실행이 필요한 작업
|
|
❌ 웹 검색이 필요한 조사
|
|
❌ 후속 대화가 필요한 복잡한 논의
|
|
```
|
|
|
|
---
|
|
|
|
## 관련 문서
|
|
|
|
- [Claude Code → 슬랙 붙여넣기 가이드](claude-code-to-slack.md)
|
|
- [개발 명령어 모음](../quickstart/dev-commands.md)
|
|
|
|
---
|
|
|
|
**최종 업데이트**: 2026-03-14
|