파트 1에서 다룬 내용을 보충합니다. 필요할 때 찾아보면 됩니다.
부록 활용 팁 처음 읽을 때는 
표시가 있는 것만 보세요. 나머지는 필요할 때 찾아보면 됩니다.
표시가 있는 것만 보세요. 나머지는 필요할 때 찾아보면 됩니다. 실행 옵션
터미널에서 Claude Code를 시작할 때 쓰는 명령어입니다.
초보자 필수
처음에는 아래 세 개만 알면 충분합니다.
명령어 | 설명 | 실사용 상황 |
claude | 새 대화 시작 | 새로운 작업을 시작할 때 |
claude --continue | 마지막 대화 이어서 시작 | 점심 후 복귀, 터미널 재시작 |
claude --resume | 이전 대화 목록에서 선택 | 며칠 전 작업 다시 찾을 때 |
실전 예제
점심 먹고 돌아왔는데 터미널이 꺼져있음
claude --continue
→ 바로 이전 대화 이어서 시작
Plain Text
복사
월요일에 금요일 작업 다시 시작
claude --resume
→ 대화 목록 보고 선택
Plain Text
복사
익숙해진 뒤에
명령어 | 설명 | 실사용 상황 |
claude --dangerously-skip-permissions | 권한 확인 건너뛰기 | 작업 전용 폴더에서 반복 작업 |
claude --model sonnet | 모델 지정 | 특정 모델로 시작하고 싶을 때 |
claude -p "질문" | 한 번만 질문하고 종료 | 빠른 확인이 필요할 때 |
claude --version | 설치된 버전 확인 | 업데이트 확인 전 |
claude --help | 실행 옵션 목록 | 명령어 기억 안 날 때 |
claude update | 수동 업데이트 | 새 기능 사용하고 싶을 때 |
claude config | 설정 변경 | 기본 모델, 언어 등 설정 |
옵션 조합
여러 옵션을 함께 쓸 수 있습니다:
claude --dangerously-skip-permissions --continue
→ 권한 확인 없이 마지막 대화 바로 이어서 시작
Plain Text
복사
claude --model opus -p "이 폴더에 파일 몇 개?"
→ Opus 모델로 한 번만 질문하고 종료
Plain Text
복사
-continue와 -resume의 차이
처음에 이 둘이 헷갈릴 수 있습니다.
`--continue`: 가장 최근 대화를 묻지도 따지지도 않고 바로 이어갑니다.
`--resume`: 이전 대화 목록을 보여주고 어떤 대화를 이어갈지 선택하게 합니다.
실무에서는 --continue를 훨씬 많이 씁니다. 점심 먹고 돌아와서 아까 하던 작업을 이어갈 때, 터미널이 꺼져서 다시 열었을 때 등. --resume은 며칠 전 했던 작업을 다시 찾아볼 때 씁니다.
단축키 팁 매번 긴 명령어 치기 귀찮다면, 아래 "단축어 설정" 섹션을 참고하세요. cc, ccc 같은 짧은 명령어로 만들 수 있습니다.
--dangerously-skip-permissions란
Claude Code는 파일을 수정하거나 명령어를 실행할 때마다 사용자에게 확인을 요청합니다. 이 옵션을 켜면 그 확인 과정을 건너뜁니다. 매번 Y를 누르는 번거로움 없이 작업이 자동으로 진행됩니다.
편리하지만 위험할 수 있습니다. 확인 없이 파일을 삭제하거나, 의도하지 않은 수정을 할 수 있기 때문입니다.
안전하게 사용하는 원칙
사용해도 되는 경우
•
작업 전용 폴더에서만: 예를 들어 ~/work/temp-project/ 같은 곳
•
중요 파일이 없는 곳: 원본 데이터, 계약서, 결제 관련 파일이 없는 폴더
•
반복 작업할 때: 같은 작업을 여러 번 해서 Claude의 패턴을 알고 있을 때
절대 사용하면 안 되는 경우
•
홈 디렉토리(`~`)에서: Claude가 시스템 설정 파일을 수정할 수 있습니다
•
여러 프로젝트가 섞인 폴더: 작업 대상이 아닌 다른 프로젝트 파일이 영향받을 수 있습니다
•
처음 쓰는 동안: 확인 화면을 읽는 것 자체가 학습 과정입니다
처음 한 달은 기본 모드로 이 옵션은 이름에 "dangerously"가 들어있습니다. Anthropic이 일부러 이렇게 지은 것입니다. 편의를 위해 존재하지만, 쓸 때마다 약간의 경각심을 가지라는 의미입니다. 처음 한 달은 이 옵션 없이 기본 모드로 사용하면서 Claude Code의 작업 패턴에 익숙해지는 것을 권장합니다. Claude가 확인을 요청할 때 어떤 정보를 보여주는지, 어떤 명령어를 실행하려는지 눈에 익은 뒤에 켜도 늦지 않습니다.
실전 사용 예
안전한 사용 예시:
cd ~/work/monthly-report-temp
claude --dangerously-skip-permissions --continue
→ 임시 작업 폴더에서만 권한 건너뛰기
Plain Text
복사
위험한 사용 예시:
cd ~
claude --dangerously-skip-permissions
→ ❌ 홈 디렉토리에서 사용하면 시스템 파일 영향 가능
Plain Text
복사
대화 중 명령어
Claude Code 안에서 /로 시작하는 명령어입니다. 대화 입력창에 그대로 입력하면 됩니다.
초보자 필수
처음에는 아래 네 개면 충분합니다.
명령어 | 설명 | 언제 쓰나요? |
/help | 도움말 | 명령어 잊어버렸을 때 |
/compact | 대화 요약해서 비용 절약 | 대화 20-30번 이상 주고받았을 때 |
/status | 현재 모델, 사용량 등 확인 | 얼마나 썼는지 궁금할 때 |
/model | 대화 중 모델 변경 | 더 좋은 모델로 바꾸고 싶을 때 |
익숙해진 뒤에
명령어 | 설명 | 언제 쓰나요? |
/config | 설정 변경 | 기본 모델, 언어 설정 등 |
/init | CLAUDE.md 생성 | 프로젝트에 규칙 저장 (9장) |
/doctor | 문제 진단 | 뭔가 이상할 때 (11장) |
/context | 현재 컨텍스트 확인 | Claude가 뭘 보고 있는지 확인 |
/exit | Claude Code 종료 | 대화 끝낼 때 |
/fork | 현재 대화 복제해서 새로 시작 | 다른 방향 시도해보고 싶을 때 |
/mcp | MCP 서버 확인 | 연결된 도구 확인 (12장) |
/plugin | 플러그인 관리 | 플러그인 켜기/끄기 |
/resume | 이전 대화 이어서 시작 | 다른 대화로 전환 |
/compact는 언제 쓰나요
대화가 길어지면 Claude Code가 느려지거나, 앞부분에서 했던 이야기를 잊어버리는 것처럼 보일 때가 있습니다. 이때 /compact를 입력하면 지금까지의 대화를 요약해서 정리합니다. 대화의 맥락은 유지하면서 사용량을 아끼는 효과가 있습니다. 자세한 내용은 10장에서 다룹니다.
체감 기준: 대화를 20~30번 이상 주고받았으면 한 번 정리하는 것이 좋습니다. "갑자기 대화가 느려졌다" 싶으면 /compact를 먼저 시도해보세요.
실전 사용 예
상황: 30번 넘게 대화했더니 응답이 느려짐
/compact
→ Claude: "대화를 요약했습니다. 이어서 말씀하세요."
Plain Text
복사
대화 길이 체크 /status 명령어로 현재 대화 길이를 확인할 수 있습니다.
"Context: 45,000 tokens" 같은 표시가 나오면 /compact 고려하세요.
키보드 단축키
키 | 설명 | 언제 쓰나요? |
Esc | 현재 입력 취소 | 잘못 입력했을 때 |
Ctrl+C 1회 | 대화창 비우기 | 긴 Input창을 한번에 비우기 |
Ctrl+C 2회 | 현재 작업 중단 | Claude가 잘못된 방향으로 갈 때 |
exit | Claude Code 종료 | 대화 끝낼 때 |
Ctrl+C는 가장 많이 쓰게 되는 단축키입니다. Claude가 너무 긴 작업을 하고 있거나, 잘못된 방향으로 가고 있을 때 즉시 중단시킬 수 있습니다.
중단 후 확인하세요 중단해도 이미 완료된 작업은 되돌아가지 않으니, 파일을 삭제하는 중이었다면 일부만 삭제된 상태일 수 있습니다. 중단 후 "지금까지 뭘 했는지 확인해줘"라고 물어보는 것이 안전합니다.
단축어 설정
매번 긴 명령어를 입력하는 대신, 짧은 단축어를 만들 수 있습니다.
Mac/Linux 사용자
~/.zshrc 파일에 아래 내용을 추가합니다. (bash를 쓰는 경우 ~/.bashrc)
alias cc='claude'
alias ccs='claude --dangerously-skip-permissions'
alias ccc='claude --continue'
alias ccsc='claude --dangerously-skip-permissions --continue'
Plain Text
복사
파일을 수정한 뒤 터미널을 껐다 켜면 적용됩니다.
적용 전후 비교
Before:
claude --dangerously-skip-permissions --continue
Plain Text
복사
After:
ccsc
Plain Text
복사
훨씬 간단하죠! 이제 cc만 입력하면 Claude Code가 실행되고, ccsc를 입력하면 권한 확인 없이 마지막 대화를 이어서 시작합니다.
Windows 사용자 (PowerShell)
PowerShell 프로필 파일에 추가합니다:
Set-Alias cc claude
function ccc { claude --continue }
function ccs { claude --dangerously-skip-permissions }
Plain Text
복사
zshrc 파일 수정이 어렵다면
Claude Code에게 시키면 됩니다:
~/.zshrc 파일에 claude 단축어를 추가해줘.
cc는 claude, ccs는 claude --dangerously-skip-permissions,
ccc는 claude --continue, ccsc는 둘 다 조합한 것으로.
Plain Text
복사
이것이 Claude Code의 장점입니다. 터미널 설정 파일을 직접 편집할 줄 모르더라도, Claude Code에게 말로 설명하면 대신 해줍니다. 수정 전에 확인을 요청하니 잘못될 걱정은 없습니다.
Git이 가끔 나오는데, 이게 뭔가요?
Claude Code를 사용하다 보면 "git"이라는 단어가 가끔 등장합니다. 당황하지 않아도 됩니다.
Git은 파일의 변경 이력을 기록하는 도구입니다. 문서를 수정할 때마다 "언제, 무엇을 바꿨는지" 자동으로 기록해두는 것이라고 생각하면 됩니다. 개발자들이 코드를 관리할 때 쓰는 도구인데, Claude Code가 내부적으로 사용하기도 합니다.
Claude Code 사용 중 git이 등장하는 경우
두 가지 상황이 있습니다:
1. Claude Code가 작업 중 자동으로 사용하는 경우
Claude Code는 파일을 수정할 때 변경 내역을 추적하기 위해 git을 사용할 수 있습니다. 터미널에 git add, git commit 같은 메시지가 보여도, Claude가 알아서 처리하는 것이므로 신경 쓰지 않아도 됩니다.
2. "git이 설치되어 있지 않습니다" 메시지가 나오는 경우
Mac에서는 대부분 git이 기본으로 설치되어 있습니다. 이 메시지가 나오면 Claude에게 시키면 됩니다:
git이 설치 안 됐다고 나와. 설치 방법 알려줘.
Plain Text
복사
Mac에서 git을 처음 실행하면 "Command Line Developer Tools"를 설치하겠냐는 팝업이 뜰 수 있습니다. "설치"를 누르면 됩니다. 몇 분 걸릴 수 있습니다.
알아두면 좋은 것
git 명령어를 외울 필요는 없습니다. Claude에게 말로 시키면 됩니다:
하고 싶은 것 | Claude에게 이렇게 말하면 됩니다 |
어떤 파일이 바뀌었는지 보기 | "바뀐 파일 목록 보여줘" |
변경 이력 확인하기 | "이 폴더의 변경 이력 보여줘" |
수정한 것 되돌리기 | "방금 수정한 거 원래대로 돌려줘" |
Git의 가장 큰 장점: 되돌리기 Claude Code가 git으로 변경 이력을 기록해두면, 실수가 생겨도 이전 상태로 되돌릴 수 있습니다. 안심하고 작업해도 됩니다.
git 관련 메시지가 불안할 때
Claude Code 작업 중 git commit, git push, git merge 같은 메시지가 터미널에 나오면 "내가 모르는 걸 하고 있는 건 아닌가" 싶을 수 있습니다. 이럴 때는 작업을 멈추고 물어보면 됩니다:
방금 git으로 뭘 한 거야? 내 파일에 무슨 영향이 있어?
Plain Text
복사
Claude가 무엇을 했는지, 파일에 어떤 영향이 있는지 설명해줍니다.
실전 예제
상황: 터미널에 "git commit" 메시지가 나옴
방금 git commit이라고 나왔어. 뭘 한 거야?
→ Claude: "파일 수정 내역을 저장했습니다. 혹시 잘못됐다면 git reset HEAD~1로 되돌릴 수 있습니다."
Plain Text
복사
git push는 주의 git push는 변경 내용을 외부 서버(GitHub 등)에 올리는 동작입니다.
본인이 GitHub 계정을 연결한 적이 없다면 실행되지 않지만, 연결했다면 주의하세요.
문제가 생겼을 때 확인할 것
파트 1 전체에서 겪을 수 있는 문제들을 정리합니다.
자주 발생하는 문제
증상 | 원인 | 해결 |
command not found: brew | Homebrew PATH 미설정 | 2장 "command not found가 나오면" 참고 |
command not found: claude | Claude Code PATH 미설정 | 터미널 재시작. 안 되면 재설치 |
브라우저 로그인 후 터미널 무반응 | 인증 토큰 전달 지연 | 30초 대기 후, Ctrl+C → claude 재실행 |
rate limit exceeded | 사용량 한도 초과 | 5시간 후 자동 초기화. 또는 Max 플랜 업그레이드 |
Claude가 영어로 답변 | 기본 동작 (정상) | "한국어로 대답해줘" 또는 CLAUDE.md에 설정 (9장) |
터미널이 멈춘 것 같음 | 이전 명령 실행 중 | Ctrl+C로 중단 |
No such file or directory | 폴더 경로 오타 | pwd로 현재 위치 확인 후 경로 재입력 |
Claude가 같은 실수 반복 | 지시가 모호함 | 더 구체적으로 지시 (8장 참고) |
추가 문제 해결
위 표에 없는 문제가 생기면, Claude Code에게 직접 물어보는 것이 가장 빠릅니다:
에러가 나와. [에러 메시지 그대로 붙여넣기]. 어떻게 해야 해?
Plain Text
복사
Claude Code 자체가 실행이 안 되는 경우에는 Claude.ai(웹)에서 같은 질문을 하면 됩니다.
정리
이 부록에서 다룬 내용:
기본 사용
•
실행 옵션 (claude, --continue, --resume)
•
대화 중 명령어 (/help, /compact, /status)
•
키보드 단축키 (Ctrl+C, Esc)
효율 향상
•
단축어 설정으로 명령어 간소화
•
/compact로 비용 절약
안전 수칙
•
--dangerously-skip-permissions는 작업 전용 폴더에서만
•
처음 한 달은 기본 모드 권장
•
Git 관련 메시지는 당황하지 말고 물어보기
문제 해결
•
자주 발생하는 문제와 해결책
•
Claude에게 직접 물어보기
이 부록은 북마크하세요 필요할 때마다 찾아보는 레퍼런스로 활용하세요. 처음부터 전부 외울 필요 없습니다!