본문 바로가기

Code 탭에서 자주 쓰는 명령어

이제 Claude와 대화하는 기본적인 방법을 익히셨으니, 더 효율적으로 작업할 수 있는 명령어들을 알아보겠습니다. Code 탭에는 입력창에 슬래시(/)를 치면 나타나는 특별한 명령어들이 있습니다. 외워야 하는 것은 아니고, 알아두면 작업이 한결 편해지는 단축 도구라고 생각하시면 됩니다. 입력창에 /만 입력하면 쓸 수 있는 명령어 목록이 뜨니, 그중 자주 쓰게 되는 것들만 추려 살펴보겠습니다. 모든 명령어는 아래 공식 문서를 참고해주세요.

1. 꼭 알아야 할 명령어

명령어하는 일쓰는 때
/clear대화 기록 초기화새 주제로 넘어갈 때
/compact대화 압축대화가 길어졌을 때
/rewind이전 상태로 되돌리기작업을 무르고 싶을 때
/model모델과 노력 정도 선택속도와 꼼꼼함을 조절할 때
/context지금 이 대화가 쓰고 있는 양 보기대화가 무거워졌다고 느낄 때
/usage플랜 한도 사용량 보기남은 한도를 확인하고 싶을 때
/init프로젝트 안내 파일 만들기같은 폴더를 계속 다룰 때

1.1 /clear

Claude와 대화하다 보면 내용이 너무 길어져서 정리하고 싶을 때가 있습니다. 또는 답변의 퀄리티가 마음에 안 들 때가 있습니다. 주고받은 내용이 많아질수록 Claude가 참고해야 할 정보가 늘어나고, 답변의 정확도가 떨어집니다. 새로운 주제로 넘어가서 이전 대화를 더 이어갈 필요가 없을 때 /clear로 대화 기록을 비우면 됩니다.

아래 논문은 대화에 쌓인 토큰이 많아질수록 성능이 어떻게 떨어지는지 보여줍니다. 너무 많은 토큰을 사용하면 모델이 느려지거나 응답이 부정확해질 수 있습니다. 이럴 때 /clear 명령어를 사용하여 대화 기록을 초기화하면 성능을 회복할 수 있습니다.

컨텍스트가 길어질수록 모델의 정확도가 떨어지는 것을 보여주는 NoLiMa 벤치마크 결과입니다.

걱정하지 마세요. 폴더의 파일들은 그대로 유지되고 단지 대화 기록만 지워집니다. 3장 3절에서 '간단한 수정이 아니면 새 대화에서 다시 시킨다'고 했는데, 그 새 대화가 /clear입니다.

1.2 /compact

대화가 길어졌지만 지금까지의 맥락은 이어가고 싶을 때 /compact로 대화를 압축할 수 있습니다. 그동안 나눈 내용을 요약해 짧게 정리하면서 핵심 맥락은 남기기 때문에, 토큰을 아끼면서 작업을 계속 이어갈 수 있습니다. 특히 다음 날 대화로 넘어가기 전에 한 번씩 요약하면 좋습니다.

1.3 /rewind

작업을 하다 보면 "방금 그 변경은 안 했으면 좋았을 텐데" 싶을 때가 있습니다. /rewind는 작업 도중 저장된 중간 지점인 체크포인트를 골라 코드나 대화를 이전 상태로 되돌려줍니다. 명령어를 실행하면 되돌릴 지점을 고르는 목록이 나오고, 코드만, 대화만, 아니면 둘 다 되돌릴지 선택할 수 있습니다.

마음 편히 이것저것 시도해보고 아니면 되돌리면 되니, 작업이 한결 과감해집니다. 이 책이 '일단 만들어 보자'고 말할 수 있는 이유 중 하나가 이 명령어입니다. 3장 4절에서 설치한 git이 이 기능을 뒷받침합니다.

1.4 /model

Claude에는 여러 버전의 모델이 있습니다. 응답 속도가 중요할 때와 꼼꼼한 작업이 필요할 때에 맞춰 /model로 모델을 바꿀 수 있습니다. 작업을 시작하기 전에 지금 어떤 모델을 쓰고 있는지 한 번 확인하는 습관을 들이면 좋습니다. 모델이 새로 나와도 자동으로 바뀌지 않는 경우가 있기 때문입니다.

모델과 함께 정하는 값이 앞 절에서 본 노력입니다. 한도가 빠듯한 날에는 내려두고, 오늘 꼭 끝내야 하는 작업 하나에 몰아 쓰고 싶을 때 올리는 식으로 쓰면 됩니다.

1.5 /context

지금 이 대화가 Claude의 작업 공간을 얼마나 차지하고 있는지 보여줍니다. 한 대화에서 Claude가 한 번에 들고 있을 수 있는 양에는 정해진 한도가 있는데, /context는 그 한도 안에서 무엇이 자리를 얼마나 쓰고 있는지 항목별로 나눠 보여줍니다. 읽어들인 파일, 그동안 주고받은 대화, 도구 설명처럼 종류별로 구분되어 나옵니다.

/context를 실행하면 대화가 쓰고 있는 토큰이 항목별로 표시됩니다.

남은 공간이 얼마 없다면 /compact로 압축하거나, 주제가 바뀌었다면 /clear로 새로 시작할 때가 된 것입니다. 작업이 유난히 느려지거나 Claude가 앞에서 한 이야기를 놓치기 시작할 때 한 번 확인해보면 좋습니다.

1.6 /usage

구독 플랜의 한도를 얼마나 썼는지 보여줍니다. /context가 지금 이 대화 하나를 들여다보는 것이라면, /usage는 내 계정 전체를 봅니다. 대화를 새로 시작하거나 /clear로 기록을 비워도 이 숫자는 초기화되지 않고, 정해진 기간이 지나야 다시 채워집니다.

/usage를 실행하면 플랜 한도 대비 사용량과 다시 채워지는 시간이 표시됩니다.

둘을 헷갈리기 쉬운데, /context가 꽉 찼다는 것은 이 대화가 길어졌다는 뜻이라 새 대화를 열면 해결되고, /usage가 꽉 찼다는 것은 오늘 작업을 여기까지 하라는 뜻이라 기다려야 합니다. 무거운 작업을 앞두고 있다면 시작하기 전에 한 번 확인해두면 중간에 멈추는 일을 피할 수 있습니다.

2. @로 파일 지목하기

Code 탭에서 특정 파일을 콕 집어 작업하게 하고 싶을 때는 입력창에 @를 입력합니다. 그러면 작업 폴더 안의 파일 목록이 떠서, 원하는 파일을 골라 문장에 넣을 수 있습니다.

@index.html 의 신청 버튼 색을 초록색에서 파란색으로 바꿔줘.

폴더에 파일이 많을 때, 어떤 파일을 다뤄야 하는지 정확히 알려주면 Claude가 엉뚱한 파일을 건드리지 않고 지목한 파일로 작업합니다. 6장에서 디자인 시스템 파일을, 10장에서 명세 파일을 이 방법으로 지목합니다.

3. /init과 CLAUDE.md

같은 작업 폴더에서 며칠에 걸쳐 작업을 이어간다면 /init 명령어가 도움이 됩니다. 폴더를 살펴보고 프로젝트의 목적과 구조를 정리한 안내 파일 CLAUDE.md를 만들어두는 명령어로, 이후 작업할 때 Claude가 이 파일을 참고해서 맥락을 더 빨리 잡습니다.

폴더를 만들자마자 사용하면 폴더에 파일이 전혀 없기 때문에 이 파일을 제대로 생성하지 못합니다. 첫 결과물이 나온 뒤에 만드시는 것을 권합니다. 한 번 쓰고 마는 작업이라면 굳이 만들지 않아도 괜찮습니다.

아래 파일은 앞 절의 랜딩 페이지 폴더에서 /init을 하고 나서 생성된 파일입니다. 이제 Claude가 이 폴더에서 작업할 때 이 파일을 참고하여 작업을 하게 됩니다.

# CLAUDE.md

이 파일은 이 저장소에서 작업할 때 Claude Code에 대한 가이드를 제공합니다.

## 프로젝트 개요

"바이브 코딩" - 프로그래밍 교육 플랫폼을 위한 한국어 교육 웹사이트입니다. 바닐라 HTML, CSS, JavaScript로 구축된 단일 페이지 애플리케이션입니다.

## 프로젝트 구조

- `index.html` - 홈, 소개, 커리큘럼, 강사, 수강신청 섹션을 포함하는 메인 HTML 파일
- `styles.css` - 반응형 디자인, 애니메이션, 그라데이션 테마를 포함한 전체 스타일링
- `script.js` - 부드러운 스크롤, 모바일 네비게이션 등의 상호작용을 위한 JavaScript

## 주요 기능

- **모바일 반응형 네비게이션** - 햄버거 메뉴 포함
- **부드러운 스크롤 네비게이션** - 섹션 간 이동 및 활성 상태 표시
- **폼 추적** - Google Forms 수강신청 링크 추적

## 개발 명령어

정적 웹사이트로 빌드 프로세스가 없음:
- 브라우저에서 `index.html`을 직접 열어 사이트 확인

## 외부 의존성

- 수강신청용 Google Forms 연동 (https://forms.gle/Ddj742DqPZ5Eb8j79)
- 외부 JavaScript 라이브러리나 프레임워크 사용 안 함

## 스타일링 접근 방식

- 일관된 테마를 위한 CSS 커스텀 속성 (CSS 변수) 사용
- 보라색/바이올렛 계열의 그라데이션 기반 색상 구성
- 768px 브레이크포인트의 모바일 우선 반응형 디자인

이 파일은 여러분이 직접 고칠 수도 있습니다. 메모장으로 열어 "강사 이름은 항상 이호준으로", "가격은 절대 지어내지 말 것"처럼 Claude가 지켜야 할 규칙을 한 줄씩 추가하면 됩니다. 4장에서 다룰 하네스의 가장 작은 형태가 이 파일입니다. 다만 실제로는 Claude가 이 파일의 지침을 무시하거나 어기는 경우도 있습니다. 여기에 반드시 지켜야 될 사항을 명시했다고 하더라도 이에 반하는 작업을 하기도 하니, 검토는 여전히 여러분의 몫입니다.

4. 터미널에서만 쓰는 명령어

Claude Desktop을 쓰는데 터미널 명령어를 왜 알아야 하는지 의아할 수 있습니다. 인터넷의 사용법 글이나 영상, 공식 문서는 아직 대부분 터미널을 기준으로 쓰여 있습니다. 앞으로 Claude Code를 더 알아보려고 검색하면 십중팔구 터미널 화면이 나오는 자료를 만나게 되고, 거기서 소개하는 명령어를 Code 탭에 그대로 입력해보게 됩니다. 터미널에서만 동작하는 명령어이지만 Code 탭에도 같은 일을 하는 버튼이나 메뉴가 마련되어 있으니, 표 오른쪽 열에서 어느 것과 짝이 되는지 함께 확인해보세요.

명령어하는 일Code 탭에서는
/help명령어 목록 보기입력창에 /만 입력하면 목록이 열립니다
/resume지난 대화 이어가기지난 세션 목록에서 골라 엽니다
/doctor설치 상태 점검앱이 설치를 관리합니다
/memoryCLAUDE.md 수정메모장으로 파일을 직접 엽니다

명령어를 다 외울 필요는 없습니다. /clear로 새로 시작하고, /compact로 대화를 압축하고, /rewind로 되돌리고, @로 파일을 지목하는 것, 이 네 가지만 손에 익혀도 Code 탭이 훨씬 편해집니다. 나머지는 필요해지는 순간이 오면 그때 이 표로 돌아오시면 됩니다.