클로드 코드(Claude Code)는 '터미널 안에서 AI와 대화하며 내 컴퓨터의 파일을 직접 만들고 고치는' 도구입니다. 채팅창에 코드를 복사해 붙여넣는 방식과 달리, AI가 내 폴더를 직접 읽고 쓰기 때문에 '복사 → 붙여넣기 → 어디에 저장하지?'라는 번거로움이 사라집니다. 이 글에서는 코딩을 한 번도 안 해본 분 기준으로, 설치부터 첫 결과물까지 가장 짧은 길을 안내합니다.
이 글의 흐름
- 클로드 코드가 일반 챗봇과 다른 점
- 설치 전에 준비할 것 단 두 가지
- 설치하고 처음 실행하기
- 첫 명령은 이렇게 거는 게 안전합니다
- 비개발자가 자주 막히는 지점
1. 챗봇과 무엇이 다른가
일반 AI 채팅은 '글'을 돌려줍니다. 그 글이 코드라도 결국 내가 복사해서 어딘가에 붙여넣어야 동작합니다. 클로드 코드는 한 단계를 건너뜁니다. 내 폴더를 열어 둔 채로 "회원가입 화면을 하나 만들어줘"라고 말하면, AI가 필요한 파일을 직접 생성하고 수정합니다. 즉 '대화가 곧 작업'이 됩니다.
2. 준비물 두 가지
거창한 준비는 필요 없습니다. 첫째, 작업할 빈 폴더 하나를 만들어 둡니다(예: 바탕화면에 my-site). 둘째, 터미널을 한 번 열어 봅니다. 맥은 '터미널' 앱, 윈도우는 'PowerShell'이나 'Windows Terminal'입니다. 까만 창이 무섭게 느껴져도 괜찮습니다. 우리가 외울 것은 사실 몇 줄뿐입니다.
3. 설치하고 처음 실행하기
설치는 공식 안내를 따르는 것이 가장 안전합니다. 설치가 끝나면 아까 만든 폴더로 이동한 뒤, 클로드 코드를 실행합니다. 폴더로 이동하는 명령과 실행 명령은 보통 이렇게 생겼습니다.
cd Desktop/my-site claude
실행하면 대화 입력창이 뜹니다. 이제부터는 한국어로 그냥 부탁하면 됩니다. "이 폴더에 간단한 소개 페이지를 index.html로 만들어줘"처럼요.
4. 안전한 첫 명령 거는 법
좋은 첫 명령은 '작게, 구체적으로'입니다. "멋진 사이트 만들어줘"는 범위가 너무 넓습니다. 대신 "흰 배경에, 제목과 한 문단 소개만 있는 index.html을 만들어줘. 글씨는 가운데 정렬"처럼 결과를 그려볼 수 있게 말합니다. AI가 파일을 만들면, 무엇을 바꿨는지 한 줄씩 설명해 달라고 덧붙이는 것도 좋습니다.
결과가 마음에 들면 한 단계씩 키워 갑니다. "이제 그 아래에 버튼을 하나 추가해줘", "버튼을 누르면 인사말이 뜨게 해줘"처럼요. 큰 결과물도 작은 요청을 쌓아 만드는 것이 정석입니다.
5. 비개발자가 자주 막히는 지점
첫째, '변경 사항을 그대로 적용할까요?' 같은 확인 질문이 나오면 내용을 읽고 답해야 합니다. 무조건 예를 누르는 습관은 위험합니다. 둘째, AI가 만든 결과가 한 번에 완벽하지 않을 수 있습니다. 이때는 화내지 말고 "여기 이 부분이 이렇게 나왔는데, 이렇게 바꿔줘"라고 구체적으로 되돌려주면 됩니다. 셋째, 무엇을 했는지 모르겠다면 "방금 무슨 파일을 왜 바꿨는지 쉽게 설명해줘"라고 물어보세요. 설명을 요구하는 것 자체가 실력을 키우는 길입니다.
마치며
클로드 코드의 진짜 가치는 '코드를 몰라도 결과를 만든다'가 아니라, '대화로 만들면서 코드를 자연스럽게 이해하게 된다'에 있습니다. 다음 글에서는 또 다른 인기 도구인 커서(Cursor)의 설치와 첫 실행을 같은 방식으로 안내합니다. 도구는 손에 익히는 순간부터 무기가 됩니다.
읽었으면, 직접 풀어보는 게 가장 빠릅니다.
무료 ‘수련’에서는 레벨별 챕터의 핵심을 익히고 퀴즈를 풀며 경험치(XP)를 쌓아 한 단계씩 레벨을 올립니다. 로그인하면 내 진행 상황이 저장됩니다.