클로드 코드(Claude Code) 비개발자 입문서 — 설치, 영어 해석, 자주 쓰는 명령어

여기까지 오느라 수고하셨어요.

이 장은 지금까지의 장과 결이 조금 다릅니다. 읽는 장이 아니라 "붙여서 쓰는" 레퍼런스이다.

Claude Code를 쓰다 보면 "어, 이거 어떻게 부탁했더라", "이 한마디, 전에도 썼는데" 싶은 장면은 대체로 정해져 있어요. 그렇다면 그 "단골 문구"를 처음부터 곁에 두면 됩니다.

마음에 드는 걸 복사해서, 자기 말로 살짝만 바꿔서 쓰세요. 그것만으로 매번 처음부터 생각하는 스트레스가 사라집니다.

! 이 장의 프롬프트는 전부 한국어 그대로 복붙할 수 있어요. 영어는 하나도 필요 없습니다.

1. 부탁하는 법, 황금 템플릿

Claude Code는 "알아서 헤아려 주는" 것처럼 보여도, 사실 전제를 모르면 핀트가 어긋나요. 사람 신입사원과 똑같아서, "배경·목표·하지 말았으면 하는 것·출력 형태"를 건넬수록 한 번에 원하는 대로 움직입니다.

헷갈리면 이 틀에 맞춰 적으면 돼요.

【배경】 나는 ○○를 하고 있다. 지금은 이런 상황이다.
【하고 싶은 것】 △△를 실현하고 싶다.
【하지 말았으면 하는 것】 □□는 피해 줘 / ~에는 손대지 마.
【출력 형태】 결과는 표로 / 불릿으로 / 코드는 파일에 써 줘.

기입 예시

【배경】 엑셀로 매달 매출을 손으로 집계하고 있다. 파일은 다운로드 폴더에 있다.
【하고 싶은 것】 월별 합계를 자동으로 내고 싶다.
【하지 말았으면 하는 것】 원본 파일은 덮어쓰지 마.
【출력 형태】 새 파일에, 월 × 합계 표로 내 줘.

처음엔 다 채우지 않아도 돼요. "배경"과 "하고 싶은 것"만 적어도, 그냥 명령하는 것보다 정확도가 확 올라갑니다.

2. 장면별, 그대로 쓰는 지시 문구 20

그대로 복붙할 수 있는 "단골 문구"를 장면별로 20개.

🔍 조사·파악하기

이 폴더에 뭐가 있는지 대충 설명해 줘
이 설정 파일이 뭘 하는지, 전문 용어 없이 알려 줘
지금 이 프로젝트가 어떤 상태인지 정리해 줘
이 에러 메시지, 결국 뭐가 문제인지 한국어로 요약해 줘

🛠 만들기·부탁하기 5. ~하는 스크립트 짜 줘. 먼저 계획을 보여 주고 나서 진행해 6. 이거 샘플 하나 만들어서 보여 줘. 맘에 들면 계속할게 7. 방금 거, 좀 더 짧게 / 간단하게 안 될까? 8. 코드는 터미널에 붙이지 말고, 파일에 써서 건네줘

🔧 고치기·되돌리기 9. 에러 났어. 원인 찾아서 고쳐 줘 10. 방금 변경, 되돌려 줘 11. 안 움직이게 됐어. 직전에 뭘 바꿨는지 알려 줘 12. 여기만 고쳐 줘. 다른 부분은 건드리지 마

✅ 확인하기 (안전장치) 13. 실행하기 전에, 뭘 할 건지 설명해 줘 14. 이 작업으로 사라지거나 덮어쓰는 파일 있어? 15. 이거 되돌릴 수 있는 작업이야? 16. 잘 모르겠으니까, 일단 멈추고 확인하게 해 줘

🧭 진행 방식 정리하기 17. 3단계 이상인 작업은 먼저 계획을 보여 줘 18. 하나씩 확인하면서, 천천히 진행해 19. 전문 용어 쓰지 말고, 중학생도 알 수 있게 설명해 줘 20. 마지막에, 한 일을 불릿으로 정리해 줘

! 전부 외울 필요는 없어요. "13·14·15번" 확인 문구만큼은 손이 미끄러져 중요한 파일을 지우는 사고를 막아 줍니다.

3. 막혔을 때 "마법의 한마디" 모음

"으악, 뭔가 이상한 방향으로 가고 있어", "영어가 잔뜩 나왔어"라고 할때의 상황을 리셋할 수 있는 한마디들이에요.

이렇게 되면	이 한마디
폭주하는 것 같다	먼저 Esc 키로 멈춘다 → "일단 멈춰. 지금 상황을 설명해 줘"
영어가 잔뜩 나왔다	"방금 영어, 한국어로 번역해 줘"
설명이 너무 어렵다	"더 쉽게 말하면? 비유로 설명해 줘"
내가 길을 잃었다	"지금 어디까지 진행됐는지 정리해서 알려 줘"
확인 없이 진행해 버린다	"다음부터는, 실행하기 전에 꼭 확인해 줘"
같은 실수를 반복한다	"방금 실패를 감안해서, 다시 해 줘"

! Esc 키는 가장 강력한 안전장치예요. "어, 큰일났다" 싶으면 생각하기 전에 일단 Esc. 멈추고 나서 한국어로 다시 물어보면 대개 수습됩니다.

4. 처음 쓰는 CLAUDE.md 최소 템플릿

CLAUDE.md는, 매번 말하지 않아도 지켜 줬으면 하는 규칙을 적어 두는 메모예요. 프로젝트 폴더에 놔두면 Claude Code가 실행할 때마다 읽어 줍니다.

"매번 '한국어로 답해'라고 치는 거 귀찮네" — 그런 생각이 들면, 이걸 쓸 신호예요.

아래 템플릿을 복사해서 CLAUDE.md라는 이름으로 저장하고, ( ) 안을 자기용으로 바꿔 쓰세요.

# 이 프로젝트에 대해
(무슨 폴더인지 한 줄로. 예: 어린이집 대상 영업 리스트를 만드는 작업 폴더)

## 부탁할 것
- 한국어로 답해
- 3단계 이상인 작업은 먼저 계획을 보여 줘
- 파일을 지우거나 덮어쓸 때는 반드시 확인해
- 전문 용어는 피하고, 쉽게 풀어서 설명해
- 마지막에, 한 일을 불릿으로 정리해 줘

## 건드리지 말 것
- (지우고 싶지 않은 파일명·폴더명을 여기에)

이것만으로 매번 하는 지시가 확 줄어요. 쓰다가 "이것도 매번 말하네" 싶은 게 보이면, 그때그때 한 줄씩 더해 가는 게 요령이에요.

5. 초보의 안전 설정 체크리스트

앞에서 소개한 〈6장 주의사항 7가지〉 의 실천판이에요. 새 작업을 시작하기 전에 슥 훑어보세요.

중요한 파일은, 맡기기 전에 사본을 하나 떠 뒀다
"전부 지워" 같은 애매하고 위험한 부탁을 하지 않았다
실행 전에 "뭘 할지" 설명하게 했다
잘 모르겠는 확인을, 일단 Yes로 넘기지 않았다
비밀번호나 API 키를 화면에 붙이지 않았다
모르는 명령을 권하면, "이게 뭐야?"라고 물었다
한 번에 완벽을 노리지 않고, 작게 시도하고 나서 넓혔다

! 전부 못 해도 괜찮아요. 그래도 **위 3개(사본·애매 금지·설명하게 하기)**만큼은 습관으로 들이면 사고가 거의 없어집니다.

6. "이것만 외운다" 빠른 참조표

최소한 이것만 알면 움직일 수 있어요.

하고 싶은 것	방법
동작을 멈추고 싶다	Esc 키
방금 지시를 취소하고 싶다	"방금 건 취소해"라고 친다
대화를 리셋하고 싶다	`/clear`라고 친다
지금 할 수 있는 걸 알고 싶다	`/help`라고 친다
파일을 보여 주고 싶다	파일을 화면에 드래그 앤 드롭
일단 막막하다	Esc → "한국어로, 지금 상황을 설명해 줘"

! 명령어(/로 시작하는 것)는 억지로 외우지 않아도 된다. "Esc"와 "한국어로 말 걸기" — 이 둘만 있으면 대부분의 상황은 넘길 수 있어요.

마치며

여기까지의 도구, 전부 "완벽하게 다뤄야" 하는 건 아니에요. 마음에 드는 3개만 곁에 두고, 쓰면서 자기용으로 키워 가세요.

Claude Code는, 정성껏 부탁하면 정성껏 답해 주는 파트너예요. 처음엔 어설퍼도 괜찮아요. 몇 번 주고받다 보면 "아, 이렇게 부탁하면 되는구나"가 몸에 익습니다.

이 책이 조금이나마 당신의 클로드코드 첫걸음에 보탬이 됐다면 좋겠다.

혹시 "더 깊이 파고들어 쓰고 싶다" 싶으면, 중급 편에서 MCP·Skills·Hooks·병렬 Agent —— "자동화"의 세계가 기다리고 있어요. 거기서 또 만나요.

이메일문의: jaewoo@claudecode.to

Koding 프로필: https://koding.kr/u/jaewoo.kim2019

Jaewoo Kim by AI-fluent liberal arts Engineer

#AI기업교육 #AI에이전트개발교육 #클로드코드기업교육 #클로드코드교육 #AX전환 #ClaudeCode교육 #AI #LLM #엔지니어 #개발자 #Claude #ClaudeCode

7.Claude Code 입문 — 7. 복붙해서 쓰는 비개발자 치트시트: 프롬프트 템플릿 모음