클로드 코드
더 많은 작업
- Claude Code; 클로드 코드
- 앤트로픽이 만든 에이전트형 코딩 도구. 터미널에서 코드베이스를 읽고 파일을 고치고 명령을 실행한다
클로드 코드(Claude Code)는 앤트로픽이 만든 에이전트형 코딩 도구다. 사용자가 프로젝트 폴더에서 claude 명령을 실행하고 자연어로 작업을 지시하면, 클로드 모델이 파일을 찾아 읽고, 코드를 고치고, 테스트·빌드·git 같은 셸 명령을 실행하고, 결과를 확인해 다시 고치는 과정을 스스로 반복한다.[1] 2025년 2월 24일 클로드 3.7 소네트와 함께 제한적 연구 미리보기로 공개되었고, 2025년 5월 22일 클로드 4 출시와 함께 정식 출시되었다.[2][3]
편집기 옆 대화창에서 코드 조각을 제안하는 도우미와 달리, 클로드 코드는 처음부터 터미널에서 프로젝트 전체를 다루는 자율 에이전트로 설계되었다. 이후 VS Code·JetBrains 확장, 데스크톱 앱, 웹(클라우드 세션), 모바일, Slack, CI/CD로 넓어졌지만 어느 화면에서든 같은 에이전트 루프가 돈다. 2025~2026년 비개발자까지 쓰는 바이브 코딩 도구로 널리 알려졌다.
공식 문서는 작업을 맥락 수집, 행동, 결과 검증의 세 단계가 섞여 반복되는 루프로 설명한다. "실패하는 테스트를 고쳐 줘"라고 하면 테스트를 돌려 실패 내용을 읽고, 관련 소스 파일을 찾아 읽고, 고친 뒤, 테스트를 다시 돌려 확인하는 식이다. 사용자는 언제든 끼어들어 방향을 바꿀 수 있다. 모델이 추론을 맡고, 클로드 코드는 모델에 도구를 제공하고 모델이 보는 맥락을 관리하는 바깥 층, 즉 에이전트 하네스(agentic harness)다.[1]
| 분류 | 하는 일 |
|---|---|
| 파일 조작 | 파일 읽기, 코드 편집, 새 파일 만들기, 이름 바꾸기 |
| 검색 | 패턴으로 파일 찾기, 정규식으로 내용 검색 |
| 실행 | 셸 명령 실행, 서버 시작, 테스트 실행, git 사용 |
| 웹 | 웹 검색, 문서 가져오기 |
| 코드 인텔리전스 | 언어 서버로 정의·참조 탐색, 편집 뒤 타입 오류 확인(플러그인 필요) |
이 밖에 하위 에이전트 생성, 사용자에게 질문하기 같은 조율용 도구가 있다.[1]
- 세션 대화, 읽은 파일 내용, 명령 출력, CLAUDE.md, 불러온 스킬이 모두 컨텍스트 윈도우를 채운다. 한도에 가까워지면 오래된 도구 출력부터 지우고, 그래도 부족하면 대화를 요약(compaction)한다. 수동으로는 /compact를 쓴다.
- 세션 기록은 로컬에 JSONL 파일로 저장되어 이어 하기(--continue, --resume)와 갈라 하기(fork)가 가능하다.
- 파일을 고치기 전 내용을 스냅숏으로 저장하는 체크포인트가 있어, Esc를 두 번 누르거나 /rewind로 이전 상태로 되돌린다. 데이터베이스 변경이나 배포처럼 외부 시스템에 미친 효과는 되돌릴 수 없다.[1]
클로드 코드는 기본 루프 위에 여러 확장 장치를 얹는 구조다.[4]
| 장치 | 역할 | 예 |
|---|---|---|
| CLAUDE.md | 매 세션 시작 시 읽히는 지침 파일. 관리 정책(조직), 사용자(~/.claude/CLAUDE.md), 프로젝트(./CLAUDE.md), 로컬(CLAUDE.local.md) 단계가 있고 @경로로 다른 파일을 불러올 수 있다 | "npm 대신 pnpm을 쓴다. 커밋 전 테스트를 돌린다" |
| 자동 메모리 | 작업 중 클로드가 스스로 배운 내용(사용자 선호, 교정 사항)을 저장하고 다음 세션에 불러온다 | MEMORY.md |
| 슬래시 명령 | /로 시작하는 세션 제어 명령. /init(CLAUDE.md 초안 생성), /compact, /model, /context, /rewind, /doctor 등 | |
| 스킬 | SKILL.md에 적은 지침·절차·참고 자료. 설명만 먼저 읽히고 본문은 쓸 때만 불러온다. 사용자가 /이름으로 부르거나 클로드가 상황에 맞춰 스스로 쓴다 | 배포 체크리스트, API 문서 |
| 하위 에이전트 | 별도 컨텍스트 창과 시스템 프롬프트, 허용 도구를 가진 보조 에이전트. 탐색처럼 출력이 많은 일을 맡고 요약만 돌려준다 | 코드베이스 조사 전담, 리뷰 전담 |
| 훅 | 특정 사건(도구 사용 전후, 프롬프트 제출, 세션 시작·종료 등)에 자동 실행되는 셸 명령·HTTP 요청 등. 도구 호출을 막을 수도 있다 | 파일을 고칠 때마다 린터 실행 |
| MCP | 외부 도구·데이터 연결 표준. 도구 정의는 필요할 때만 불러온다 | 데이터베이스 조회, Slack 게시 |
| 플러그인 | 위 장치(스킬, 하위 에이전트, 훅, MCP 서버)를 묶어 배포하는 꾸러미와 마켓플레이스 |
예전에 .claude/commands/에 두던 사용자 정의 슬래시 명령은 스킬로 합쳐졌다. 스킬은 여러 AI 도구가 함께 쓰는 공개 규격(Agent Skills)을 따른다.[5] 훅은 2025년 6월, 사용자 정의 하위 에이전트는 2025년 7월, 플러그인은 2025년 10월 9일, 스킬은 2025년 10월 16일에 도입되었다.[6]
| 사건 | 시점 |
|---|---|
| SessionStart / SessionEnd | 세션 시작·재개 / 종료 |
| UserPromptSubmit | 사용자 프롬프트를 모델이 처리하기 전 |
| PreToolUse | 도구 호출 직전. 호출을 막을 수 있다 |
| PermissionRequest | 도구 호출에 권한 판단이 필요할 때 |
| PostToolUse | 도구 호출 성공 뒤 |
| SubagentStart / SubagentStop | 하위 에이전트 생성·종료 |
| PreCompact / PostCompact | 맥락 요약 전후 |
| Stop | 클로드가 응답을 마쳤을 때 |
전체 목록은 공식 문서에 있다.[7]
클로드 코드는 사용자 컴퓨터에서 명령을 실행하므로 무엇을 묻지 않고 해도 되는지를 권한 모드로 정한다. Shift+Tab으로 모드를 바꾼다.[8]
| 모드 | 묻지 않고 하는 일 | 용도 |
|---|---|---|
| Manual(설정값 default) | 읽기만 | 모든 행동을 직접 검토 |
| acceptEdits | 읽기, 파일 편집, mkdir·mv 같은 흔한 파일 명령 | 검토하며 반복 수정 |
| plan | 읽기(자동 모드가 가능하면 분류기가 승인한 명령 포함). 소스를 고치지 않고 계획만 제안 | 변경 전 탐색 |
| auto | 대부분. 별도 분류기 모델이 행동을 뒤에서 검사해 위험한 것을 막는다 | 긴 작업, 승인 피로 줄이기 |
| dontAsk | 미리 허용한 도구와 작업 폴더 안 읽기만. 나머지는 거부 | CI, 스크립트 |
| bypassPermissions | 전부 | 격리된 컨테이너·VM 전용 |
- 모드 위에 settings.json의 허용·확인·거부 규칙을 얹는다. 예를 들어 Bash(npm test)는 묻지 않게, Bash(git push *)는 늘 묻게 할 수 있다. 거부 규칙은 bypassPermissions에서도 적용된다.[8]
- 2025년 10월 맥과 리눅스에서 Bash 도구용 샌드박스(파일 시스템·네트워크 격리)가 도입되었다.[6]
- 저장소 안의 문서나 웹 페이지에 숨긴 지시를 따르게 만드는 간접 프롬프트 인젝션은 이런 도구에 공통된 위험이며, 권한 모드와 샌드박스는 그 피해 범위를 줄이는 장치다.
| 환경 | 내용 |
|---|---|
| 터미널(CLI) | 기본 형태. 맥, 리눅스, 윈도우(2025년 7월 기본 지원) 설치 스크립트, 홈브루, WinGet으로 설치 |
| IDE | 2025년 5월 VS Code·JetBrains 베타 통합, 2025년 9월 29일 VS Code 전용 확장 출시. 제안 편집을 파일 안에 diff로 보여 준다[9] |
| 웹(클라우드 세션) | 2025년 10월 20일 연구 미리보기로 시작. 깃허브 저장소를 연결하면 앤트로픽이 관리하는 클라우드 VM에서 작업하고 풀 리퀘스트를 만든다. 2026년 9월 정식 제공[10] |
| 데스크톱 앱 | 클로드 데스크톱 앱의 Code 탭. 여러 세션을 git 워크트리로 격리해 병렬로 돌린다 |
| 모바일, Slack | 휴대전화나 Slack에서 작업을 맡기고 진행 상황을 본다 |
| CI/CD | GitHub Actions, GitLab CI/CD에서 @claude 멘션이나 이슈로 작업 실행 |
CLI는 타입스크립트로 작성되었고 npm 패키지로도 배포되었다. 대부분의 환경에서 클로드 유료 구독(Pro, Max, Team, Enterprise)이나 앤트로픽 API 계정이 필요하고, 아마존 베드록, 구글 클라우드, 마이크로소프트 파운드리를 통해서도 쓸 수 있다.[11]
클로드 코드의 에이전트 루프, 도구, 맥락 관리를 다른 프로그램에서 쓸 수 있게 한 것이 SDK다. 2025년 5월 정식 출시 때 클로드 코드 SDK로 나왔고, 2025년 9월 29일 코딩 외의 에이전트에도 쓰인다는 뜻에서 클로드 에이전트 SDK(Claude Agent SDK)로 이름을 바꿨다.[12] claude -p로 비대화형 실행하는 CLI 방식과 파이썬·타입스크립트 패키지가 있다.
claude -p "auth.py의 버그를 찾아 고쳐 줘" --allowedTools "Read,Edit,Bash"
AGENTS.md는 여러 AI 코딩 도구가 함께 읽도록 제안된 프로젝트 지침 파일 규약이다. 클로드 코드는 오랫동안 자체 파일인 CLAUDE.md만 읽었고, AGENTS.md를 쓰는 저장소는 CLAUDE.md에서 @AGENTS.md로 불러와야 했다. 2026년 9월 18일 2.1.277판부터 CLAUDE.md가 없는 프로젝트에서는 AGENTS.md를 직접 읽는다. CLAUDE.md(또는 CLAUDE.local.md)가 있으면 기본적으로 그쪽만 읽으며, /config의 설정으로 둘 다 읽게 할 수 있다.[6][13] 같은 규약은 깃허브 코파일럿, 커서도 지원한다.
| 시기 | 사건 |
|---|---|
| 2025년 2월 24일 | 클로드 3.7 소네트와 함께 제한적 연구 미리보기 공개. 앤트로픽은 처음에 사내 개발 생산성 도구로 만들었다고 밝혔다[2] |
| 2025년 5월 22일 | 1.0 정식 출시. 클로드 오푸스 4·소네트 4, VS Code·JetBrains 베타 통합, 클로드 코드 SDK, GitHub Actions 연동[3] |
| 2025년 6~7월 | 훅, 사용자 정의 하위 에이전트, 윈도우 기본 지원 |
| 2025년 8월 | 앤트로픽 위협 보고서: 범죄자가 클로드 코드로 정찰, 자격 증명 수집, 침투, 협박문 작성을 자동화해 의료·응급·정부 기관 등 최소 17개 조직을 협박한 사례 공개[14] |
| 2025년 9월 29일 | 2.0. VS Code 전용 확장, 체크포인트(/rewind), 에이전트 SDK 개명[9] |
| 2025년 10월 | 플러그인, 스킬, Bash 샌드박스, 웹 버전 |
| 2025년 11월 13일 | 앤트로픽이 중국 국가 지원 그룹으로 판단한 공격자가 클로드 코드를 자동화 공격 도구로 조작해 30여 개 기관 침투를 시도하고 일부 성공한 사이버 첩보 활동을 차단했다고 발표. 사람의 개입 없이 대규모로 실행된 첫 사이버 공격 사례라고 평가[15] |
| 2026년 3월 31일 | npm 2.1.88판에 소스 맵 파일이 실수로 포함되어, 타입스크립트 파일 약 2,000개, 51만여 줄의 CLI 소스 코드 전체가 노출. 앤트로픽은 "사람의 실수로 인한 배포 패키징 문제이며 보안 침해가 아니고 고객 데이터나 자격 증명은 노출되지 않았다"고 밝혔다[16] |
| 2026년 9월 | AGENTS.md 직접 지원(2.1.277), 클라우드 세션 정식 제공 |
- ↑ 1.0 1.1 1.2 1.3 Claude Code 문서, How Claude Code works
- ↑ 2.0 2.1 Anthropic, Claude 3.7 Sonnet and Claude Code, 2025-02-24
- ↑ 3.0 3.1 Anthropic, Introducing Claude 4, 2025-05-22
- ↑ Claude Code 문서, Extend Claude Code
- ↑ Claude Code 문서, Extend Claude with skills
- ↑ 6.0 6.1 6.2 Claude Code 문서, Changelog
- ↑ Claude Code 문서, Hooks reference
- ↑ 8.0 8.1 Claude Code 문서, Choose a permission mode
- ↑ 9.0 9.1 Anthropic, Enabling Claude Code to work more autonomously, 2025-09-29
- ↑ Anthropic, Claude Code on the web, 2025-10-20
- ↑ Claude Code 문서, Overview
- ↑ Anthropic, Building agents with the Claude Agent SDK, 2025-09-29
- ↑ Claude Code 문서, How Claude remembers your project
- ↑ Anthropic, Detecting and countering misuse of AI: August 2025, 2025-08-27
- ↑ Anthropic, Disrupting the first reported AI-orchestrated cyber espionage campaign, 2025-11-13
- ↑ Ars Technica, Entire Claude Code CLI source code leaks thanks to exposed map file, 2026-03-31