초보가 겪었던 어려움 공유(극복완료)

이 부분부터 어려움이 있는거 같아요.
어찌어찌 제미나이에게 물어보면서 터미널에 나오는 글 복사하면서 드디어 클로드코드를 설치 했네요.
다른 분들도 어려움이 있을 수 있으니 저에게 닥친? ㅎ 걸 여기 정리하면..

윈도우(PowerShell) 환경에서 Claude Code 설치 및 연동 시 발생할 수 있는 문제와 해결법

1. 경로 이동 시 역슬래시(\) 입력 문제

• 현상: 강의 영상(Mac 기준)처럼 폴더 이동 시 역슬래시(\)를 넣으려고 하면 윈도우 환경에서는 잘 입력되지 않거나 에러가 납니다.

• 해결: 윈도우 파워쉘에서는 역슬래시 대신 일반 슬래시(/)를 사용해도 인식이 잘 됩니다. 특히 폴더명에 띄어쓰기가 있다면 경로 전체를 큰따옴표("")로 감싸서cd "Documents/Obsidian Vault" 형태로 입력하면 아주 쉽게 이동할 수 있습니다.

2. 설치 후 claude 명령어 인식 불가 (환경 변수 설정)

• 현상: 설치가 완료되었다는 메시지가 떴는데도 터미널에 claude를 입력하면 명령어를 인식하지 못한다는 에러가 발생합니다.

• 해결: 기본적으로 터미널을 완전히 껐다 켜야 경로가 반영됩니다. 만약 터미널을 재시작해도 안 된다면, 파워쉘에 아래 명령어를 입력하여 환경 변수(PATH)에 설치 경로를 직접 등록해 주어야 합니다.

  PowerShell

  [Environment]::SetEnvironmentVariable("PATH", $env:PATH + ";C:\Users\유저명\.local\bin", "User")
  

  (※ 유저명 부분은 본인의 윈도우 사용자 이름으로 변경해야 합니다. 입력 후 터미널을 완전히 닫고 새로 열어야 적용됩니다.)

3. 로그인 인증 시 OAuth 오류 (redirect_uri 매개변수 누락)

• 현상: 테마 선택 후 로그인 주소가 브라우저에서 자동으로 열리지 않아 화면에 나온 주소를 복사해 주소창에 붙여넣었을 때, 웹페이지에 잘못된 OAuth 요청 / redirect_uri 매개변수가 누락되었습니다라는 에러가 뜹니다.

• 원인 1 (플랜 제한): 현재 Claude Code는 Claude Pro 이상 유저만 사용이 가능합니다. 무료 플랜 계정으로는 연동 단계에서 승인이 되지 않습니다.

• 원인 2 (주소 깨짐): 터미널에 표시된 주소가 너무 길어서 마우스로 드래그할 때 끝부분이 잘리거나, 파워쉘 창 크기 때문에 줄바꿈이 일어나면서 주소 데이터가 깨져 발생하는 문제입니다.

• 해결: 1. 우선 Claude 계정이 Pro 멤버십 상태인지 확인합니다. 2. 터미널에 나온 긴 주소를 복사할 때 주소가 쪼개지지 않도록 터미널 창을 가로로 길게 늘려 한 줄로 만든 뒤 끝까지 정확히 드래그해서 복사합니다. (또는 키보드 Ctrl 키를 누른 채 마우스로 링크를 클릭하면 브라우저로 바로 연결됩니다.) 3. Pro 계정이 로그인되어 있는 브라우저 탭에 주소를 넣고 [승인(Authorize)]을 누르면 화면에 진짜 8~10자리 내외의 인증 코드가 나타납니다. 이 코드를 복사해서 터미널 맨 아랫줄에 붙여넣고 엔터를 치면 정상적으로 연동이 완료됩니다!