클로드 코드 한국어 가이드 — 설치부터 실전 워크플로까지

클로드 코드는 터미널에서 돌아가는 AI 코딩 도구입니다. 터미널은 컴퓨터에 글자로 명령을 내리는 창인데, 여기서는 도구를 띄우는 창일 뿐이고 안에서는 한국어로 대화합니다.

코드를 제안만 하는 게 아니라 파일을 직접 고치고, 명령을 실행하고, 결과를 확인한 뒤 다음 작업으로 넘어가요. 이 가이드는 그 도구를 처음부터 다루는 한국어 코스의 출발점이자 전체 지도입니다.

이 코스는 문법을 가르치지 않습니다. 대신 도구를 다루는 법을 다뤄요. 대화를 어떻게 관리하는지, 권한을 어디까지 열어줄지, 망쳤을 때 어떻게 되돌리는지 같은 것들입니다. 바이브코딩에서 실제로 발목을 잡는 건 문법이 아니라 이쪽이거든요.

무엇이 다른가요?#

AI 코딩 도구는 크게 두 갈래입니다. 편집기 안에서 코드를 같이 쓰는 쪽과, 작업을 통째로 맡기는 쪽입니다. 클로드 코드는 후자예요.

[편집기 통합형]     나: 코드 한 줄 씀 → AI: 다음 줄 제안 → 나: 받을지 결정
[터미널 에이전트형]  나: "이 기능 만들어줘" → AI: 파일 여러 개 수정·실행 → 나: 결과 검토

이 차이가 사용법을 바꿉니다. 한 줄씩 확인하며 가는 게 아니라 덩어리로 맡기고 검토하기 때문에, 맡기기 전에 방향을 잡는 법과 결과를 되돌리는 법이 중요해져요.

코스 목차#

각 화는 앞 화 위에 쌓입니다. 순서대로 읽는 걸 권합니다.

• 0화 — 이 글 (전체 지도)
• 1화 — 설치하고 첫 대화까지
• 2화 — AI가 아까 한 말을 잊어버릴 때
• 3화 — AI에게 정확히 시키는 법
• 4화 — 망쳤을 때 되돌리는 법
• 5화 — 같은 설명을 매번 반복하지 않는 법
• 6화 — 나만의 커맨드 만들기
• 7화 — 못 하는 일을 붙이기

하나만 고르라면 4화입니다. 되돌릴 줄 알아야 과감하게 시킬 수 있거든요.

먼저 알아두면 좋은 용어#

코스를 읽다 막히면 사전 항목으로 넘어가 확인하고 오세요. 각 화 안에서도 필요한 자리마다 링크를 겁니다.

누가 읽으면 좋나요?#

• AI로 뭔가 만들어봤지만 중간에 엉키는 사람 — 대화가 길어지면 AI가 딴소리를 하고, 파일이 이상해져도 되돌릴 줄 모르는 단계
• 클로드 코드를 깔았는데 뭘 쳐야 할지 모르겠는 사람 — 빈 입력창 앞에서 멈추는 단계

반대로 코드를 능숙하게 읽고 쓰는 분이라면 이 코스는 너무 기초일 수 있습니다. 공식 문서를 바로 보시는 게 빠릅니다.

이 코스를 쓰는 법#

읽고 끝내지 마세요. 각 화에는 실습이 하나씩 있습니다. 만들고 있는 프로젝트가 있으면 거기에, 없으면 아무 폴더나 하나 만들어서 따라 하면 됩니다.

다 읽고 시작하는 것보다 1화만 읽고 손을 움직이는 쪽이 훨씬 빨리 늡니다. 도구는 설명을 읽어서 익혀지지 않아요.

→ 1화: 설치하고 첫 대화까지