AI가 코드를 대신 써주는 시대,
에이전틱 코딩의 핵심을 이해합시다In the age of AI-written code,
let's understand the core of agentic coding
한 줄 요약: 터미널에서 동작하는 AI 에이전틱 코딩 도구입니다.In one sentence: an AI agentic coding tool that runs in your terminal.
여러분 옆에 머리가 아주 좋은 인턴 개발자가 한 명 앉아 있다고 상상해보세요.
이 인턴은 보통 인턴이 아닙니다:
📖 여러분의 프로젝트 코드를 전부 읽고 이해합니다
🧠 무엇을 고쳐야 하는지 스스로 파악합니다
✏️ 직접 코드를 수정하고 새로 작성합니다
✅ 수정한 코드가 잘 동작하는지 테스트까지 합니다
📦 완료되면 Git 커밋과 PR까지 만들어줍니다
Claude Code가 바로 이 인턴입니다. 단, 24시간 일하고 월급이 필요 없죠.
Imagine a very talented intern developer sitting right next to you.
This isn't an ordinary intern:
📖 Reads and understands all your project code
🧠 Figures out what needs to be fixed on their own
✏️ Directly modifies and writes new code
✅ Tests to make sure the changes work
📦 Even creates Git commits and PRs when done
Claude Code is exactly this intern — except it works 24 hours and needs no salary.
VS Code 같은 에디터가 아니라, 터미널(명령줄)에서 동작합니다. claude 한 마디면 시작됩니다. 기존 개발 환경을 바꿀 필요가 없어요.
It works in the terminal (command line), not in an editor like VS Code. Just type claude and you're ready to go. No need to change your existing development environment.
기존 AI 코딩 도구처럼 한 줄씩 제안하는 게 아닙니다. "이 버그 고쳐줘"라고 말하면, 스스로 파일을 찾고, 읽고, 수정하고, 테스트까지 합니다. 사람처럼 자율적으로 일합니다.
Unlike traditional AI coding tools that suggest one line at a time, telling it "fix this bug" makes it autonomously find files, read them, modify them, and run tests. It works independently like a human.
Claude를 만든 Anthropic이 직접 개발한 공식 제품입니다. Claude의 능력을 100% 활용하도록 최적화되어 있어, 서드파티 도구와는 차원이 다릅니다.
An official product developed directly by Anthropic, the creators of Claude. Optimized to use 100% of Claude's capabilities, making it a cut above third-party tools.
GitHub Copilot, Cursor, Windsurf와 비교하면 접근 방식 자체가 다릅니다.Compared to GitHub Copilot, Cursor, and Windsurf, the entire approach is different.
| 비교 항목Feature | Claude Code | GitHub Copilot | Cursor / Windsurf |
|---|---|---|---|
| 작동 방식How it works | 터미널에서 자연어로 대화하며 자율적으로 코드 작업 수행Conversational natural language in the terminal; autonomously performs code tasks | 에디터에서 코드 작성 중 자동 완성 제안Autocomplete suggestions while writing code in the editor | AI 기능이 내장된 전용 코드 에디터Dedicated code editor with built-in AI features |
| 파일 접근File Access | 프로젝트 전체 파일을 자유롭게 읽고, 수정하고, 생성 가능Freely reads, modifies, and creates files across the entire project | 현재 열린 파일 + 주변 컨텍스트 중심Focused on the currently open file and surrounding context | 프로젝트 인덱싱 후 참조 가능Can reference files after project indexing |
| 자율성Autonomy | 높음High — 여러 파일을 오가며 스스로 계획하고 실행Plans and executes across multiple files independently | 낮음Low — 사용자가 타이핑할 때 한 줄씩 제안Suggests one line at a time as you type | 중간Medium — 채팅으로 지시하면 코드 수정 제안Suggests code changes when instructed via chat |
| 가격Price | Claude Pro($20/월) 또는 API 사용량 기반Claude Pro ($20/mo) or API usage-based | $10/월 (Individual) / $19/월 (Business) | 무료 플랜 있음 / Pro $20/월Free plan available / Pro $20/mo |
| 장점Strengths | 복잡한 멀티파일 작업, 리팩토링, 자동화에 압도적Overwhelmingly strong for complex multi-file tasks, refactoring, and automation | 타이핑 속도 향상, 즉각적인 코드 완성Faster typing speed, instant code completion | 직관적인 UI, 에디터와 AI의 자연스러운 통합Intuitive UI, seamless integration of editor and AI |
AI와 개발자가 협업하는 방식은 계속 진화하고 있습니다. 여러분은 지금 어디에 있고, 어디로 가야 할까요? The way AI and developers collaborate is constantly evolving. Where are you now, and where should you be heading?
| 단계Stage | 이름Name | 사람의 역할Human's Role | 대표 도구Representative Tool |
|---|---|---|---|
| 1 | Human Outside the LoopHuman Outside the Loop | "뭘 만들지"만 말하고 결과만 확인 (Vibe Coding)Only says "what to build" and checks the result (Vibe Coding) | ChatGPT, claude.ai 웹ChatGPT, claude.ai web |
| 2 | Human In the LoopHuman In the Loop | AI가 만든 코드를 한 줄씩 확인하고 직접 수정Reviews AI-generated code line by line and edits directly | Copilot, Cursor |
| 3 | Human On the LoopHuman On the Loop | 가이드(하네스)를 설계하고 AI에게 자율 작업 위임. 결과가 안 맞으면 코드가 아닌 하네스를 개선Designs guides (harness) and delegates autonomous work to AI. If results are wrong, improves the harness, not the code | Claude Code |
| 4 | Agent FlywheelAgent Flywheel | AI가 테스트와 실패를 통해 스스로 하네스를 보강하며 진화AI reinforces its own harness through testing and failure, evolving autonomously | (연구 단계)(Research stage) |
참고: Terry Cho — AI 코딩의 발전단계 · Martin Fowler — Humans and Agents Reference: Terry Cho — AI Coding Stages · Martin Fowler — Humans and Agents
Claude Code는 개발 워크플로우의 거의 모든 단계를 도울 수 있습니다. 대표적인 사용 사례 6가지를 소개합니다.Claude Code can assist with almost every stage of the development workflow. Here are 6 representative use cases.
"로그인 페이지 만들어줘", "REST API 엔드포인트 추가해줘"처럼 자연어로 말하면 전체 코드를 처음부터 작성합니다. 파일 생성, 의존성 설치까지 자동으로 처리합니다.
Say "create a login page" or "add a REST API endpoint" in natural language and it writes the entire code from scratch. File creation and dependency installation are handled automatically.
"이 에러 고쳐줘"라고 에러 메시지를 보여주면, 관련 코드를 찾아가서 원인을 분석하고 수정합니다. 로그를 읽고, 스택 트레이스를 추적하고, 테스트로 검증까지 합니다.
Show it an error message saying "fix this error" and it navigates to the relevant code, analyzes the cause, and fixes it. It reads logs, traces stack traces, and validates with tests.
"이 함수를 깔끔하게 정리해줘", "중복 코드 제거해줘"라고 하면 코드 구조를 개선합니다. 여러 파일에 걸친 대규모 리팩토링도 자율적으로 처리합니다.
Say "clean up this function" or "remove duplicate code" and it improves the code structure. Large-scale refactoring spanning multiple files is handled autonomously.
"이 모듈에 테스트 추가해줘"라고 하면 기존 코드를 분석하고 적절한 단위 테스트, 통합 테스트를 작성합니다. 엣지 케이스까지 고려한 테스트를 만들어줍니다.
Say "add tests to this module" and it analyzes the existing code and writes appropriate unit and integration tests. It creates tests that even cover edge cases.
코드에 주석을 추가하거나, README를 작성하거나, API 문서를 자동 생성합니다. 코드를 읽고 이해한 뒤 명확하고 정확한 문서를 만들어줍니다.
Adds comments to code, writes READMEs, or auto-generates API documentation. It reads and understands the code before creating clear, accurate documentation.
변경 사항을 분석해서 커밋 메시지를 작성하고, PR 설명을 자동 생성합니다. 코드 리뷰 코멘트에 응답하고 수정 사항을 반영하는 것까지 가능합니다.
Analyzes changes and writes commit messages, auto-generates PR descriptions. It can even respond to code review comments and apply the requested changes.
Claude Code는 세 가지 단계가 서로 뒤섞인 에이전트 루프로 동작합니다. 작업이 완료될 때까지 이 루프를 반복하며, 사용자는 언제든지 중단할 수 있습니다.Claude Code operates on an agent loop with three interleaved stages. It repeats this loop until the task is complete, and you can stop it at any time.
사용자의 요청을 받으면, 먼저 프로젝트의 파일 구조와 관련 코드를 탐색합니다. Glob, Grep, Read 같은 도구를 활용해 필요한 파일을 찾아 읽고, 코드 전체의 관계와 맥락을 파악합니다.
Upon receiving your request, it first explores the project's file structure and relevant code. Using tools like Glob, Grep, and Read, it finds and reads the necessary files, grasping the relationships and context of the entire codebase.
Edit, Write, Bash 도구를 사용해 실제로 파일을 수정하거나 새로 만들고, 터미널 명령어를 실행해 패키지를 설치하거나 서버를 시작하거나 빌드를 수행합니다.
Using Edit, Write, and Bash tools, it actually modifies or creates files and runs terminal commands to install packages, start servers, or run builds.
수정한 코드가 의도대로 동작하는지 확인합니다. 테스트를 실행하고, 빌드가 성공하는지 체크하고, 린터 오류가 없는지 검증합니다. 문제가 발견되면 다시 1단계로 돌아가 루프를 반복합니다.
It verifies that the modified code works as intended. It runs tests, checks that the build succeeds, and validates that there are no linter errors. If problems are found, it goes back to step 1 and repeats the loop.
Esc 키를 누르면 즉시 작업을 중단할 수 있습니다. Claude Code는 파일을 편집하기 전에 스냅샷(체크포인트)을 찍기 때문에, Esc를 두 번 누르면 이전 상태로 되돌릴 수 있습니다. Git과 별개로 작동하는 파일 수준의 실행 취소 기능입니다.Esc while the agent loop is running to immediately stop the task. Because Claude Code takes a snapshot (checkpoint) before editing files, pressing Esc twice lets you revert to the previous state. This is a file-level undo that works independently of Git.Claude Code가 에이전트 루프에서 사용하는 도구는 5가지 카테고리로 나뉩니다.The tools Claude Code uses in the agent loop fall into 5 categories.
| 카테고리Category | 할 수 있는 일What it can do |
|---|---|
| 📄 파일 작업File Ops | 파일 읽기, 편집, 새로 만들기, 이름 바꾸기Read, edit, create, and rename files |
| 🔍 검색Search | 패턴으로 파일 찾기, 정규표현식으로 코드 검색Find files by pattern, search code with regex |
| ⚡ 실행Execute | 셸 명령어 실행, 서버 시작, 테스트 실행, git 사용Run shell commands, start servers, run tests, use git |
| 🌐 웹Web | 웹 검색, 공식 문서 가져오기, 에러 메시지 조회Web search, fetch official docs, look up error messages |
| 🧠 코드 인텔리전스Code Intelligence | 편집 후 타입 에러 확인, 정의 위치로 이동 (플러그인 필요)Check type errors after editing, jump to definition (plugin required) |
Shift+Tab을 눌러 세 가지 모드를 순환할 수 있습니다.Press Shift+Tab to cycle through three modes.
파일 편집 및 셸 명령어 실행 전에 항상 사용자에게 확인을 요청합니다. 처음 사용하거나 중요한 작업을 할 때 권장됩니다.
Always asks for confirmation before editing files or running shell commands. Recommended for first-time users or critical tasks.
파일 편집은 자동으로 허용하되, 셸 명령어 실행 전에는 여전히 확인을 요청합니다. 빠른 반복 작업에 적합합니다.
File edits are accepted automatically, but still asks before running shell commands. Suitable for fast iteration work.
읽기 전용 도구만 사용합니다. 파일을 수정하지 않고 분석과 계획만 수립해 사용자의 승인을 받은 뒤 실행합니다.
Uses only read-only tools. Creates an analysis and plan without modifying files, then executes after user approval.
새 세션을 시작하면 컨텍스트 윈도우가 초기화됩니다. 이전 세션을 이어가거나 분기할 수 있습니다.Starting a new session resets the context window. You can resume or fork a previous session.
Claude Code는 터미널에서만 쓰는 도구가 아닙니다. 다양한 환경에서 같은 AI 에이전트를 활용할 수 있습니다.Claude Code isn't just a terminal tool. You can use the same AI agent across a variety of environments.
가장 기본적인 사용 방식입니다. claude 명령어 하나로 시작하며 전체 기능을 사용할 수 있습니다. 기존 개발 환경을 바꿀 필요가 없습니다.
The most fundamental way to use it. Start with a single claude command and access all features. No need to change your existing development environment.
IDE 익스텐션으로 설치합니다. 에디터 안에서 바로 Claude Code를 사용하고, 변경 사항을 인라인 diff로 확인할 수 있습니다.
Install as an IDE extension. Use Claude Code directly inside the editor and view changes as inline diffs.
IntelliJ, PyCharm, WebStorm 등 JetBrains IDE에서 플러그인으로 사용할 수 있습니다.
Available as a plugin for JetBrains IDEs including IntelliJ, PyCharm, and WebStorm.
독립 실행형 데스크톱 앱으로 터미널 없이도 실행할 수 있습니다. 시각적인 diff 뷰를 제공합니다.
A standalone desktop app that runs without a terminal. Provides a visual diff view.
claude.ai/code에서 설치 없이 바로 사용합니다. 환경 설정 없이 빠르게 시작하고 싶을 때 적합합니다.
Use instantly at claude.ai/code without any installation. Perfect when you want to get started quickly without any setup.
로컬 세션을 폰이나 브라우저에서 원격으로 제어할 수 있습니다. PC를 떠나서도 작업을 모니터링하거나 지시할 수 있습니다.
Remotely control a local session from your phone or browser. Monitor or direct work even when away from your PC.
Slack 채널에서 @Claude를 멘션해 팀 워크플로우에 Claude Code를 직접 통합합니다.
Mention @Claude in Slack channels to integrate Claude Code directly into your team workflow.
GitHub Actions 및 GitLab CI/CD에서 Claude Code를 실행해 자동 코드 리뷰, PR 피드백, 테스트 생성을 자동화합니다.
Run Claude Code in GitHub Actions and GitLab CI/CD to automate code reviews, PR feedback, and test generation.
Claude Code는 빠르게 진화하고 있습니다. 주요 마일스톤을 살펴봅니다.Claude Code is evolving rapidly. Let's look at the key milestones.
2025년 2월, Claude Code가 처음 세상에 공개되었습니다. 리서치 프리뷰 단계로, 초기 사용자들의 피드백을 수집하며 빠르게 개선이 시작되었습니다.
In February 2025, Claude Code was first unveiled to the world. In the research preview stage, rapid improvements began with feedback collected from early users.
2025년 5월, 정식 버전으로 전환되었습니다. Claude Pro/Max 구독자와 API 사용자 모두 이용 가능해졌으며, 안정성과 성능이 크게 향상되었습니다.
In May 2025, it transitioned to a generally available version. Both Claude Pro/Max subscribers and API users gained access, with significantly improved stability and performance.
2025년 8월, Hooks가 추가되었습니다. Claude Code의 동작 전후에 사용자 정의 스크립트를 실행할 수 있게 되어, 자동화와 커스터마이징의 가능성이 열렸습니다.
In August 2025, Hooks were added. The ability to run custom scripts before and after Claude Code's actions opened up new possibilities for automation and customization.
2025년 11월, 에이전트와 서브에이전트 기능이 도입되었습니다. Claude Code가 복잡한 작업을 여러 하위 작업으로 분할하고 병렬로 처리할 수 있게 되어, 대규모 코드베이스에서의 작업 효율이 비약적으로 향상되었습니다.
In November 2025, agent and sub-agent capabilities were introduced. Claude Code gained the ability to split complex tasks into multiple sub-tasks and process them in parallel, dramatically improving efficiency on large codebases.
2026년 1월, Skills가 도입되었습니다. Claude에게 재사용 가능한 전문 매뉴얼(SKILL.md)을 제공할 수 있게 되어, 팀별 워크플로우를 표준화하고 결과물의 일관성을 확보할 수 있게 되었습니다.
In January 2026, Skills were introduced. The ability to provide Claude with reusable specialized manuals (SKILL.md) enabled teams to standardize workflows and ensure consistency in outputs.
2026년 2월, 컨텍스트 윈도우가 100만 토큰으로 확장되었습니다. 이제 대규모 코드베이스(약 75,000줄)를 한 번에 이해하고 처리할 수 있게 되어, 엔터프라이즈급 프로젝트에서도 효과적으로 활용할 수 있게 되었습니다.
In February 2026, the context window expanded to 1 million tokens. Now capable of understanding and processing large codebases (~75,000 lines) in one pass, making it effective even for enterprise-scale projects.
Claude Code를 처음 접하는 분들이 가장 많이 궁금해하는 것들The most common questions from those new to Claude Code
Esc 키를 두 번 눌러 즉시 이전 상태로 되돌릴 수 있습니다. 이는 Git과 별개로 작동하는 파일 수준의 실행 취소 기능입니다.Shift+Tab으로 권한 모드를 조절해 안전성과 속도의 균형을 맞출 수 있습니다.Esc twice immediately reverts to the previous state. This is a file-level undo that operates independently of Git.Shift+Tab to adjust the permission mode and balance safety with speed.
Claude Code = 에이전트 루프로 동작하는 AI 코딩 도구
핵심 차별점 = 수집 → 수행 → 검증 사이클을 자율 반복
사용 범위 = 터미널, IDE, 웹, Slack, CI/CD 등 다양한 플랫폼
최적 활용 = 복잡한 멀티파일 작업 & 팀 자동화
다음 챕터에서는 Claude Code를 직접 설치하고 첫 명령을 실행해봅시다!
Claude Code = AI coding tool powered by an agent loop
Key differentiator = Autonomously repeats Gather → Execute → Verify cycle
Scope = Terminal, IDE, Web, Slack, CI/CD and more
Best for = Complex multi-file tasks & team automation
In the next chapter, let's install Claude Code and run our first command!