Claude Code 시작하기

Claude Code는 Anthropic이 만든 터미널 기반 에이전틱(agentic) 코딩 도구입니다. 단순히 코드를 한 조각 생성해 주는 자동완성과 달리, 프로젝트 전체를 직접 읽고 파일을 수정하고 명령을 실행하면서 하나의 작업을 끝까지 수행합니다.

학습 목표

• 에이전틱 코딩 도구가 기존 자동완성과 어떻게 다른지 이해한다.
• Claude Code가 어떤 흐름으로 작업을 처리하는지 안다.
• 어떤 작업에 적합하고 어떤 점을 주의해야 하는지 파악한다.

자동완성과 무엇이 다른가

기존 AI 코딩 보조 도구는 대부분 "지금 커서 위치에 들어갈 코드"를 제안합니다. 반면 Claude Code는 작업을 목표 단위로 받습니다.

• "로그인 폼에 이메일 검증을 추가해줘"
• "이 테스트가 왜 실패하는지 찾아서 고쳐줘"
• "이 함수를 작은 단위로 리팩터링해줘"

이런 지시를 받으면 Claude Code는 스스로 관련 파일을 검색하고, 읽고, 수정하고, 필요하면 테스트를 실행해 결과를 확인합니다.

동작 흐름

대략 다음과 같은 루프로 동작합니다.

1. 사용자의 요청을 이해한다.
2. 코드베이스를 탐색해 관련 파일을 찾아 읽는다.
3. 계획을 세우고 파일을 편집하거나 명령을 실행한다.
4. 결과(테스트·빌드·실행 출력)를 확인하고 필요하면 다시 수정한다.
5. 작업이 끝나면 무엇을 했는지 요약한다.

요청 → 탐색 → 편집/실행 → 검증 → (반복) → 요약

어디에 강한가

• 여러 파일에 걸친 변경, 리팩터링
• 버그 재현과 원인 추적
• 낯선 코드베이스 파악과 설명
• 반복적인 마이그레이션 작업
• 테스트 작성과 실행

주의할 점

에이전트는 강력하지만 만능이 아닙니다. 파일을 직접 수정하고 명령을 실행하기 때문에, 무엇을 했는지 항상 확인하는 습관이 중요합니다. 특히 git으로 변경 사항을 추적하면 잘못된 수정을 쉽게 되돌릴 수 있습니다.

요약

Claude Code는 코드 한 줄을 제안하는 도구가 아니라, 목표를 받아 탐색·편집·실행·검증을 스스로 수행하는 에이전트입니다. 강력한 만큼 변경 내용을 검토하고 git으로 관리하는 습관이 함께 필요합니다.