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

Claude Code를 쓰기 시작하면 처음에 부딪히는 벽이 있다.

"뭘 어떻게 부탁해야 할지 모르겠다."

이건 익숙해지면 해결되는 문제이기도 하지만, 몇 가지 요령을 알아 두면 확 풀린다. 이 장에서는 Claude Code에게 말 거는 기본기를 설명한다.

대전제: 한국어로 말 걸어도 된다

일단 이것부터. 영어 아니어도 괜찮다.

Claude Code는 한국어를 완벽히 이해한다. "Python 스크립트 만들어 줘"든 "엑셀 같은 파일 읽어서 집계해 줘"든, 한국어로 전하면 움직인다.

영어로 말 거는 게 정확도가 높다는 건 옛날얘기고, 지금은 한국어로도 문제없다. 오히려 한국어로 쓰는 편이 자기 의도를 정확히 전달한다.

요령 1: "목표"를 먼저 말한다

나쁜 예: "이 파일 열어서 3번째 줄 보고, 만약 숫자가 있으면……" 좋은 예: "이 파일 3번째 줄에 있는 숫자를 꺼내서 CSV로 내보내 줘"

사람에게 부탁할 때와 똑같이, "최종적으로 뭘 원하는지"를 맨 먼저 말하는 편이 잘 풀린다. 중간 절차는 Claude Code가 알아서 생각한다.

요령 2: 애매한 채로 던져 본다

"잘 설명은 못 하겠는데……" 하고 망설일 필요는 없다.

모르는 채로 던지면 Claude가 부족한 정보를 되묻는다. 오히려 "뭘 모르는지조차 모르겠는" 상태일 때는, 일단 생각하는 걸 적어 보는 게 정답이다.

예를 들어 "뭔가 매출 데이터를 보기 좋게 정리해 줬으면 좋겠어"라고 하면, "어떤 포맷으로 출력할까요?", "어느 기간 데이터인가요?"라고 되물어 온다. 거기에 답해 가다 보면 자연스럽게 요건이 잡혀 간다.

요령 3: `!` 명령으로 터미널을 그 자리에서 쓴다

Claude Code의 프롬프트(입력 화면)에서 !에 이어 명령을 적으면, 그 자리에서 터미널 명령을 실행할 수 있다.

! ls

→ 지금 있는 폴더의 파일 목록이 표시된다

! cat error.log

→ error.log 내용이 표시되고, 그대로 Claude에게 바로 읽힌다

이게 뭐가 편하냐면, "에러 났어, 봐 줘"라고 하는 대신 ! cat error.log만 실행하면 Claude가 로그를 직접 읽고 원인을 분석한다. 복붙하는 수고가 줄어든다.

요령 4: `@파일명`으로 파일을 직접 참조시킨다

파일의 경로(위치)를 @에 이어 적으면, 그 파일을 Claude가 직접 읽는다.

@src/app.py 보고, 버그 없는지 확인해 줘

@~/Documents/sales_data.csv 데이터 집계해 줘

채팅 화면에 파일 내용을 복붙할 필요가 없어진다. 큰 파일이라도 통째로 참조시킬 수 있다.

요령 5: 단계적으로 부탁한다

한 번에 전부 부탁하려고 하면 잘 안 풀릴 때가 있다.

"웹 스크래핑해서, 데이터 다듬고, CSV로 저장하고, Google 스프레드시트로 전송해 줘" —— 이걸 한 방에 부탁하기보다 단계적으로 진행하는 편이 정확도가 높다.

먼저 "이 사이트에서 상품명과 가격을 가져오는 스크립트 짜 줘" 잘 돌아가면 "이 데이터 좀 다듬어 줘" 잘되면 "CSV로 저장해 줘"

복잡한 작업일수록 잘게 잘라 확인하며 진행하면 실패가 적다.

요령 6: 실패하면 `/clear`로 리셋한다

대화가 길어지면 Claude가 맥락을 오해한 채로 진행해 버릴 때가 있다. "뭔가 이상한 방향으로 가고 있는데" 싶으면:

/clear

이걸로 대화를 리셋할 수 있다. 처음부터 다시 하는 게, 수정을 거듭하는 것보다 빠를 때도 많다.

자주 쓰는 명령어 목록

이건 Claude에게 "말을 건다"기보다 동작을 제어하는 명령어다.

명령어	하는 일
`/clear`	대화 리셋 (프로젝트 전환 시 필수)
`/compact`	길어진 대화를 압축해 이어 간다
`/plan`	구현 전에 계획을 세우고 승인받은 뒤 진행한다
`/cost`	이번 세션에서 쓴 토큰(요금)을 확인한다
`Ctrl+C`	생성을 도중에 멈춘다
`Esc`	한 단계 전 상태로 되돌린다
`Ctrl+B`	무거운 처리를 백그라운드로 돌리고 다른 작업을 한다

Esc로 되돌리기는 현재 버전에서 보통 Esc를 두 번(Esc Esc) 눌러 되돌리기 메뉴를 여는 식으로 동작한다. 단축키는 버전에 따라 조금씩 다를 수 있으니, /help로 지금 쓸 수 있는 명령·단축키를 확인하면 된다.

실제 대화 예시

케이스 1: 파일을 분석해 줬으면 할 때

@~/Downloads/sales_2026.csv 읽어서, 월별 매출 합계 내 줘

케이스 2: 에러를 고쳐 줬으면 할 때

방금 스크립트 실행했더니 에러가 났어
! python3 scraper.py
위 에러 보고 원인 알려 주고, 고쳐 줘

케이스 3: 잘 모르겠지만 부탁하고 싶을 때

매달 엑셀로 손수 하던 매출 집계를 자동화하고 싶어.
지금은 매출 데이터 CSV를 열어서, 월별로 합계를 내고, 다른 시트에 옮겨 적고 있어.
이걸 자동으로 하는 방법 있을까?

"부탁이 서툴러도 괜찮다"가 결론

Claude Code는 애매한 지시여도 "아마 이런 뜻이죠?" 하고 보완하며 움직인다.

부족한 정보는 되묻는다. 잘못 해석했으면 "아니, 이쪽 의미야"라고 바로잡으면 된다.

잘 부탁 못 하는 게 당연하고, 처음엔 실패하는 게 당연하다. /clear로 리셋해 가며 조금씩 익숙해지는 게 가장 빠른 지름길이다.

이메일문의: 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

3.Claude Code 입문 — 3. 한국어로 제대로 시키는 6가지 요령 (프롬프트 가이드)