클로드 코드(Claude Code)는 내 프로젝트의 파일을 직접 읽고 고치고, 명령까지 실행하는 AI 코딩 도구입니다. 공식 도움말은 작문·연구·분석에는 채팅 Claude를, 터미널에서 하는 코딩 작업에는 Claude Code를 쓰라고 나눠 설명합니다.
쓸 수 있는 계정도 다릅니다. 채팅 Claude는 무료 플랜이 있지만 클로드 코드는 무료 플랜에 들어 있지 않습니다. 2026년 10월 21일 Claude Code 공식 한국어 문서와 Claude 고객센터 도움말을 직접 읽고 둘의 차이를 정리했습니다.
1. 클로드 코드란 무엇인가요?
코드를 읽고 고치는 에이전트 코딩 도구입니다. 공식 한국어 개요 문서의 첫 문장은 이렇습니다.
Claude Code는 코드베이스를 읽고, 파일을 편집하고, 명령을 실행하고, 개발 도구와 통합하는 에이전트 코딩 도구입니다.
코드베이스는 프로젝트를 이루는 파일 전체를 말합니다. 에이전트는 시킨 일을 끝내려고 파일 찾기, 고치기, 확인하기 같은 여러 단계를 스스로 이어 가는 방식을 뜻합니다.
문서는 클로드 코드가 전체 코드베이스를 이해하고 여러 파일과 도구에 걸쳐 작업할 수 있다고 적었습니다. 기능 만들기, 버그 고치기, 반복 작업 자동화가 주된 쓰임새입니다.
2. 가장 큰 차이는 일하는 자리입니다
채팅 Claude에서 만든 문서나 화면 같은 결과물(아티팩트)은 대화창 옆에 열리고, 그 자리에서 고칠 수 있습니다. 다른 사람에게 링크로 나누는 기능은 Pro·Max·Team·Enterprise 플랜에서 됩니다. 결과물은 Claude 안에 모입니다.
클로드 코드는 폴더에서 claude를 실행한 순간부터 그 폴더와 하위 폴더의 파일, 터미널에서 할 수 있는 명령, git 상태에 접근합니다. git은 파일 변경 이력을 남기는 버전 관리 도구입니다.
채팅은 대화창 옆에 결과물을 만들어 보여 주고, 클로드 코드는 내 프로젝트 폴더의 파일을 직접 고칩니다. 그래서 「인증 버그를 수정해」라고 하면 관련 파일을 찾아 여러 파일을 함께 고치고 테스트까지 돌립니다.
3. 클로드 코드가 일하는 세 단계
공식 문서는 클로드 코드가 일을 받으면 컨텍스트 수집, 작업 수행, 결과 검증의 세 단계를 거친다고 설명합니다. 쉽게 말해 먼저 살펴보고, 고치고, 제대로 됐는지 확인합니다.
예를 들어 「실패한 테스트를 수정해」라고 하면 테스트를 실행해 무엇이 실패하는지 보고, 오류를 읽고, 관련 파일을 찾아 고친 뒤, 테스트를 다시 돌려 확인합니다.
사람도 이 과정에 끼어들 수 있습니다. 중간에 멈추고 방향을 바꾸라고 하거나 설명을 더해 주면, 클로드 코드는 그 말을 받아 다음 단계를 정합니다.
4. 쓸 수 있는 계정과 사용량 한도
2026년 10월 21일 공식 고급 설정 문서 기준으로 클로드 코드는 Pro, Max, Team, Enterprise 플랜이나 Console 계정이 있어야 씁니다. 문서는 무료 claude.ai 플랜에는 Claude Code 액세스가 포함되지 않는다고 적었습니다.
Pro·Max 플랜이면 따로 사지 않아도 됩니다. 고객센터 도움말은 웹·데스크톱·모바일의 Claude와 터미널의 Claude Code를 하나의 통합 구독으로 쓸 수 있다고 설명합니다.
대신 사용량 한도도 함께 씁니다. 두 도구의 활동이 같은 한도에 포함됩니다. 플랜별 요금과 한도는 클로드 코드 요금제, 무료로 쓸 수 있을까?에 정리했습니다.
5. 터미널이 낯설면 쓰는 곳을 바꿉니다
클로드 코드라고 꼭 검은 명령어 창에서만 쓰는 것은 아닙니다. 공식 문서가 꼽는 쓰는 곳은 터미널, VS Code·JetBrains 같은 편집기 확장, 데스크톱 앱, 웹(claude.ai/code)입니다.
- 데스크톱 앱: 터미널 없이 쓸 수 있고, 앱에 클로드 코드가 들어 있습니다. 유료 구독이 필요합니다
- VS Code·Cursor 확장: 편집기 안에서 바뀐 곳을 보며 씁니다. 터미널과 같은 Claude 계정으로 로그인합니다
- 웹: 내 컴퓨터 설정 없이 브라우저에서 시작합니다
어디서 쓰든 같은 엔진에 연결돼 있어 설정과 CLAUDE.md 파일이 그대로 작동합니다. CLAUDE.md는 프로젝트 규칙을 적어 두면 클로드 코드가 세션마다 읽는 파일입니다.
6. 고치기 전에 묻고, 되돌릴 수 있습니다
내 파일을 직접 고친다는 말이 걱정될 수 있습니다. 공식 문서는 안전장치를 두 가지로 설명합니다. 권한은 클로드 코드가 묻지 않고 할 수 있는 일을 정하고, 체크포인트는 파일 변경을 되돌리게 해 줍니다.
클로드 코드는 바뀔 내용을 보여 주고, 고치기 전에 확인을 요청하면 「Yes」를 골라 승인합니다. 결과가 마음에 들지 않으면 Esc를 두 번 눌러 이전 상태로 돌아갑니다.
다만 데이터베이스나 배포처럼 내 컴퓨터 밖에 영향을 준 작업은 체크포인트로 되돌릴 수 없습니다. 이런 작업은 권한 모드와 권한 규칙으로 다룬다고 문서는 설명합니다.
정리하면 채팅 Claude와 클로드 코드는 이렇게 다릅니다.
- 채팅은 작문·연구·분석, 클로드 코드는 코딩 작업에 맞춰져 있습니다
- 채팅은 대화창 옆에 결과물을 만들고, 클로드 코드는 내 폴더의 파일을 고치고 명령을 실행합니다
- 클로드 코드는 무료 플랜에 없고, Pro·Max에서는 채팅과 한 구독·한 한도로 씁니다
- 고치기 전에 확인을 받고,
Esc두 번으로 되돌릴 수 있습니다
설치부터 활용까지 전체 순서는 클로드 코드 사용방법 총정리에 있습니다. 처음 무엇을 만들어 볼지는 클로드 바이브코딩, 무엇부터 시작할까?를 보세요.
혼자 배울 수 있는 공식 자료는 클로드 코드 강의 글에서 이어집니다.
참고자료 (모두 2026년 10월 21일 확인)
- Claude Code 문서 「개요」 — code.claude.com/docs/ko/overview
- Claude Code 문서 「Claude Code의 작동 방식」 — code.claude.com/docs/ko/how-claude-code-works
- Claude Code 문서 「고급 설정」·「빠른 시작」 — code.claude.com/docs/ko/setup
- Claude 고객센터 「Pro 또는 Max 플랜으로 Claude Code 사용하기」 — support.claude.com/ko/articles/11145838
- Claude Help Center 「What are artifacts and how do I use them?」 — support.claude.com/en/articles/9487310
#클로드코드 #클로드코드란 #ClaudeCode #클로드 #AI코딩도구
