스위칭쇼츠 2기
자주 하는 질문 FAQ

왜 뜨나요

고치기 — 위에서부터 하나씩

명령어 옆 복사→VS Code 아래 터미널(검은 창) 클릭→Ctrl+V(맥은 Cmd+V)→Enter

터미널이 안 보이면 VS Code 위쪽 메뉴 터미널 → 새 터미널을 누르세요. 아래 명령어는 한 줄씩 넣고, 다 끝난 뒤 다음 번호로 넘어가세요. 맥은 1·3·4·5번만 하면 되고, 나머지는 윈도우 전용이에요.

1. 노드(Node.js)가 깔렸나 보기
   node -v복사
   v24… 숫자가 나오면 → 2번으로 빨간 글이면 → 노드(Node.js)가 없는 거예요. Node.js 공식 사이트에서 LTS 버전을 받으세요 — 윈도우는 Windows 설치 파일(.msi), 맥은 macOS 설치 파일(.pkg). 받은 파일 더블클릭 → ‘다음’(맥은 ‘계속’)만 계속 눌러 설치 → VS Code 껐다 켜기 → 이 1번(node -v)을 다시
2. 설치 명령이 막히지 않게 허용하기
   Set-ExecutionPolicy RemoteSigned -Scope CurrentUser복사
   윈도우가 설치 스크립트를 막지 않도록 푸는 명령이에요. 바꾸겠느냐고 물어보는 글이 뜨면 Y 누르고 Enter. 아무것도 안 뜨고 넘어가도 정상입니다. 윈도우 전용 — 맥은 이 단계를 건너뛰고 3번으로. 설치까지 다 했는데도 계속 빨간 글이면, 이 2번 명령을 한 번 더 넣고 VS Code를 완전히 껐다 켠 뒤 3번부터 다시 하세요. 명령을 넣은 창을 그대로 쓰면 바뀐 설정이 안 먹어요.
3. claude 설치
   irm https://claude.ai/install.ps1 | iex; [Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";$env:USERPROFILE\.local\bin", "User")복사
   클로드 공식 설치 명령이에요. 앞부분이 클로드 코드를 내려받아 깔고, 뒷부분이 깔린 폴더를 폴더 목록(Path)에 등록해요. 글자가 한동안 올라가다 멈추고, 맨 아래에 PS C:\Users\…>(입력을 기다린다는 표시)가 다시 나올 때까지 기다리기 맥은 위 명령 대신 아래 것을 넣으세요. 끝나면 이름@컴퓨터이름 ~ %처럼 %로 끝나는 줄이 다시 나와요
   curl -fsSL https://claude.ai/install.sh | bash복사
   빨간 글이 나면 → 그 화면을 캡처해 사담방에 문의
4. VS Code 완전히 끄고 다시 켜기 오른쪽 위 ✕로 끄고 다시 실행(맥은 Cmd+Q로 완전히 끄기 — 창의 빨간 ● 버튼만으로는 안 꺼져요). 이미 켜져 있던 프로그램은 바뀐 폴더 목록을 모르기 때문에, 터미널만 새로 여는 걸로는 부족해요
5. 잘 됐나 보기
   claude --version복사
   2.x.x (Claude Code)가 나오면 성공 → 설치 프로그램을 다시 실행해 볼케이노 등록을 이어서 하세요(이미 된 부분은 알아서 건너뜁니다)
6. 5번에서 또 빨간 글이면 — 한 번에 해결 명령어 (윈도우 전용) 위 ‘B 깔렸는데 못 찾아요’ 경우예요. 아래를 통째로 복사해 붙여넣고 Enter — 3번과 같은 공식 설치 명령으로 다시 깔고, 폴더 목록(Path) 등록·확인까지 한 번에 합니다. 맥은 이 명령을 넣지 마세요 — 5번까지 해도 안 되면 터미널 화면을 캡처해 사담방에 문의

   & {
     irm https://claude.ai/install.ps1 | iex;
     $bin = "$env:USERPROFILE\.local\bin";
     $u = [Environment]::GetEnvironmentVariable("Path", "User");
     if (($u -split ";") -notcontains $bin) { [Environment]::SetEnvironmentVariable("Path", "$u;$bin", "User"); "PATH ADDED: $bin" };
     $env:Path = "$env:Path;$bin";
     claude --version
   }

   복사
   여러 줄 붙여넣기 경고 창이 뜨면 Paste(붙여넣기) 누르기 맨 끝에 2.x.x (Claude Code)가 나오면 성공 → VS Code 껐다 켜기 빨간 글이 나면 → 그 화면을 캡처해 사담방에 문의

왜 뜨나요

고치기 — 위에서부터 하나씩

명령어 옆 복사→VS Code 아래 터미널(검은 창) 클릭→Ctrl+V(맥은 Cmd+V)→Enter

클로드 대화창(줄 앞에 >)이 아니라 PowerShell 터미널(줄 앞에 PS C:\Users\…>)에 넣어야 해요. 대화창이 떠 있으면 /exit를 치거나 VS Code 위쪽 메뉴 터미널 → 새 터미널로 새 창을 여세요.

아래 1~4번 명령은 윈도우 전용입니다. 맥은 VPN·회사망을 끄거나 휴대폰 핫스팟으로 바꿔 한 번 해 보고, 그래도 안 되면 터미널 화면을 캡처해 사담방에 문의하세요.

1. 인터넷이 클로드 서버까지 닿나 보기
   Test-NetConnection api.anthropic.com -Port 443복사
   TcpTestSucceeded : True면 인터넷은 정상 → 방화벽·VPN·백신은 뒤지지 말고 2번으로 False면 → VPN·회사망을 끄거나 휴대폰 핫스팟으로 바꿔 다시 해 보기
2. 주소를 바꿔 놓는 설정이 남아 있나 보기
   echo "[$env:HTTP_PROXY] [$env:HTTPS_PROXY] [$env:ANTHROPIC_BASE_URL]"복사
   [] [] []처럼 괄호 3개가 전부 비어 있으면 → 3번으로 마지막 괄호에 주소가 찍히면 그게 원인 → 아래 명령을 복사해 넣고 Enter → VS Code 완전히 껐다 켜기
   [Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", $null, "User")복사
3. 설정 파일(settings.json)에 숨어 있나 찾기
   Select-String ANTHROPIC_BASE_URL "$env:USERPROFILE\.claude\settings.json","$env:APPDATA\Code\User\settings.json" -ErrorAction SilentlyContinue복사
   아무것도 안 나오면 설정 파일은 깨끗 → 아래 ‘그래도 안 되면’으로 줄이 찍히면 그게 원인 → 4번으로 (찍힌 줄 앞쪽에 어느 파일인지 나와요)
4. 그 줄 하나만 지우기
   notepad "$env:USERPROFILE\.claude\settings.json"복사
   메모장이 열리면 ANTHROPIC_BASE_URL이 들어간 줄 하나만 지우고 Ctrl+S로 저장하세요 지운 줄이 묶음 { } 안의 마지막 줄이었다면, 바로 윗줄 끝의 쉼표(,)도 지워야 파일이 안 깨져요 3번에서 찍힌 파일이 Code\User\settings.json이면 대신 이 명령으로 여세요: notepad "$env:APPDATA\Code\User\settings.json"
5. VS Code 완전히 끄고 다시 켜기 오른쪽 위 ✕로 끄고 다시 실행(맥은 Cmd+Q) claude를 실행해 대화가 되면 성공