【2026년판】 VSCode에서 Claude Code 활용하기: 도입부터 CLAUDE.md, Plan Mode, Subagent까지

생성형 AI를 이용한 코딩이라고 하면,

• 코드를 붙여넣고 질문하는 것
• 에러를 붙여 원인을 묻는 것
• 함수를 작성해 달라고 하는 것

등의 사용법을 떠올리는 분들이 많으실 겁니다.

하지만, Claude Code는 일반적인 채팅형 AI와는 조금 다릅니다.

Claude Code는 프로젝트 내 파일을 스스로 조사하고, 코드를 수정하며, 터미널 명령어를 실행하고, 테스트 결과를 확인한 후 다시 수정하는 단계까지 수행할 수 있는 'AI 코딩 에이전트'입니다.

게다가 현재 Anthropic 공식 VS Code 확장이 제공되고 있어, 터미널뿐만 아니라,

• VS Code 상에서 Claude와 대화하기
• 선택된 코드에 대해 질문하기
• 파일을 지정하여 수정 요청하기
• 수정 차이점을 VS Code 상에서 확인하기
• 구현 전에 Plan을 검토하기

등의 사용법도 가능합니다.

본문에서는 Claude Code의 설치 방법뿐만 아니라,

VS Code에서 Claude Code를 어떻게 활용해야 실제 개발에 유용한지
그 부분까지 소개하겠습니다.

Claude Code는 Anthropic이 제공하는 에이전트형 개발 도구입니다. 일반적인 AI 채팅에서는

인간
↓
질문
...

와 같은 형태가 되기 쉽습니다.

반면, Claude Code에서는

인간
↓
"이 버그를 고쳐줘"
...

와 같이 일련의 작업을 Claude 스스로 진행할 수 있습니다. 즉,

'코드를 작성해 주는 AI'가 아니라, '개발 작업 자체를 맡기는 AI'
에 가까운 존재입니다.

현재는 Anthropic 공식 VS Code 확장이 제공되고 있습니다. VS Code에서

Ctrl + Shift + X

를 눌러 확장 기능 화면을 열고,

Claude Code

라고 검색합니다.

발행처가

Anthropic

인 공식 확장을 설치해 주세요. 확장 ID는

anthropic.claude-code

입니다.

VS Code는 1.94 이상이 공식 요구 사항이지만, Claude Code 자체도 빈번하게 업데이트되고 있기 때문에 기본적으로 VS Code 역시 최신 버전을 이용하는 것이 권장됩니다.

참고로, VS Code 확장 채팅 화면만 이용한다면, 확장 기능 측에 Claude Code CLI가 포함되어 있습니다. 반면,

claude

을 VS Code의 터미널에서 직접 실행하고 싶다면, 별도로 CLI를 설치해야 합니다.

설치하면 VS Code에 Claude Code 아이콘이 추가됩니다. Claude Code를 열고 나면 기본적으로 일반 채팅과 똑같이 지시할 수 있습니다. 예를 들어,

이 프로젝트의 구성을 조사해 주세요.
사용하고 있는 기술, 주요 디렉토리, 애플리케이션의 시작점을 설명해 주세요.

라고 요청할 수 있습니다. Claude Code는 스스로 프로젝트 내 파일을 찾아 필요한 파일을 읽어 답변합니다. 따라서 매번 소스 코드를 복사해서 붙여넣을 필요가 없습니다.

VS Code 버전 Claude Code에서 상당히 편리한 것이 파일 참조 기능입니다. 예를 들어,

@src/auth/login.ts
이 로그인 처리에서 예외가 발생할 가능성이 있는 부분을 검토해 주세요.

처럼 작성할 수 있습니다. 폴더를 지정하는 것도 가능합니다.

@src/auth/
인증 처리 전체의 흐름을 조사해 주세요.

게다가 VS Code 상에서 코드를 선택하면, 그 선택 범위를 Claude에게 전달할 수도 있습니다. Windows/Linux에서는

Alt + K

를 이용하면

@UserService.java#120-145

처럼 줄 번호가 붙어 참조할 수 있습니다.

이것은 상당히 편리합니다. 예를 들어,

이 조건식이 무엇을 판별하는 것인지 설명해 주세요.

만으로도 현재 선택된 코드를 전제로 답변을 받게 할 수 있습니다.

Claude Code를 사용할 때 개인적으로 가장 중요하다고 생각하는 포인트입니다. 무턱대고,

이 기능을 만들어줘

라고 지시하기보다는,

조사
↓
계획
...

으로 나누는 것이 안정적입니다.

Anthropic의 공식 베스트 프랙티스에서도

Explore → Plan → Implement

이러한 진행 방식이 권장됩니다.

상당히 큰 변경을 할 때는 먼저 Plan Mode를 사용합니다.

예를 들어,

인증 기능에 비밀번호 재설정 기능을 추가하고 싶습니다.
먼저 기존의 인증 처리를 조사해 주세요.
아직 코드는 수정하지 마세요.
...

와 같이 요청합니다.

VS Code 버전에서는 Plan을 Markdown으로 열어 내용을 확인 및 편집한 후에 구현 단계로 넘어갈 수도 있습니다.

여러 파일에 걸친 수정의 경우, 바로 구현시키기보다 훨씬 안전합니다.

Claude Code를 사용한다면 꼭 알아두고 싶은 것이

CLAUDE.md

입니다.

CLAUDE.md에는

Claude가 매번 기억해 주었으면 하는 프로젝트 규칙

을 작성합니다.

예를 들어,

# Project
React + TypeScript 프론트엔드 프로젝트입니다.
# Coding Rules
...

와 같은 내용을 작성합니다.

이것을 프로젝트 루트에 두면 Claude Code가 매번 읽어옵니다.

CLAUDE.md를 처음부터 쓸 필요는 없습니다.

Claude Code에서

/init

을 실행하면, 프로젝트를 분석하여 CLAUDE.md의 초기 초안을 만들어 줍니다.

거기서,

이 프로젝트에서는 임의로 의존 라이브러리를 추가하지 않는다

와 같은, 사람만이 아는 규칙을 추가해 나가는 것이 추천됩니다.

CLAUDE.md가 길다고 좋은 것은 아닙니다.
매번 필요한 규칙만 작성하면 됩니다.

예를 들어,

npm test를 실행한다
Java 17을 사용한다
Controller에서 Repository를 직접 호출하지 않는다
...

React란 무엇인가
Spring Boot란 무엇인가
프로젝트 내 모든 파일에 대한 설명
...

Claude 자신이 코드를 읽으면 알 수 있는 것까지 쓸 필요는 없습니다.

예를 들어,

로그인 처리를 수정해 주세요

만으로는 Claude가 상당히 자유롭게 판단합니다.

추천하는 것은

로그인 후, 세션 만료 시 화면이 하얗게 되는 버그가 있습니다.
src/auth 주변을 조사해 주세요.
먼저 버그를 재현할 테스트를 만들고,
...

와 같이,

• 현상(現象)
• 조사 대상
• 제약 조건
• 완료 조건

까지 전달하는 것입니다.

Claude Code에서,

'어떻게 고칠지'를 세밀하게 명령할 필요는 없습니다.

대신,

'무엇을 충족해야 완성인지'

를 명확히 하면 정확도가 높아집니다.

Claude Code의 강점은 코드를 작성하는 것뿐만 아니라 커맨드도 실행할 수 있다는 것입니다.

그래서,

구현해 주세요

가 아니라,

구현 후에 테스트를 실행해 주세요.
실패한 경우에는 원인을 조사해서 수정하고,
모두 성공할 때까지 확인해 주세요.

까지 요청합니다.

예를 들어,

npm test
npm run lint
npm run typecheck
...

등입니다.

Claude가,

구현했습니다.

라고 말하는 것이 아니라,

테스트가 성공했다
빌드가 성공했다

와 같이 기계적으로 확인할 수 있는 결과를 완료 조건으로 삼습니다.

이는 Claude Code를 사용할 때 매우 중요합니다.

Claude Code는,

• 파일 편집
• Bash 커맨드
• Git 조작
• MCP 툴

등을 실행할 수 있습니다.

따라서, 권한 관리가 있습니다.

대표적인 것이,

Manual
Auto
Plan
...

등입니다.

작업 내용을 세밀하게 확인하고 싶을 때는 Manual이 좋습니다.
어느 정도 Claude에게 맡기고 싶을 때는 Auto가 사용하기 편리하다고 생각합니다.

한편,

--dangerously-skip-permissions

처럼 권한 확인을 완전히 무효화하는 방법도 있지만, 평소 사용에서는 추천하지 않습니다.

Claude Code는 보통,

rm
git reset
npm install

등을 실행할 수 있기 때문입니다.

편리하기 때문에 '무엇을 실행할 수 있는 상태인지'를 이해하고 있어야 합니다.

Claude Code를 사용하다 보면 같은 세션에서 계속해서 수정을 이어가고 싶어집니다.
하지만 Claude Code에서는,

컨텍스트 관리(Context Management)가 상당히 중요합니다.
예를 들어,

바그 A를 수정
↓
CSS 수정
...

을 전부 같은 대화에서 계속하는 것은 추천하지 않습니다.

화제가 바뀌면,

/clear

을 사용합니다.

긴 작업을 계속하고 싶다면,

/compact

도 편리합니다.

예를 들어,

/compact API 변경 내용과 변경된 파일을 중점적으로 남겨주세요

와 같이 지정할 수 있습니다.

Claude에게 컨텍스트는 유한한 리소스이므로,

'필요한 정보만 남긴다'

라는 의식이 중요합니다.

Claude Code에는 변경 전 상태로 되돌리는 Checkpoint 기능이 있습니다.

예를 들어 Claude가 많은 코드를 변경해서,

아니, 그 방향이 아니야...

하게 되었다면,

/rewind

을 이용할 수 있습니다.

또한,

Esc
Esc

로도 Rewind 메뉴를 열 수 있습니다.

대화만 되돌리기,

Conversation

코드만 되돌리기,

Code

둘 다 되돌리기,

Conversation + Code

와 같은 조작이 가능합니다.

다만 Checkpoint는 Git의 완전한 대체재는 아닙니다.

Claude Code를 사용할 때도, Git은 반드시 병용하는 것이 안전합니다.

큰 프로젝트가 되면 Claude 본체에게 전부 조사하게 하면 컨텍스트를 상당히 소모합니다.

그래서 편리한 것이 Subagent입니다.

예를 들어,

Subagent를 사용해서,
이 프로젝트의 인증 처리를 조사해 주세요.
아래를 정리해 주세요.
...

와 같이 요청할 수 있습니다.

Subagent는 다른 컨텍스트에서 조사하고, 그 결과만 메인 Claude에게 반환합니다.

따라서,

조사 담당 Claude
↓
결과만 반환
...

와 같은 사용이 가능합니다.

매번 같은 프롬프트를 쓰고 있다면 Skills로 만들 수 있습니다.

예를 들어,

.claude/skills/code-review/SKILL.md

을 만들고,

---
name: code-review
description: 코드 리뷰를 실시한다
...

로 두면,

/code-review

와 같이 재사용할 수 있습니다.

자주 쓰는 작업을 Skill로 만들어가다 보면, Claude Code가 상당히 자신만의 개발 환경이 되어갑니다.

CLAUDE.md는 어디까지나 'Claude에게 주는 지시'입니다.

즉,

반드시 lint(린트)해 주세요

라고 써도 절대 실행될 것이라는 보장은 없습니다.

여기서 사용할 수 있는 것이 Hooks입니다.

예를 들어,

Claude가 파일을 변경
↓
자동으로 ESLint 실행

와 같은 처리를 설정할 수 있습니다.

그 외에도,

.env에 쓰기 금지

파일 변경 후 formatter(포매터) 실행

작업 종료 전 테스트 실행

등을 자동화할 수 있습니다.

생각하는 방식으로는,

CLAUDE.md
= Claude가 지켜주었으면 하는 규칙
Hooks
...

로 나누면 이해하기 쉽습니다.

Claude Code는 MCP(Model Context Protocol)에도 대응하고 있습니다.

MCP를 사용함으로써,

Claude Code
├ GitHub
├ DB
...

처럼 외부 시스템에 연결할 수 있습니다.

예를 들어 GitHub와 연동하면,

Issue #123을 확인해 주세요.
원인을 조사하고,
수정을 구현하고,
...

같은 부분까지 자동화할 수 있습니다.

다만, 처음부터 MCP를 대량으로 추가할 필요는 없습니다.

우선 Claude Code 단독을 사용하며,

CLAUDE.md
↓
Skills
...

정도 순서로 확장해 나가는 것이 추천합니다.

제가 한다면, 어느 정도 큰 기능 개수에는 다음과 같이 사용합니다.

이 기능과 관련된 코드를 조사해 주세요.
아직 변경하지 마세요.
현재 처리 플로우,
...

↓

조사 결과를 바탕으로 구현 계획을 작성해 주세요.
변경 파일과 변경 내용,
고려되는 리스크,
...

↓

계획에 따라 구현해 주세요.
기존 사양은 가능한 한 변경하지 마세요.

↓

변경 내용을 리뷰해 주세요.
그 후에,
・lint(린트)
...

↓

이번 변경 사항에 대해, 다른 Subagent를 사용하여 코드 리뷰해 주세요. 특히,
...

변경 내용을 확인하고 적절한 commit message를 작성해 주세요. 문제가 없으면 commit해 주세요.

이 흐름으로 하면 상당히 안정적입니다.

Claude의 판단 범위가 너무 넓습니다.

먼저 Plan을 만들게 합시다.

코드만 쓰게 하는 것이 아니라,

구현 → 테스트 → 수정
까지 한 세트로 만듭니다.

무관한 정보가 많아질수록 Claude의 정확도가 떨어집니다.

태스크가 바뀌면,

/clear
를 합니다.

무엇이든 CLAUDE.md에 넣는 것이 아니라,

매번 필요 → CLAUDE.md
필요할 때만 → Skill
절대 강제 → Hook
...
와 같이 구분해서 사용합니다.

개인적으로는, 일단 이 정도만 기억해도 충분하다고 생각합니다.

모두 외울 필요는 없습니다.

/
를 입력하면 명령어 목록을 볼 수 있습니다.

Claude Code는,

'AI에게 코드를 작성하게 하는 도구'
로만 사용하기에는 아깝습니다.

VS Code와 결합하여,

조사 ↓ 계획
같은 개발 플로우 자체를 맡김으로써 상당히 편리해집니다.

특히 중요한 것은 다음 포인트입니다.

VS Code 공식 확장 사용**@파일 참조 활용큰 변경 시 Plan Mode 사용CLAUDE.md로 프로젝트 규칙 학습테스트・build까지 Claude가 직접 실행하도록 함태스크가 바뀌면 /clear 하기조사량이 많을 경우 Subagent로 분리하기반복 작업은 Skills화하기절대 지키게 하고 싶은 처리는 Hooks로 지정하기필요할 때 MCP로 외부 서비스와 연결하기**

처음에는,

Claude Code 열기 ↓ 코드를 조사하게 하기 ...
정도부터 시작하면 충분합니다.

익숙해지면 CLAUDE.md, Skills, Subagent, Hooks, MCP를 추가해 나가면서 자신만의 프로젝트 전용 AI 개발 환경으로 발전시킬 수 있습니다.

본 기사는 2026년 10월 시점의 다음 정보를 참고했습니다.

• Anthropic 공식: Claude Code in VS Code
• Anthropic 공식: Claude Code Best Practices
• Anthropic 공식: How Claude remembers your project
• Anthropic 공식: Common workflows
• Anthropic 공식: Settings
• Anthropic 공식: Permissions
• Anthropic 공식: Subagents
• Anthropic 공식: Hooks
• Visual Studio Marketplace: Claude Code for VS Code

※Claude Code는 업데이트가 매우 빠르므로, 세부 UI나 명령어에 대해서는 최신 공식 문서를 확인하는 것을 권장합니다.