.NET 개발자를 위한 Claude Code: VS Code 및 Visual Studio에서 기초부터 실무 적용까지

AI 도구들은 처음 며칠 동안은 마법처럼 느껴집니다. 무언가를 물어보면 제대로 대답해주고, 당신은 "이것이 모든 것을 바꿀 거야"라고 생각하죠. 그러다 몇 주가 지나면 문맥 (Context)이 꼬이고, 답변은 일반론적으로 변하며, 마치 선택적 기억상실증을 앓고 있는 누군가와 대화하고 있다는 느낌을 받기 시작합니다.

문제는 AI가 아닙니다. 문제는 아무도 그것이 실제로 어떻게 작동하는지 당신에게 설명해주지 않았다는 점입니다.

이 기사는 .NET 개발자를 위한 Claude Code의 신비감을 제거합니다. 이것은 단순히 "이것 좀 봐, 정말 멋지지?"라고 말하는 튜토리얼이 아닙니다. Claude Code가 어떻게 작동하는지, 왜 그렇게 작동하는지, 그리고 VS Code와 Visual Studio 2022/2026 모두에서 실제 C# 프로젝트를 수행할 때 어떻게 최대한 활용할 수 있는지에 대한 실무 가이드입니다.

Claude Code란 무엇인가 (그리고 무엇이 아닌가)

Claude Code는 단순히 미화된 채팅창이 아닙니다. 이것은 당신의 터미널에서 직접 실행되는 CLI (명령줄 인터페이스, Command Line Interface)이며, 파일 시스템에 대한 실제 접근 권한을 가지고 명령을 실행하고, 파일을 읽고 편집하며, 프로젝트에 대한 문맥 (Context)을 유지할 수 있습니다.

"브라우저에서 Claude에게 질문하는 것"과의 차이점은 엄청납니다:

• 브라우저에서는 코드를 수동으로 붙여넣어야 하고, 세션 간에 문맥 (Context)을 잃어버리며, Claude는 당신이 말해주는 것 외에는 당신의 프로젝트에 대해 아무것도 모릅니다.
• Claude Code를 사용하면 Claude가 당신의 리포지토리 (Repository) 안에 존재합니다. 파일을 읽고, dotnet build를 실행하며, 테스트를 실행하고, 솔루션 (Solution)의 아키텍처를 이해합니다.

CLI 외에도, 열려 있거나 선택된 내용에 대한 자동 문맥 (Context)을 제공하며 Claude Code를 에디터에 직접 통합하는 VS Code용 확장 프로그램이 존재합니다. Visual Studio의 경우 이야기가 다르며 (이 부분은 나중에 솔직하게 말씀드리겠습니다).

설치 및 설정

사전 요구 사항

• Node.js 22 LTS 이상
• Claude Code 접근 권한이 있는 claude.ai 계정

CLI 설치

npm install -g @anthropic-ai/claude-code

설치를 확인합니다:

claude --version

프로젝트에서 대화형 세션을 시작하려면, 루트 디렉토리로 이동하여 다음을 실행합니다:

claude

VS Code — 완전한 통합

Marketplace에서 공식 확장을 설치하세요:

• 이름: Claude Code
• ID: anthropic.claude-code
• VS Code 1.98 이상 필요

설치가 완료되면 사이드바에 Claude Code가 나타납니다. 통합 수준은 매우 깊습니다. 파일을 열어두거나 코드를 선택하면 Claude가 이를 자동으로 컨텍스트 (Context)로 받아들입니다. 아무것도 복사하거나 붙여넣을 필요가 없습니다.

JetBrains Rider 또한 공식 플러그인을 통해 완전한 통합을 지원합니다. 팀에서 Rider를 사용한다면, 워크플로 (Workflow)는 VS Code와 매우 유사합니다.

Visual Studio 2022/2026 — 솔직한 진실

Visual Studio는 수십 년 동안 .NET 개발의 제왕이었습니다. 다만 Claude의 존재를 아직 알지 못할 뿐입니다.

2026년 6월 기준, Visual Studio를 위한 공식 Claude Code 확장은 존재하지 않습니다. 끝입니다. 이를 바꿀 수 있는 마법 같은 우회 방법은 없습니다.

하지만 작동하며, 아주 잘 작동하는 방법이 하나 있는데, 바로 **Visual Studio의 통합 터미널 (Integrated Terminal)**을 사용하는 것입니다:

1. 보기 > 터미널 (또는 Ctrl+\, Ctrl+`)로 이동합니다.
2. 솔루션의 루트 디렉토리로 이동합니다 (보통 이미 해당 위치에 있습니다).
3. claude를 실행합니다.

Claude는 VS Code에서와 정확히 동일하게 리포지토리 (Repository)를 읽습니다. 차이점은 자동 시각적 컨텍스트 (Visual Context)가 없다는 것입니다. 따라서 @를 사용하여 파일을 명시적으로 언급해야 합니다 (이에 대해서는 나중에 자세히 다루겠습니다). 많은 리팩터링 (Refactoring), 코드 생성 및 아키텍처 검토 작업에서 터미널만으로도 충분합니다.

많은 .NET 개발자들은 두 IDE를 병렬로 열어둡니다. 고급 디버깅 (Debugging), 폼 디자이너 (Form Designers), 프로파일링 (Profiling) 도구용으로는 Visual Studio를 사용하고, Claude Code와 작업할 때는 VS Code를 사용합니다.

CLAUDE.md — 운영의 핵심 브레인

이것은 이 글에서 가장 중요한 통찰이므로 천천히 읽어주세요.

Claude Code는 지속적인 메모리를 가진 챗봇처럼 작동하지 않습니다. 세션을 시작할 때마다 처음부터 다시 시작합니다. 그렇다면 Claude는 어떻게 당신의 프로젝트를 "알게" 될까요? 바로 CLAUDE.md라고 불리는 파일을 통해서입니다.

Claude가 CLAUDE.md를 발견하는 방법

디렉토리에서 claude를 실행하면, Claude는 현재 작업 디렉토리 (CWD, Current Working Directory)로부터 CLAUDE.md 파일을 찾기 위해 파일 시스템을 상위로 탐색 (filesystem traversal upwards) 합니다. 또한, 하위 디렉토리에 있는 CLAUDE.md 파일들은 해당 디렉토리에 접근할 때마다 지연 로딩 (Lazy loading) 방식으로 불러옵니다.

이는 두 가지 중요한 의미를 갖습니다:

1. 프로젝트 파일 기반이 아님 — Claude는 CLAUDE.md를 찾기 위해 .csproj 파일을 읽지 않습니다. 파일 시스템상의 위치를 통해 발견합니다. 만약 CLAUDE.md가 레포지토리(Repo)의 루트에 있고 그곳에서 claude를 실행하면 로드됩니다. 하위 디렉토리에서 실행하더라도 (상위로 올라가기 때문에) 로드됩니다.

2. Visual Studio의 솔루션 탐색기(Solution Explorer)에는 CLAUDE.md가 나타나지 않음 — 어떤 .csproj에도 참조되어 있지 않기 때문입니다. 하지만 Claude는 이를 로드합니다. 프로젝트에 파일을 추가할 필요가 없습니다. 사실, 추가하지 않는 것이 더 좋습니다. 이것은 AI를 위한 컨텍스트 (Context) 파일이지, 애플리케이션의 리소스가 아니기 때문입니다.

로드된 내용 확인하기

다음 명령어를 사용하여 Claude가 어떤 CLAUDE.md 파일들을 로드했는지 언제든지 확인할 수 있습니다:

/memory

이 명령은 세션 내에서 활성화된 모든 CLAUDE.md를 포함하여 현재 메모리 내용을 보여줍니다.

초기 CLAUDE.md 생성하기

프로젝트에 CLAUDE.md가 없다면, Claude가 레포지토리를 읽어 직접 생성할 수 있습니다:

/init

이 명령은 코드를 분석하고, 폴더 구조 및 설정 파일을 검토하여 사용자가 다듬을 수 있는 기초적인 CLAUDE.md를 생성합니다.

실무 예제: .NET 프로젝트를 위한 CLAUDE.md

다음은 .NET 10 기반의 이커머스(e-commerce) API를 위한 완전하고 현실적인 예시입니다:

# ECommerceApi — Claude Code를 위한 컨텍스트

## 프로젝트 설명
...

이 파일은 Claude를 단순한 "범용 C# 어시스턴트"에서 "당신의 프로젝트를 잘 아는 동료"로 변화시킵니다. 응답 품질의 차이는 매우 확연합니다.

Claude에게 컨텍스트 제공하기

좋은 CLAUDE.md를 갖추는 것이 작업의 50%입니다. 나머지 50%는 세션 중에 컨텍스트를 어떻게 제공하느냐에 달려 있습니다.

@를 사용한 멘션

@ 구문을 사용하면 특정 파일이나 디렉토리를 참조할 수 있습니다:

@Program.cs                    # 파일 전체
@src/Application/              # 디렉토리 전체
@appsettings.json#1-20         # 파일의 1~20행
...

대화 중 사용 예시:

@src/Application/Orders/Commands/CreateOrderCommand.cs 를 검토하고
C# 14의 새로운 기능(features)을 사용하여 개선할 점이 있는지 알려줘.

@src/Infrastructure/Repositories/OrderRepository.cs#45-80 에 버그가 있어.
GetPendingOrders() 메서드가 취소된 주문을 반환해. 문제가 보여?

VS Code에서의 자동 컨텍스트

확장 프로그램이 설치된 VS Code에서는 현재 활성화된 에디터에서 열려 있는 파일이 자동으로 컨텍스트로 공유됩니다. 코드 블록을 선택하면 해당 블록만 포함됩니다. 이를 통해 @ 멘션을 수동으로 입력해야 하는 번거로움이 크게 줄어듭니다.

Visual Studio (터미널)에서는 @를 사용하여 명시적으로 지정해야 합니다. 이는 사실 Claude에게 무엇을 보여줄지 더 정확하게 결정하도록 강제하며, 반드시 나쁜 것만은 아닙니다.

/compact를 이용한 긴 컨텍스트 관리

긴 세션은 토큰(tokens) 제한이 있습니다. 컨텍스트가 너무 길어지면 Claude가 대화 초반의 내용을 "잊기" 시작할 수 있습니다.

/compact 명령어는 핵심 사항은 보존하면서 컨텍스트(context) 크기를 줄여 현재 세션의 기록을 요약합니다:

/compact

한 세션에서 작업을 오래 지속하여 제한에 도달하기 전에, 미리 이 명령어를 적극적으로 사용하세요. 마치 체크포인트를 만드는 것과 같습니다.

Skills — 워크플로우를 위한 커스텀 명령어

Skills는 팀과 반복적인 프로젝트를 위한 Claude Code의 가장 강력한 기능입니다. Skill은 본질적으로 전체 워크플로우(workflow)를 캡슐화한 **커스텀 명령어 (custom command)**입니다.

Skills가 저장되는 위치

두 가지 위치가 있습니다:

위치	범위	경로
개인용 (Personal)	사용자 본인, 모든 프로젝트	~/.claude/skills/<name>/SKILL.md
프로젝트용 (Project)	팀 전체, 해당 리포지토리 (repo)	.claude/skills/<name>/SKILL.md

프로젝트용 Skills는 코드와 함께 버전 관리됩니다. 누군가 git clone을 하면 Skills도 함께 가져오게 됩니다. 팀 특화 워크플로우에 이상적입니다.

Skill 호출 방법

Claude Code에서 단순히 /skill-name을 입력하면 됩니다:

/dotnet-test
/csharp-review
/ef-migrate

Claude는 해당되는 SKILL.md 파일을 읽고 그 안에 정의된 흐름을 실행합니다.

예시 1: /dotnet-test

.claude/skills/dotnet-test/SKILL.md 파일을 생성합니다:

# dotnet-test

프로젝트의 테스트 스위트(test suite)를 실행하고 결과를 명확하게 제시합니다.
...

예시 2: /csharp-review

.claude/skills/csharp-review/SKILL.md 파일을 생성합니다:

# csharp-review

C# 14 / .NET 10을 사용하여 현대화할 수 있는 기회를 찾으며 C# 코드를 리뷰합니다.
...

예시 3: /ef-migrate

.claude/skills/ef-migrate/SKILL.md 파일을 생성합니다:

# ef-migrate

프로젝트에 Entity Framework Core 마이그레이션(migration)을 추가하기 위한 가이드입니다.
...

이 세 가지 기술(Skills)만으로도 설정할 가치는 충분합니다. 10명 규모의 팀원 모두가 /csharp-review를 호출하여 동일한 리뷰 표준을 적용받는 모습을 상상해 보세요.

MCP — 외부 도구 연결하기

MCP (Model Context Protocol)는 Claude Code가 외부 서비스를 마치 네이티브 도구처럼 연결할 수 있게 해주는 메커니즘입니다.

쉽게 말해, MCP 서버가 특정 기능(PR 읽기, 티켓 조회, 문서 검색 등)을 노출하면, Claude는 세션 중에 이를 사용할 수 있습니다.

.NET 팀에게 유용한 두 가지 예시는 다음과 같습니다:

GitHub MCP — Claude가 레포지토리(repo)의 열려 있는 PR을 읽고, 리뷰 댓글을 확인하며, 사용자가 수동으로 복사할 필요 없이 문제를 해결하도록 도와줄 수 있습니다:

PR #247에서 해결해야 할 변경 사항이 무엇인가요?

Azure DevOps MCP — Claude가 현재 스프린트(sprint)의 컨텍스트와 할당된 사용자 스토리(user stories)를 확인하여, 사용자가 일일이 설명하지 않아도 무엇을 구축하고 있는지 이해할 수 있습니다:

US-1089 스토리의 수락 기준(acceptance criteria)은 무엇인가요?

MCP 서버는 ~/.claude/mcp.json 또는 프로젝트 수준의 .claude/mcp.json에서 설정합니다. Claude Code의 공식 문서에는 사용 가능한 MCP 서버 목록과 설정 방법이 안내되어 있습니다.

VS Code vs Visual Studio, 언제 무엇을 사용할 것인가

모든 .NET 개발자가 결국 던지게 되는 질문입니다. 솔직한 답변은 다음과 같습니다:

기준	VS Code + Claude Code	Visual Studio 2022/2026
Claude Code 통합	완전함 — 자동 컨텍스트, 네이티브 확장 프로그램	기능적 — 통합 터미널 제공, 확장 프로그램 없음
...

실무 권장 사항: 하나만 선택하지 마세요. 병행해서 사용하세요.

Visual Studio는 헤비한 디버깅(debugging), 메모리 프로파일링(profiling), 데스크톱 UI 디자이너 작업에는 여전히 대체 불가능합니다. 반면, Claude Code를 결합한 VS Code는 코드를 더 빠르게 작성하고, 더 깔끔하게 리팩터링(refactor)하며, 타인의 코드를 더 쉽게 이해할 수 있는 환경을 제공합니다.

많은 .NET 팀들이 다음과 같은 워크플로우(workflow)를 채택해 왔습니다: Claude Code를 활성화한 상태로 일상적인 작업에는 VS Code를 사용하고, 고급 디버거(debugger)나 진단 도구(diagnostic tools)가 필요할 때는 Visual Studio를 사용합니다. 이 두 도구는 동일한 프로젝트를 가리키며 완벽하게 공존합니다.

핵심 포인트