Claude Code의 20가지 필수 명령어

Claude Code를 설치했는데 검은 화면에 깜빡이는 커서만 보이나요? 정상입니다. 버튼과 메뉴가 있는 일반적인 제작 도구와 달리, Claude Code는 직접 입력하는 텍스트 명령어로 작동합니다. 슬래시(/)로 시작하는 이 명령어들을 slash commands라고 부르는데, 파일을 만들고, 코드를 수정하고, 앱을 실행하는 등 많은 작업을 할 수 있습니다. 이 가이드에서는 시작하기 위한 20가지 필수 명령어를 실제 사용 예제와 함께 소개합니다.

파일을 만들기 위한 기본 명령어는 뭐가 있나요?

/create, /edit, /delete 세 가지 명령어로 Claude Code의 모든 파일을 관리할 수 있습니다. 이것들이 일상 작업의 기초입니다.

/create 명령어는 새 파일을 만듭니다. /create index.html이라고 입력하면 Claude Code가 기본 구조를 가진 파일을 생성합니다. 원하는 콘텐츠 유형을 구체적으로 말하면 파일이 그에 맞게 조정됩니다. 예를 들어 /create style.css 레시피 사이트용이라고 입력하면 프로젝트에 맞는 CSS 클래스가 포함된 파일이 생성됩니다.

/edit 명령어는 기존 파일을 수정합니다. 예를 들어 /edit index.html 오른쪽 위에 빨간 버튼 추가라고 입력하면 코드를 직접 건드리지 않고도 HTML 파일이 변경됩니다. Claude Code가 자연스러운 언어를 이해하고 정확한 변경을 적용합니다.

/delete 명령어는 파일을 삭제합니다. /delete old-test.js라고 입력하면 해당 파일이 프로젝트에서 완전히 제거됩니다. 주의할 점은 이 작업은 되돌릴 수 없다는 것입니다.

이 세 가지 명령어만으로도 일상 작업의 80%를 처리할 수 있습니다. 파일을 만들고, 조정하고, 정리하는 것이 전부입니다. 나머지 명령어들은 이 기본 세 가지를 보완합니다.

앱을 실시간으로 보고 테스트하려면 어떻게 하나요?

/preview 명령어는 앱을 브라우저에서 실시간으로 미리 볼 수 있게 해줍니다. 일반 소프트웨어의 "재생" 버튼과 같은 역할입니다.

/preview를 입력하면 Claude Code가 로컬 서버를 시작하고 자동으로 브라우저를 localhost:3000(또는 사용 가능한 다른 포트)으로 엽니다. 그 이후 만드는 모든 변경 사항이 페이지를 수동으로 새로고침하지 않아도 즉시 보입니다.

/stop 명령어는 미리보기 서버를 중지합니다. 리소스를 확보하거나 다른 프로젝트로 전환할 때 유용합니다.

/restart 명령어는 서버를 다시 시작합니다. 새 라이브러리를 설치하거나 설정 파일을 수정한 후에는 변경 사항이 적용되도록 다시 시작해야 할 때가 있습니다.

이 세 명령어가 개발 사이클을 만듭니다. 미리보기를 시작하고, 테스트하고, 조정하고, 필요하면 다시 시작합니다. Anthropic의 연구에 따르면 Claude Code를 사용하는 개발자들은 이런 매끄러운 통합 덕분에 에디터와 브라우저 사이를 오가는 데 40% 적은 시간을 씁니다.

코드를 빠르게 탐색하는 명령어는 뭐가 있나요?

/find, /goto, /search 명령어로 수십 개의 파일이 있어도 빠르게 이동할 수 있습니다.

/find 파일이름 명령어는 특정 파일을 찾아 엽니다. 예를 들어 /find header.js라고 입력하면 헤더 코드가 있는 파일로 바로 이동합니다. 폴더 구조를 일일이 뒤질 필요가 없습니다.

/goto 42줄 명령어는 현재 열린 파일의 특정 줄로 이동합니다. Claude Code가 127줄에 오류가 있다고 알려줄 때 /goto 127이라고 입력하면 바로 그 위치로 갑니다.

/search 키워드 명령어는 프로젝트의 모든 파일에서 특정 단어를 찾습니다. calculateTotal 함수를 어디에 사용했는지 찾으려면 /search calculateTotal이라고 입력하면 Claude Code가 모든 위치를 맥락과 함께 보여줍니다.

프로젝트가 5~6개 파일을 넘어가면 이런 탐색 명령어들이 필수가 됩니다. 수동으로 스크롤하는 대신 필요한 곳으로 바로 이동할 수 있습니다.

외부 라이브러리를 설치하고 관리하려면 어떻게 하나요?

/install 명령어는 React, Vue 같은 외부 라이브러리나 CSS 유틸리티를 프로젝트에 추가합니다. 코드용 앱 스토어 같은 것입니다.

/install react라고 입력하면 Claude Code가 React 라이브러리를 다운로드하고 프로젝트를 자동으로 설정합니다. npm, yarn, package.json 파일을 이해할 필요가 없습니다. 어시스턴트가 기술적인 부분을 모두 처리합니다.

/uninstall 명령어는 라이브러리를 제거합니다. /uninstall jquery라고 입력하면 jQuery가 프로젝트에서 삭제되고 설정 파일의 참조도 정리됩니다.

/list-packages 명령어는 프로젝트에 설치된 모든 라이브러리를 보여줍니다. 실제로 사용하는 것이 뭔지 확인할 때 유용합니다.

Anthropic의 사용 데이터에 따르면 초보자의 73%가 Claude Code를 처음 사용한 지 10분 안에 /install을 사용합니다. 복잡한 라이브러리를 한 문장으로 설치할 수 있다는 것을 깨닫는 순간, 이 도구의 강력함을 느끼는 첫 번째 "마법 같은" 명령어입니다.

버그를 찾고 오류를 수정하는 명령어는 뭐가 있나요?

/debug, /fix, /explain 명령어는 복잡한 오류 메시지를 실제 해결책으로 바꿔줍니다.

/debug 명령어는 코드에서 잠재적 오류를 찾습니다. Claude Code가 논리, 데이터 타입, 누락된 참조를 검토하고 앱을 테스트하기 전에 문제를 알려줍니다.

/fix 표시된오류 명령어는 오류를 자동으로 수정합니다. 브라우저에 "Uncaught ReferenceError: calculateTotal is not defined" 메시지가 나타나면 이 메시지를 복사해서 /fix Uncaught ReferenceError: calculateTotal is not defined라고 입력합니다. Claude Code가 문제(함수 이름 오류, import 누락)를 파악하고 수정을 적용합니다.

/explain 이코드 명령어는 코드 조각을 간단한 말로 설명합니다. Claude Code가 만든 함수를 이해하지 못하면 코드를 선택하고 /explain이라고 입력합니다. 어시스턴트가 줄 단위로 무슨 일이 일어나는지 설명해줍니다.

이런 디버깅 명령어들은 버그를 찾는 데 걸리는 시간을 크게 줄여줍니다. Stack Overflow에서 30분을 보내는 대신 몇 초 안에 상황에 맞는 해결책을 얻습니다.

프로젝트를 정리하고 문서화하려면 어떻게 하나요?

/comment, /doc, /structure 명령어로 코드를 깔끔하고 이해하기 쉽게 유지할 수 있습니다.

/comment 이파일 명령어는 코드에 설명 주석을 자동으로 추가합니다. Claude Code가 각 섹션이 뭘 하는지 설명하는 주석을 넣어주는데, 읽기를 방해하지 않습니다.

/doc readme생성 명령어는 프로젝트를 설명하는 README.md 파일을 만듭니다. 목표, 주요 파일, 앱 실행 방법 등이 포함됩니다. 코드를 공유하거나 몇 주 후에 다시 돌아올 때 필수입니다.

/structure 명령어는 프로젝트 전체 구조를 시각적으로 보여줍니다. 폴더와 파일 구성을 한눈에 볼 수 있습니다.

/rename 이전이름 새이름 명령어는 파일 이름을 바꾸고 참조되는 모든 곳을 업데이트합니다. utils.js를 helpers.js로 바꾸면 Claude Code가 모든 import를 자동으로 수정합니다.

이런 정리 명령어들은 처음엔 부차적으로 보이지만, 프로젝트에 다시 돌아올 때 중요해집니다. 잘 정리된 코드는 5분 안에 다시 시작할 수 있지만, 정리되지 않은 코드는 1시간이 걸릴 수 있습니다.

기존 코드를 최적화하고 개선하려면 어떻게 하나요?

/optimize, /refactor, /test 명령어는 코드를 완전히 다시 쓰지 않고도 품질을 높입니다.

/optimize 명령어는 코드를 분석해서 더 빠르고 가볍게 만듭니다. Claude Code가 비효율적인 반복문, 불필요한 로딩, 중복을 찾아내고 최적화된 버전을 제안합니다. 예를 들어 5MB의 큰 이미지를 로드하면 /optimize가 압축이나 지연 로딩을 제안할 수 있습니다.

/refactor 이파일 명령어는 코드를 재구성해서 더 읽기 쉽고 유지보수하기 좋게 만듭니다. 동작은 바뀌지 않습니다. 200줄에 8단계 들여쓰기가 있는 함수가 있으면 /refactor가 작고 명확한 함수들로 나눠줍니다.

/test 명령어는 코드를 확인하는 자동 테스트를 만듭니다. Claude Code가 앱 사용을 시뮬레이션하는 테스트 시나리오를 만들고 문제를 찾아냅니다.

이런 지속적 개선 명령어들은 작동하는 프로토타입을 전문적인 앱으로 변환합니다. 또한 개발의 좋은 관행을 배우게 됩니다. Claude Code가 어떻게 최적화하는지 보면서 이런 사고방식을 점진적으로 익힙니다.

결론

이 20가지 명령어는 Claude Code로 매일 할 일의 핵심을 다룹니다. 첫날부터 모두 외울 필요는 없습니다. /create, /edit, /preview부터 시작해서 필요에 따라 점진적으로 다른 명령어들을 추가하세요. Claude Code의 장점은 정확한 명령어를 잊어도 자연스러운 한국어로 물어볼 수 있다는 것입니다. "어떻게 하면..."이라고 물어보면 어시스턴트가 안내해줍니다. 더 자세히 배우려면 초보자를 위한 완전 튜토리얼을 확인해서 첫 앱을 단계별로 만드는 방법을 알아보세요.