Visual Studio에서 Claude Code

Copilot처럼 “보조” 수준을 넘어, 요구사항을 던지면 프로젝트 파일을 직접 만들고 수정해 주는 에이전트형 도구가 필요할 때가 있다.
이번에 처음 Claude Code(Anthropic) 를 Windows 환경에서 설치하고, Visual Studio의 개발자 PowerShell 터미널에서 프로젝트에 붙여 사용하는 과정을 정리한다.

목표

• Windows에서 Claude Code 설치
• claude 명령어가 인식되도록 PATH 설정
• Visual Studio 터미널에서 프로젝트 폴더 기준으로 실행
• 로그인 방식 선택 및 기본 사용 흐름 이해

---

1. Claude Code 설치 (PowerShell)

PowerShell에서 설치 스크립트를 실행한다.

irm https://claude.ai/install.ps1 | iex

 

설치가 끝나면 보통 이런 안내가 나온다.

• 설치 위치 예시: C:\Users\<사용자>\.local\bin\claude.exe
• 중요: C:\Users\<사용자>\.local\bin 이 PATH에 없으면 claude 명령이 인식되지 않는다.

---

2. 설치 확인했는데 claude가 안 먹는 이유 (PATH 문제)

설치 후 바로 아래처럼 치면 이런 에러가 뜰 수 있다.

claude --version

 

에러 예시:

• 'claude' 용어가 cmdlet ... 으로 인식되지 않습니다.

이건 99% PATH에 설치 경로가 포함되지 않아서다.

---

3. 가장 빠른 해결: 풀 경로로 바로 실행

PATH 설정을 아직 안 했더라도, 설치 파일 위치를 알고 있다면 바로 실행 가능하다.

& "C:\Users\<사용자>\.local\bin\claude.exe" --version

 

또는 바로 실행:

& "C:\Users\<사용자>\.local\bin\claude.exe"

 

이걸로 실행이 되면 “설치는 정상, PATH만 문제” 확정이다.

---

4. 터미널 재시작 없이 즉시 해결: 현재 세션에만 PATH 임시 추가

당장 지금 열린 PowerShell(또는 Visual Studio 터미널)에서만 빠르게 해결하려면:

$env:PATH += ";C:\Users\<사용자>\.local\bin"
claude --version
claude

이 방식의 장점:

• 터미널 재시작 없이 바로 적용
• Visual Studio 개발자 터미널에서도 바로 동작

단점:

• 창을 닫으면 설정이 사라짐(임시)

---

5. 영구 해결: 사용자 PATH에 ~\.local\bin 추가

매번 임시 PATH 추가하기 싫으면 사용자 환경 변수 Path에 경로를 넣는다.

방법 A) GUI로 설정

1. 시작 메뉴에서 “환경 변수” 검색 → “시스템 환경 변수 편집”
2. 아래 환경 변수(N)…
3. 사용자 변수 영역의 Path 선택 → 편집
4. 새로 만들기 → 아래 경로 추가
   C:\Users\<사용자>\.local\bin
5. 확인 → 확인 → 확인
6. PowerShell/Visual Studio를 완전히 종료 후 재실행
7. 확인.

claude --version

 

방법 B) PowerShell 한 줄로 사용자 PATH에 추가

GUI가 귀찮으면 아래 한 줄로 영구 등록 가능:

[Environment]::SetEnvironmentVariable(
"Path",
[Environment]::GetEnvironmentVariable("Path","User") + ";C:\Users\<사용자>\.local\bin",
"User"
)

 

⚠️ 주의: 이건 “등록”만 해주는 거라서, 이미 열려 있는 터미널/VS에는 즉시 반영되지 않는다.
반드시 터미널/Visual Studio 재시작이 필요하다.

---

6. Visual Studio에서 Claude Code 실행하기

이제 Visual Studio에서 실제 프로젝트에 붙여서 쓰는 흐름이다.

1. Visual Studio 열기
2. View → Terminal (또는 “개발자 PowerShell” 터미널 열기)
3. 프로젝트 루트 폴더로 이동
4. claude 실행

예시:

cd "C:\path\to\your\project"
claude

 

 

 

---

7. 로그인 방식 선택 화면 이해

처음 실행하면 아래처럼 로그인 방식 선택이 나온다.

• 1. Claude account (Pro/Max/Team/Enterprise)
  1. Anthropic Console account (API usage billing)
  1. 3rd-party (Amazon Bedrock / Microsoft Foundry / Vertex AI)

일반적으로는:

• 개인이 Claude 구독(Pro/Max)로 쓸 거면 → 1번
• 회사에서 API Key 과금(콘솔 계정)로 쓸 거면 → 2번
• 클라우드 플랫폼으로 묶여있으면 → 3번

---

8. “왜 갑자기 명령 실행 허락을 물어보지?” (정상임)

Claude Code는 프로젝트 구조를 파악하려고 ls 같은 명령을 실행하거나 파일을 읽으려 할 때, 아래처럼 물어본다.

• “Do you want to proceed? Yes / No”
• “Esc to cancel · Tab to amend · ctrl+e to explain”

이건 보안 모델 때문에 정상이다.
내 PC에서 명령을 실행하거나 파일을 수정할 수 있기 때문에, 매번 사용자가 승인하도록 설계돼 있다.

------------------------------------------------------------------------------