Claude Code, 문서 읽지 말고 직접 써보면서 배우기

또 하나의 AI 코딩 도구, 근데 이번엔 CLI에서 돌아가요

AI 코딩 도구가 정말 빠르게 쏟아지고 있죠. GitHub Copilot, Cursor, Windsurf 같은 도구들이 이미 많은 개발자의 일상이 됐는데요. Anthropic에서 만든 Claude Code는 조금 다른 접근을 취해요. IDE(통합 개발 환경) 안에 플러그인처럼 붙는 게 아니라, 터미널에서 직접 실행하는 CLI(커맨드라인 인터페이스) 기반 에이전트거든요. 터미널에서 claude라고 치면 바로 대화가 시작되고, 파일을 읽고, 수정하고, 테스트를 돌리고, git 커밋까지 해주는 식이에요.

그런데 문제가 하나 있어요. Claude Code가 할 수 있는 게 워낙 많다 보니, 공식 문서를 처음부터 끝까지 읽는 것만으로는 "아, 이걸 이렇게 쓰면 되겠구나"라는 감이 잘 안 잡힌다는 거예요. 그래서 등장한 게 바로 이 인터랙티브 튜토리얼이에요. 문서를 읽는 대신, 직접 과제를 풀면서 Claude Code의 핵심 기능을 몸으로 익히는 방식이죠.

어떤 식으로 배우게 되나요?

이 튜토리얼의 핵심 철학은 "읽지 말고, 해봐라(Learn by doing, not reading)"예요. 웹사이트에 들어가면 단계별로 실습 과제가 주어지는데요, 각 과제가 Claude Code의 특정 기능 하나를 집중적으로 다뤄요.

예를 들어 첫 번째 단계에서는 Claude Code를 설치하고 기본적인 대화를 나눠보는 것부터 시작해요. "이 프로젝트의 구조를 설명해줘"라고 물어보거나, "이 함수에 타입스크립트 타입을 추가해줘" 같은 간단한 요청을 해보는 거죠. 이게 뭐가 특별하냐고요? Claude Code는 단순히 코드 조각을 제안하는 게 아니라, 프로젝트 전체의 맥락을 파악해서 응답하거든요. 파일 구조, import 관계, 기존 코딩 컨벤션까지 고려해서 답을 줘요.

그 다음 단계로 가면 좀 더 실전적인 시나리오가 나와요. 버그가 있는 코드를 주고 "이거 고쳐봐"라고 하거나, 기존 코드를 리팩토링하는 과제, 테스트 코드를 작성하는 과제 등이 있어요. 여기서 중요한 건 Claude Code의 도구 사용(tool use) 기능인데요, Claude Code는 단순히 텍스트를 생성하는 게 아니라 실제로 파일을 읽고(Read), 수정하고(Edit), 터미널 명령을 실행하고(Bash), 검색(Grep, Glob)까지 할 수 있어요. 마치 옆에 앉은 페어 프로그래밍 파트너가 직접 키보드를 잡고 코딩하는 것과 비슷하달까요.

기존 AI 코딩 도구와 뭐가 다른가요?

솔직히 말하면, AI 코딩 도구 시장은 이미 꽤 포화 상태예요. 그런데 Claude Code가 차별화되는 지점이 몇 가지 있어요.

첫째, CLI 기반이라 어떤 에디터와도 독립적이에요. VS Code를 쓰든, Neovim을 쓰든, 심지어 서버에 SSH로 접속해서도 쓸 수 있어요. IDE에 종속되지 않는다는 건 꽤 큰 장점이에요. 특히 DevOps 엔지니어나 서버 관리 업무가 많은 분들에게는 더 자연스러운 워크플로우가 될 수 있죠.

둘째, 에이전트 모드가 기본이에요. Copilot이나 Cursor도 에이전트 모드를 지원하지만, Claude Code는 처음부터 에이전트로 설계됐어요. 이게 뭐냐면, 한 번의 요청으로 여러 파일을 동시에 수정하고, 중간에 테스트를 돌려보고, 실패하면 다시 고치는 과정을 자동으로 반복할 수 있다는 뜻이에요. 사람이 중간중간 확인하고 승인하는 구조이긴 하지만, 큰 작업을 한 번에 맡길 수 있다는 점이 매력적이에요.

셋째, CLAUDE.md라는 프로젝트 설정 파일을 통해 프로젝트별 컨텍스트를 줄 수 있어요. "우리 프로젝트는 이런 코딩 컨벤션을 쓰고, 테스트는 이렇게 돌리고, 배포는 이런 절차야"라고 적어두면 Claude Code가 그걸 참고해서 작업해요. 팀 전체가 공유하는 일종의 AI용 온보딩 문서인 셈이죠.

반면 Cursor나 Windsurf 같은 도구들은 IDE와 깊게 통합되어 있어서, 코드 자동완성이나 인라인 편집 같은 경험이 더 매끄러운 편이에요. 결국 "터미널 중심의 에이전트형 워크플로우"를 원하면 Claude Code, "IDE 안에서 자연스럽게 녹아드는 경험"을 원하면 Cursor/Windsurf라는 선택지가 되는 거예요.

한국 개발자에게 주는 시사점

이런 인터랙티브 튜토리얼이 만들어졌다는 것 자체가 시사하는 바가 있어요. AI 코딩 도구가 이제 "써볼까 말까" 단계를 넘어서 "어떻게 잘 쓸 것인가"가 중요한 시대가 됐다는 뜻이거든요.

실무에서 당장 시도해볼 만한 건, 반복적인 작업에 Claude Code를 투입해보는 거예요. 예를 들어 API 엔드포인트를 하나 추가할 때 라우터, 컨트롤러, 서비스, 테스트 파일을 한꺼번에 생성하는 작업이라든지, 기존 JavaScript 코드를 TypeScript로 마이그레이션하는 작업 같은 거요. 이런 "패턴이 명확하지만 손이 많이 가는 작업"에서 AI 에이전트의 효과가 가장 크거든요.

다만 주의할 점도 있어요. Claude Code는 Anthropic API를 직접 호출하기 때문에 사용량에 따라 비용이 발생해요. 무료가 아니라는 점을 미리 알아두시고, 처음에는 작은 프로젝트로 감을 잡아보는 걸 추천드려요.