본문으로 건너뛰기
Koding
클로드 코드(Claude Code) 비개발자 입문서 — 설치, 영어 해석, 자주 쓰는 명령어
무료

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

"엔지니어는 아니지만 Claude Code를 써보고 싶다"는 사람을 위한 입문서. 설치부터 말 거는 법, 화면에 나오는 영어가 무슨 뜻인지, 자주 쓰는 명령어, 해서는 안 되는 일까지, 막히기 쉬운 지점을 한국어로 쉽게 풀어 설명한다. 책 끝에는 〈복붙해서 쓰는 프롬프트 & 설정 템플릿 모음〉을 수록했다

Claude Code클로드코드비개발자바이브코딩코딩에이전트

1.Claude Code 입문 — 1. 들어가며

이 챕터 목차

이 책을 선택해 주셔서 고맙습니다.

이 책은 **"엔지니어는 아니지만 Claude Code를 써보고 싶다"**는 사람을 위해 썼어요.

솔직히 말하면 대부분 개발자가 아닌 일반인들은 처음엔 "절반밖에 모르는" 상태였어요. 터미널의 까만 화면은 어쩐지 무섭고, 영어는 자꾸 튀어나오고, 명령어가 무슨 뜻인지도 모르겠고... 그런데 혼자서 사업을 여러 개 굴리다 보니 Claude Code는 이제 없으면 안 될 파트너가 될 것이다.

이 책의 강점이 바로 거기에 있어요.

"전부 다 이해하고 있는 엔지니어"가 아니라 "절반만 알아도 그럭저럭 쓰고 있는 실무자"의 눈높이로 썼다. 그래서 초보자가 어디서 막히는지, 어디가 무서운지가 손에 잡힐 듯 보여요. 그 "막히는 지점"을 미리 짚어서 쉽게 풀어 설명했어요.

이 책의 구성

내용
1장Claude Code가 대체 뭔데? (일반 AI 챗봇과의 차이)
2장설치와 처음 5분
3장말 거는 요령
4장화면에 나오는 영어, 전부 번역해봤다
5장자주 나오는 Bash 명령어 20개
6장해서는 안 되는 일 7가지
부록복붙해서 쓰는 프롬프트 & 설정 템플릿 모음

순서대로 읽어도 되고, 궁금한 장부터 봐도 문제 없다.

세 가지 약속

전문 용어는 최소한으로 한다. 그래도 나오면 그때그때 알기 쉽게 풀어 드릴게요.

복붙해서 바로 사용할 수 있다. 특히 책 끝의 부록은 붙여 넣자마자 쓰는 연장통이에요.

겁주지 않으려고 노력했다. "망가뜨리면 어쩌지" 하는 걱정을 없애는 게 이 책의 목표예요.

자, 시작해 볼까요.

첫걸음은 "Claude Code, 그래서 대체 뭐 하는 녀석이야?"부터이다.


Claude Code란? ChatGPT·Claude와 결정적 차이 한눈에

"Claude Code, 그냥 Claude랑 뭐가 다른 거야?"

이거, 처음에 다들 한 번쯤 떠올리는 의문일 거다. 결론부터 말하면, 보통의 AI 채팅은 "말로 답할 뿐"이지만 Claude Code는 "실제로 손을 움직일 수 있다".

이 차이는 생각보다 크다.

보통의 AI 채팅이 할 수 있는 것, 할 수 없는 것

ChatGPT나 Claude.ai 같은 채팅형 AI는 글자로 물으면 글자로 답한다.

  • "이 메일 문장 좀 고쳐 줘" → 고친 문장을 채팅 화면에 띄워 준다
  • "Python 코드 좀 짜 줘" → 코드를 채팅 화면에 보여 준다

그런데 여기까지다. 그 코드를 실제로 파일에 저장하거나 실행하지는 않는다. 직접 복사하고, 파일을 열고, 붙여 넣고, 실행하고…… 이런 손작업이 일일이 필요하다.

Claude Code가 "실제로 손을 움직인다"는 건 무슨 뜻일까

Claude Code는 컴퓨터의 터미널(까만 화면)을 통해 실제로 파일을 다루고 프로그램을 실행한다.

구체적으로는 이런 일을 한다.

파일을 읽고 쓴다 "이 설정 파일 좀 고쳐 줘"라고 부탁하면 실제로 그 파일을 열어서 고쳐 준다. 채팅 화면에 코드를 붙여 주기만 하는 게 아니다.

프로그램을 실행한다 "이 스크립트 좀 돌려 줘"라고 부탁하면 실제로 실행해 결과를 보여 준다. 에러가 나면 직접 에러를 읽고 수정까지 시도한다.

여러 파일을 넘나들며 작업한다 "이 폴더 전체 코드를 보고 문제를 고쳐 줘"라고 부탁하면 여러 파일을 차례로 읽어 필요한 곳을 싹 고친다.

외부 서비스에 연결한다 (MCP: Model Context Protocol) 뒤 장에서 자세히 설명하겠지만, Gmail이나 Slack 같은 외부 서비스와 연결할 수 있다. "이번 달 국세청에 종합소득세 신청 내역 좀 확인해 줘"라고 부탁하면 실제로 국세청에 접속해 정보를 가져온다.

느낌으로 말하면

보통의 AI 채팅은 "똑똑한 조언자"다. 뭐든 알고 있고 정확한 조언을 준다. 하지만 실제 작업은 직접 해야 한다.

Claude Code는 "유능한 비서"다. 상담에 응하는 데 그치지 않고, 실제로 손을 움직여 작업까지 끝내 준다.

요리로 비유하면 ——

  • 보통의 AI 채팅: "이 재료로 이런 요리를 만들 수 있어요. 순서는 이렇습니다"라고 알려 준다
  • Claude Code: 실제로 부엌에 서서 요리를 만든다

엔지니어가 아니면 못 쓸까?

이것도 "No"다.

물론 Claude Code는 터미널이라는, 엔지니어스러운 화면을 쓴다. 하지만 직접 명령어를 칠 일은 거의 없다. 한국어로 "~해 줘"라고 부탁하면 필요한 명령어는 Claude Code가 알아서 생각하고 실행까지 한다.

"코드를 못 짜도, 코드를 쓰는 일은 할 수 있다." —— 이게 바로 Claude Code의 진짜 가치다.

영업 자료 자동 생성, 경리 데이터 집계, 메일 일괄 발송…… 엔지니어가 아니어도 이런 자동화가 현실이 된다.

정리

구분보통의 AI 채팅Claude Code
할 수 있는 일글자로 답한다파일 조작·프로그램 실행
작업 완결직접 해야 한다끝까지 자동으로 해 준다
외부 서비스 연동기본적으로 안 된다MCP 경유로 Gmail·freee 등에 연결
대상누구나엔지니어가 아니어도 쓸 수 있다

다음 장에서는 Claude Code를 실제로 설치해서 처음 5분 만에 돌려 보는 데까지 설명한다.


©2024-2026 ClaudeCode.to, Hand-crafted & made with Jaewoo Kim.

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