클로드 코드를 설치하고 나면 다음이 더 막막합니다.
“이제 뭘 치면 되지?”
claude는 쳤는데, -p·-c·-r 같은 옵션은 뭐가 다른지 모르겠고, /init으로 CLAUDE.md는 만들었는데 그 안에 뭘 더 적어야 할지도 감이 안 옵니다. 어디선가 --dangerously-skip-permissions라는 무서운 이름의 옵션도 본 것 같은데, 이건 써도 되는 건지 알 수가 없습니다.
이 글은 설치 다음 단계, 그러니까 클로드 코드를 매일 쓰는 사람이 실제로 쓰는 명령어와 습관만 정리합니다. 설치가 아직이라면 클로드 코드 맥 설치 방법부터 보고 오면 됩니다.
지금 확인할 것
- 셸 명령 5개(
claude,-p,-c,-r등) 중 지금 나에게 필요한 건 딱 2개뿐 - CLAUDE.md는
/init으로 끝이 아니라, 같은 말을 두 번 하게 될 때마다 추가하는 파일 --dangerously-skip-permissions는 이름 그대로 위험 — 언제 써도 되고 언제 피해야 하는지
클로드 코드, 일단 실행하고 질문부터 합니다
작업할 폴더에서 터미널을 열고 claude를 입력하면 시작됩니다.
여기서 바로 코드를 고쳐달라고 하기 전에, 먼저 물어보는 게 순서입니다.
이 프로젝트는 무엇을 하나요?
이 프로젝트는 어떤 기술을 사용하나요?
주요 진입점은 어디인가요?클로드 코드는 필요한 파일을 알아서 읽습니다. 컨텍스트를 미리 붙여넣을 필요가 없습니다. 질문으로 시작해서 클로드가 프로젝트를 어떻게 이해하고 있는지 먼저 확인하고, 그다음에 수정을 요청하는 순서가 안전합니다.
-p, -c, -r — 셸 명령어 뭐가 다른가요
공식 문서 기준으로 자주 쓰는 셸 명령은 5개입니다. 다만 처음엔 이 중 2개만 알아도 됩니다.
| 명령 | 하는 일 | 언제 쓰나 |
|---|---|---|
claude |
대화형 세션 시작 | 거의 항상 — 기본값 |
claude "작업" |
일회성 작업 실행 | 대화 없이 바로 시킬 때 |
claude -p "질문" |
답만 출력하고 종료 | 스크립트·자동화에서 호출할 때 |
claude -c |
이 폴더의 가장 최근 대화 이어가기 | 터미널을 껐다 켰는데 아까 하던 대화를 계속하고 싶을 때 |
claude -r |
과거 세션 중 하나를 골라서 재개 | 며칠 전 특정 대화로 돌아가고 싶을 때 |
비개발자 기준으로는 -c와 -r의 차이만 기억하면 됩니다. -c는 “바로 직전 거 이어서”, -r는 “예전 것 중에 골라서”입니다. -p는 사람이 대화하려고 쓰는 옵션이 아니라, 다른 프로그램이 클로드를 호출할 때 쓰는 옵션이라 처음엔 몰라도 됩니다.
CLAUDE.md, /init 이후에 뭘 더 적어야 하나요
CLAUDE.md는 공식 문서에서 이렇게 정의합니다.
“CLAUDE.md를 다시 설명해야 할 내용을 적어두는 장소로 취급합니다.”
/init을 실행하면 클로드가 프로젝트를 분석해서 빌드 명령, 폴더 구조 같은 걸 자동으로 채워 넣습니다. 문제는 여기서 끝이라고 생각하는 겁니다. 진짜 CLAUDE.md는 그 이후에 완성됩니다.
공식 문서가 제시하는 추가 기준은 네 가지입니다.
- 클로드가 같은 실수를 두 번째로 할 때
- 코드 리뷰에서 이 프로젝트에 대해 알아야 할 걸 발견했을 때
- 지난 세션에도 똑같은 걸 채팅으로 설명했을 때
- 새 팀원이 같은 맥락을 알아야 생산성이 오를 때
즉 같은 말을 두 번 하는 순간이 CLAUDE.md에 한 줄 추가할 타이밍입니다. 문장도 구체적일수록 좋습니다.
| 애매한 지침 | 구체적인 지침 |
|---|---|
| 코드를 제대로 포맷합니다 | 2칸 들여쓰기 사용 |
| 변경 사항을 테스트합니다 | 커밋하기 전에 npm test 실행 |
| 파일을 정리된 상태로 유지합니다 | API 핸들러는 src/api/handlers/에 있습니다 |
공식 권장 분량은 200줄 이하입니다. 파일이 길어지면 클로드가 오히려 덜 따릅니다.
자동 메모리 — 클로드가 스스로 적어두는 노트
CLAUDE.md 말고 최근에 추가된 기능이 하나 더 있습니다. 자동 메모리입니다. CLAUDE.md는 사람이 쓰는 규칙이고, 자동 메모리는 클로드가 작업하면서 스스로 저장하는 노트입니다.
| CLAUDE.md | 자동 메모리 | |
|---|---|---|
| 작성자 | 사람 | 클로드 |
| 내용 | 지침·규칙 | 빌드 명령, 디버깅 인사이트 같은 학습·패턴 |
| 확인 방법 | /memory |
/memory |
기본값은 켜져 있고, 클로드가 알아서 판단해서 저장합니다. “항상 npm이 아니라 pnpm을 씁니다” 처럼 대화 중에 알려주면 클로드가 이걸 CLAUDE.md가 아니라 자동 메모리에 저장하는 식입니다. /memory를 열면 지금까지 뭘 저장했는지 그대로 확인·수정할 수 있습니다.
–dangerously-skip-permissions, 써도 될까요
클로드 코드는 원래 파일을 수정하기 전에 매번 승인을 요청합니다. --dangerously-skip-permissions는 이 승인 절차를 통째로 건너뛰는 옵션입니다.
이름 그대로 위험을 감수하겠다는 뜻입니다. 승인 없이 파일을 수정·삭제하고 명령어를 실행할 수 있게 되므로, 의도하지 않은 변경이나 삭제가 그대로 반영될 수 있습니다.
비개발자 기준 판단은 간단합니다.
- 개인용 작은 프로젝트에서 반복 작업이 너무 느려서 답답할 때 — 제한적으로 고려 가능
- 회사 코드, 운영 서버, 중요한 데이터가 있는 프로젝트 — 쓰지 않는 게 원칙
- 처음 써보는 프로젝트 — 승인 절차를 몇 번 겪어보고 클로드가 어떻게 일하는지 감을 잡은 다음에 판단
승인 요청이 귀찮다고 처음부터 이 옵션부터 켜는 건 추천하지 않습니다. 승인 화면을 보면서 “클로드가 지금 뭘 바꾸려 하는지” 확인하는 습관이 먼저입니다.
자주 쓰는 세션 명령어
셸에서 claude로 들어간 다음, 세션 안에서 쓰는 명령어는 따로 있습니다.
| 명령 | 하는 일 |
|---|---|
/init |
CLAUDE.md 자동 생성 |
/memory |
CLAUDE.md·자동 메모리 확인·수정 |
/clear |
대화 기록 지우기 |
/help |
사용 가능한 명령 목록 |
/exit |
종료 (또는 Ctrl+D) |
/만 입력하면 지금 쓸 수 있는 명령어 전체 목록이 뜹니다. 다 외울 필요 없이, 헷갈리면 /부터 눌러보면 됩니다.
자주 묻는 질문
claude -p는 언제 쓰나요?
사람이 대화하려고 쓰는 옵션이 아닙니다. 스크립트나 다른 프로그램이 클로드를 자동으로 호출할 때 쓰는 옵션이라, 터미널에서 직접 대화한다면 몰라도 됩니다.
CLAUDE.md를 안 만들면 어떻게 되나요?
없어도 클로드 코드는 작동합니다. 다만 매번 같은 설명을 반복하게 됩니다. /init으로 시작해서, 같은 말을 두 번 하는 순간마다 한 줄씩 추가하는 방식을 권합니다.
자동 메모리와 CLAUDE.md 중 뭘 먼저 봐야 하나요?
CLAUDE.md를 먼저 봅니다. 사람이 직접 쓴 규칙이라 확실하고, 프로젝트를 처음 여는 사람도 바로 읽을 수 있습니다. 자동 메모리는 클로드가 알아서 채워가는 보조 기록이라 신경 쓰지 않아도 됩니다.
–dangerously-skip-permissions를 실수로 켰으면 어떻게 하나요?
Shift+Tab으로 권한 모드를 다시 순환하거나, 세션을 종료했다가 옵션 없이 다시 실행하면 됩니다. 이미 실행된 변경 사항은 git으로 되돌릴 수 있는지 먼저 확인하는 게 순서입니다.
정리
- 처음엔 셸 명령어 중
claude,-c,-r만 알아도 충분합니다. - CLAUDE.md는
/init으로 끝이 아니라, 같은 말을 두 번 하게 될 때마다 한 줄씩 채워가는 파일입니다. - 자동 메모리는 클로드가 스스로 채우는 보조 기록이라 처음엔 신경 쓰지 않아도 됩니다.
--dangerously-skip-permissions는 이름 그대로 위험 — 승인 절차에 익숙해지기 전에는 켜지 않는 게 원칙입니다.
오늘 5분만 쓴다면, /를 눌러서 지금 쓸 수 있는 명령어 목록부터 훑어보는 걸 권합니다.
다음 단계인 첫 프로젝트 만들기는 바이브코딩 첫 프로젝트에서 이어집니다. 전체 순서는 바이브코딩 시작 가이드에서 확인할 수 있습니다.
참고 자료:
– Claude Code 공식 빠른 시작 문서
– Claude가 프로젝트를 기억하는 방법 (CLAUDE.md·자동 메모리)
– Claude Code CLI 참조