VS Code에서 Claude Code로 에이전트 워크플로우 구축하기: Cursor 없이 기존 환경 활용

새로운 AI IDE로 완전히 전환하는 대신, 오랫동안 익숙해진 VS Code 환경을 유지하면서 AI 에이전트 기능을 활용하고 싶은 개발자라면 Claude Code가 현실적인 선택지가 될 수 있습니다. 이 글에서는 기존 VS Code 환경에 Claude Code를 통합하는 설정 방법, 터미널 기반 상호작용 팁, 그리고 Subagents를 활용한 다중 파일 작업 자동화 워크플로우를 구체적으로 다룹니다.

VS Code에서 Claude Code를 선택하는 이유

Cursor처럼 AI 기능을 처음부터 통합해 설계한 IDE는 강력한 경험을 제공하지만, 기존 VS Code에 축적된 확장 프로그램·개인 설정·단축키를 포기해야 한다는 부담이 따릅니다. Claude Code는 VS Code 확장 프로그램 형태로 제공되어, 기존 환경을 그대로 유지하면서 Anthropic의 AI 모델 기반 에이전트 기능을 추가할 수 있습니다¹.

다만 Claude Code의 주요 상호작용 방식은 터미널 기반입니다. Cursor처럼 에디터 UI에 AI가 깊이 녹아든 경험을 기대한다면 다소 이질감을 느낄 수 있습니다². 이 점은 선택 전에 반드시 고려해야 할 한계입니다.

설치 및 기본 사용법

1. 확장 프로그램 설치

VS Code 마켓플레이스에서 "Claude Code"를 검색해 설치합니다. 설치 후 Anthropic API 키를 설정하면 VS Code 내 통합 터미널에서 claude 명령어로 에이전트와 상호작용할 수 있습니다¹.

2. 컨텍스트를 명시적으로 제공하기

Claude Code는 프로젝트 전체를 미리 인덱싱하지 않습니다. 따라서 작업 대상 코드 스니펫이나 관련 아키텍처 설명을 프롬프트에 직접 포함해야 에이전트가 정확한 작업을 수행할 수 있습니다³.

3. 멀티라인 프롬프트 입력

복잡한 지시사항을 여러 줄로 입력할 때는 Ctrl+J 또는 줄 끝에 **\ (백슬래시)**를 입력한 뒤 Enter를 눌러 줄 바꿈을 추가할 수 있습니다⁴. 단, Shift+Enter를 이용한 멀티라인 입력은 터미널 에뮬레이터에 따라 지원 여부가 다를 수 있습니다.

bash

claude "다음 함수를 리팩토링해주세요. \
calculateTotal 함수를 분리하여 재사용 가능하게 만들고, \
가독성을 높여주세요."

Subagents로 다중 파일 작업 자동화하기

Claude Code의 Subagents는 YAML 프런트매터가 포함된 마크다운 파일로 정의하는 에이전트 시스템입니다. 반복적이고 복잡한 작업을 표준화된 에이전트로 구성해 자율적으로 실행할 수 있습니다. VS Code의 .agent.md 접근 방식과 개념적으로 유사하게, 코드베이스 내에서 AI 에이전트의 동작을 명시적으로 관리할 수 있습니다⁵.

활용 가능한 작업 유형

리팩토링: 여러 파일에 걸쳐 코딩 스타일을 통일하거나 특정 패턴을 개선합니다.
테스트 코드 생성: 새 기능 구현 후 유닛·통합 테스트를 자동으로 생성합니다.
기능 구현: 요구사항에 따라 여러 파일을 수정하거나 새 파일을 생성합니다.

Subagent 정의 예시

아래는 Jest 테스트 코드를 생성하는 Subagent를 test_generator.agent.md로 정의한 예시입니다.

markdown

---
name: Test Generator
description: 주어진 모듈에 대한 Jest 테스트 코드를 생성합니다.
goal: 모든 익스포트 함수에 대한 유닛 테스트 스위트를 작성하고, 엣지 케이스를 포함합니다.
---
## Instructions

다음 JavaScript/TypeScript 모듈을 분석하여 Jest 프레임워크를 사용한 테스트 파일을 생성해주세요.
파일명은 `[모듈이름].test.js` 또는 `[모듈이름].test.ts` 형식으로 작성합니다.
모든 익스포트 함수에 최소 하나의 테스트 케이스를 포함하고, 유효하지 않은 입력·빈 배열 등 엣지 케이스를 고려해주세요.

// 테스트할 모듈 내용을 여기에 붙여넣습니다.

터미널에서 claude agent test_generator.agent.md 형식으로 실행하고, 프롬프트에 테스트할 모듈 내용을 제공하면 에이전트가 테스트 파일을 생성하거나 기존 파일을 수정합니다.

주의: Subagents의 정확한 실행 명령어 문법과 동작 방식은 2026-07 기준이며, 업데이트에 따라 변경될 수 있습니다. 실행 전 공식 문서에서 최신 사양을 확인하시기 바랍니다.

Cursor vs. Claude Code: 어떤 도구가 적합한가

항목	Cursor	Claude Code (VS Code)
기존 VS Code 환경 유지	불가 (별도 IDE)	가능
AI 통합 방식	에디터 UI 전반에 통합	터미널 기반
다중 파일 자율 작업	지원	Subagents로 지원
시각적 통합감	높음	상대적으로 낮음
기존 확장 프로그램 활용	제한적	VS Code 확장 그대로 사용

Cursor는 AI 중심의 새로운 개발 환경에 완전히 적응할 의향이 있고, 에디터 전반에 걸친 끊김 없는 AI 경험을 원하는 개발자에게 적합합니다. Claude Code는 기존 VS Code 환경을 유지하는 것을 우선시하며, 터미널 기반 상호작용에 익숙하고 Subagents로 복잡한 작업을 자동화하려는 개발자에게 적합합니다³.

두 도구 중 어느 쪽이 절대적으로 우월하다고 단정하기는 어렵습니다. 개발자의 생산성은 익숙한 환경에서 오는 숙련도와도 밀접하게 연결되어 있으므로, 자신의 워크플로우와 선호에 맞는 도구를 선택하는 것이 중요합니다.

결론

VS Code 환경을 유지하면서 AI 에이전트 기능을 도입하려면 Claude Code가 현실적인 선택지입니다.
Subagents를 활용하면 리팩토링·테스트 생성·기능 구현 등 반복적인 다중 파일 작업을 자동화할 수 있습니다.
단, 터미널 기반 인터페이스의 이질감과 시각적 통합감 부족은 사전에 감안해야 할 한계입니다.

작성 시점(2026-07) 기준이며, Claude Code의 기능 및 VS Code 확장 프로그램의 동작은 업데이트에 따라 변경될 수 있습니다. 도입 전 공식 문서에서 최신 정보를 확인하시기 바랍니다.