개념한 마디로
답을 알려주는 조수가 아니라, 직접 일하는 신입 개발자
웹·앱의 채팅형 AI가 "이렇게 고치세요"라고 알려주는 조수라면, Claude Code는 내 컴퓨터 터미널에서 파일을 직접 열어 고치고, 테스트를 돌리고, git 커밋까지 하는 신입 개발자다. 나는 지시하고 검토하고, 실제 손은 Claude가 쓴다.
이 페이지를 한 문장으로Claude Code는 코드를 읽고 → 고치고 → 실행·검증하는 일을 목표를 이룰 때까지 스스로 반복하는 터미널 AI 에이전트다.
비교채팅 AI vs Claude Code
무엇이 다른가
| 구분 | 채팅형 AI (웹/앱) | Claude Code |
|---|---|---|
| 일하는 곳 | 브라우저·앱 창 | 내 PC의 터미널(내 프로젝트 폴더 안) |
| 파일 | 내가 복사·붙여넣기 해줘야 봄 | 폴더의 파일을 직접 읽고 수정 |
| 명령 실행 | 못 함 (설명만) | 테스트·빌드·git을 직접 실행 |
| 반복 | 사람이 결과를 보고 다시 요청 | 실패하면 스스로 다시 시도 |
| 내 역할 | 질문하고 답을 받아 적용 | 지시하고 결과를 검토·승인 |
그래서레거시·업무 파일이 이미 내 PC에 있는 사람에게 특히 강력하다. "이 폴더 분석해줘"라고만 하면 되니까.
동작 원리에이전트 루프
Claude는 이 3단계를 반복한다
Claude Code의 핵심은 에이전트 루프(agentic loop)다. 한 번 답하고 끝나는 게 아니라, 아래 세 단계를 목표를 이룰 때까지 스스로 돈다.
1
맥락 파악 — Gather
관련 파일을 읽고, 검색하고, 문제를 이해한다.
2
실행 — Act
파일을 수정하고, 명령(테스트·git 등)을 돌린다.
3
검증 — Verify
테스트 결과·에러 메시지를 확인한다. 실패면 1번으로 돌아간다.
목표를 이룰 때까지 1 → 2 → 3 반복 (수십 개의 동작을 스스로 연결)
내가 쥔 핸들루프 도중 언제든 Esc로 멈추고 방향을 바꿀 수 있다. 대화 기록은 지워지지 않으니 "그거 말고 이렇게"라고 이어서 지시하면 된다.
능력Claude가 쓰는 도구
무엇을 할 수 있나
Files
파일 다루기
읽기·수정·생성·이름변경
+
Search
검색
패턴·정규식으로 코드 탐색
+
Run
실행
셸 명령·테스트·git 실행
+
Web
웹
웹 검색·문서 가져오기
이 도구들을 스스로 골라 루프를 돌린다. "테스트가 깨졌어, 고쳐줘" 한마디면 → 파일 검색 → 원인 파악 → 수정 → 테스트 재실행까지 알아서 이어간다.
어디서실행 환경
이 강의는 Windows 터미널 기준
Claude Code는 터미널, VS Code·JetBrains 확장, 데스크톱 앱 등 여러 곳에서 쓸 수 있다. 이 문서는 가장 기본이 되는 Windows 터미널(PowerShell)을 기준으로, 설치부터 첫 대화까지 그대로 따라 할 수 있게 정리한다.
다음바로 옆 메뉴 공식 문서 → 02 설치 & 로그인 (Windows)에서 명령어 한 줄로 설치를 시작한다. ▸ 설치하러 가기
클로드코드 시작하기공식 문서 · 01 Claude Code란?