클로드 코드 설치 윈도우 초보용: PowerShell 한 줄, 로그인, 첫 질문까지 화면으로

이 글 순서

1. 클로드 코드가 뭔가요
2. 처음이라면: 준비물
3. 1단계 터미널 열기
4. 2단계 설치 한 줄
5. 3단계 설치 확인
6. 4단계 작업 폴더
7. 5단계 첫 실행·로그인
8. 6단계 첫 요청과 나가기
9. 막혔을 때 볼 곳
10. 익숙해졌다면
11. 더 깊이
12. 코덱스·다른 CLI 는
13. 한국에서 되나
14. 참고한 자료

클로드 코드는 까만 창에 글자로 요청을 적으면, 내 컴퓨터의 폴더를 읽고 파일을 만들거나 고쳐 주는 AI 도구예요. 채팅 앱과 다른 점은 답만 해 주는 게 아니라 내 폴더 안에서 직접 일을 한다는 거예요. 코드를 짜는 사람이 주로 쓰지만, 공식 문서는 코드를 몰라도 된다고 적었어요. 바탕 화면의 캡처 파일 이름을 내용에 맞게 바꿔 달라거나, 간단한 웹 페이지를 만들어 달라는 요청이 문서의 예시예요.

어려운 부분은 설치예요. 까만 창을 열고 명령을 쳐야 하니까요. 이 글은 클로드 코드 공식 문서의 설치(setup), 빠른 시작(quickstart), 터미널 가이드(terminal guide), 설치 문제 해결(troubleshoot-install) 쪽을 2026년 10월 8일에 읽고 윈도우 순서만 뽑아 옮겼어요. 문서 캡처는 한국어 문서로 했고, 설치 명령과 준비물·로그인 순서는 영어 문서와 맞춰 봤어요. 터미널 그림은 클로드 코드가 이미 깔린 PC 에서 같은 날 명령을 돌려 나온 글자를 옮겨 그린 거예요.

클로드 코드가 뭔가요

단어 몇 개만 먼저 풀고 갈게요.

• 터미널: 마우스 대신 글자로 컴퓨터에 일을 시키는 창이에요. 윈도우에는 PowerShell 과 CMD(명령 프롬프트) 두 가지가 처음부터 들어 있어요.
• 명령(명령어): 터미널에 치는 한 줄짜리 지시예요. 치고 Enter 를 누르면 실행돼요.
• CLI: 명령 줄 인터페이스(Command Line Interface)를 줄인 말로, 터미널에서 글자로 쓰는 프로그램을 뜻해요. 클로드 코드가 CLI 예요.
• 모델: 답을 만들어 내는 AI 두뇌예요. 클로드 코드는 Anthropic 의 클로드 모델을 불러다 써요.
• 스크립트: 명령 여러 줄을 차례로 적어 둔 파일이에요. “설치 스크립트”는 설치에 필요한 명령을 모아 둔 파일이고, 한 번 돌리면 그 명령들이 차례로 실행돼요.
• 프롬프트: 두 가지 뜻으로 쓰여요. 터미널에서는 명령을 기다리는 줄 앞 글자(PS C:\ 같은 것)를, AI 에서는 내가 적어 보내는 요청 글을 가리켜요.

클로드 코드는 터미널 말고도 데스크톱 앱, 웹(claude.ai/code), VS Code 확장으로도 쓸 수 있어요. VS Code 는 코드를 적을 때 많이 쓰는 무료 코드 편집기이고, 확장은 거기에 끼워 넣는 추가 기능이에요. 까만 창이 정 내키지 않으면 데스크톱 앱이 터미널 없이 쓰는 길이라고 문서 맨 위에 적혀 있어요. 이 글은 터미널에 까는 길만 다뤄요. 설정 글과 팁 글 대부분이 터미널 기준이라 한 번 깔아 두면 뒤가 편해요.

처음이라면: 준비물

깔기 전에 볼 것은 계정과 컴퓨터 두 가지예요.

준비물	문서에 적힌 것
계정	Pro·Max·Team·Enterprise 또는 Console. 무료 요금제는 안 됨
윈도우	윈도우 10 버전 1809 이상, 또는 Windows Server 2019 이상
컴퓨터	메모리 4GB 이상, x64 또는 ARM64 프로세서
인터넷	꼭 필요
Node.js	필요 없음(npm 으로 깔 때만 22 이상)
Git for Windows	없어도 됨, 깔기를 권함
관리자 권한	필요 없음

출처: 클로드 코드 문서 setup 의 System requirements·Set up on Windows·Authenticate·Install with npm. 10월 8일 확인.

계정부터 볼게요. 설치 문서는 “Pro, Max, Team, Enterprise, Console 계정이 필요하고 무료 claude.ai 요금제에는 클로드 코드가 들어 있지 않다”고 적었어요. Console 은 개발자용 계정으로, 문서는 “선불 크레딧으로 쓰는 API 접근”이라고 풀었어요. API 는 프로그램끼리 주고받는 창구를 뜻하는데, 처음이라면 몰라도 되는 길이에요. 개인은 보통 Pro 부터 시작하고, Pro 는 한 달 22달러예요(10월 7일에 확인한 값). Pro 와 Max 가운데 무엇을 고를지는 클로드 Pro·Max 차이 글에 표로 있어요.

Node.js 는 예전 설치 방식 때문에 자주 묻는 준비물이에요. Node.js 는 자바스크립트라는 언어로 짠 프로그램을 돌리는 실행 환경(런타임)이고, npm 은 거기 딸린 프로그램 설치 도구예요. 예전에는 npm 으로 클로드 코드를 까는 게 기본이었는데, 지금 문서가 “권장”이라고 붙인 길은 설치 스크립트 한 줄(기본 설치, Native Install)이에요. 이 길은 Node.js 가 없어도 돼요. npm 방식도 문서에 남아 있고, 그때만 Node.js 22 이상이 필요하다고 적혀 있어요. npm 방식은 아래 “익숙해졌다면”에서 다뤄요.

Git for Windows 는 선택이에요. Git 은 파일이 바뀐 이력을 기록해 두는 도구인데, 문서는 직접 Git 을 배울 필요는 없다고 적었어요. 깔면 Git Bash 라는 터미널이 같이 생기고, 클로드 코드가 그걸로 명령을 돌려요(Bash 도구). 없으면 PowerShell 로 대신 돌려요. 그래서 없어도 설치와 실행은 돼요.

깔겠다면 문서의 순서는 이래요. git-scm.com/downloads/win 에서 설치 파일을 받아 실행하고, 화면마다 “Next”를 눌러 기본값 그대로 넘어가요. 편집기를 고르라는 화면도 기본값, “Adjusting your PATH environment” 화면도 권장 옵션 그대로 두면 돼요. 이미 깔려 있는지 모르겠으면 그냥 다시 깔아도 문제없다고 문서에 적혀 있어요.

깔려 있는지는 터미널에서 한 줄로 볼 수 있어요. 터미널 여는 법은 바로 다음 단계에 있어요.

git --version

이 줄은 Git 의 버전을 물어보는 명령이에요. 깔려 있으면 아래처럼 버전이 한 줄 나오고, 없으면 그런 명령을 모른다는 글이 나와요. 그림의 둘째 명령 node -v 는 같은 식으로 Node.js 의 버전을 묻는 줄이에요. npm 으로 깔 분만 보면 되고, 설치 스크립트로 깔 분은 이 줄에서 오류가 나도 괜찮아요.

1단계 터미널 열기

키보드의 윈도우 키와 X 를 같이 누르면 메뉴가 떠요. 거기서 “Windows PowerShell”이나 “터미널”을 고르면 깜박이는 커서가 있는 창이 열려요. 시작 메뉴에서 “PowerShell”을 검색해 열어도 돼요.

윈도우에는 비슷하게 생긴 창이 여럿이라 헷갈려요. 셸(shell)은 내가 친 명령을 알아듣고 실행해 주는 프로그램을 말하는데, PowerShell·CMD·Git Bash 가 모두 셸이에요. 셋은 알아듣는 명령이 조금씩 달라서, 같은 설치 명령이 한쪽에서는 되고 다른 쪽에서는 오류가 나요.

• 이 화면이 나오면 맞음: 줄 앞에 PS C:\Users\내이름> 처럼 PS 가 붙어 있어요.
• PS 가 없고 C:\Users\내이름> 만 보이면 CMD 예요. 창을 닫고 PowerShell 을 다시 열거나, 다음 단계에서 CMD 용 명령을 쓰면 돼요.
• 시작 메뉴에 “Windows PowerShell (x86)”도 보일 수 있어요. 이건 고르지 마세요. 이유는 “막혔을 때 볼 곳”에 있어요.

터미널에서는 마우스로 누를 수 있는 게 거의 없어요. 글자를 치고 Enter, 이게 전부예요. 붙여 넣기는 Ctrl+V 나 마우스 오른쪽 버튼이에요.

2단계 설치 한 줄

아래 한 줄을 그대로 복사해 PowerShell 에 붙여 넣고 Enter 를 눌러요.

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

이 줄은 설치 프로그램을 다운로드해 바로 실행하는 명령이에요. 문서 설명으로는 irm 이 파일을 가져오고 iex 가 그걸 실행해요. 가운데 파이프(|)는 앞의 결과를 뒤로 넘기라는 뜻이라, 셋 중 하나라도 빠지면 설치가 안 돼요.

CMD 창이라면 명령이 달라요. 길어서 화면 폭에 따라 꺾이거나 옆으로 밀려 보여도 한 줄이에요. 끊지 말고 통째로 복사하세요.

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

이 줄은 설치 파일(install.cmd)을 다운로드하고, 실행하고, 다 쓴 설치 파일을 지우는 세 가지 일을 이어서 해요.

• 이 화면이 나오면 맞음: 글자가 주르륵 올라가다가 “Claude Code successfully installed!” 가 보이면 끝난 거예요(터미널 가이드에 적힌 문구).
• ‘irm’ is not recognized as an internal or external command 가 나오면: 지금 창이 CMD 예요. PowerShell 을 열거나 위의 CMD 용 명령을 쓰세요.
• The token ‘&&’ is not a valid statement separator 가 나오면: PowerShell 에 CMD 용 명령을 친 거예요. irm 으로 시작하는 줄을 쓰세요.
• 명령 대신 스크립트 글자만 길게 찍히고 아무것도 안 깔리면: | iex 를 빼고 앞부분만 돌린 거예요. 한 줄을 끝까지 붙여 넣으세요.

설치가 끝난 직후의 화면은 이 글에 싣지 못했어요. 이미 깔려 있는 PC 라 다시 깔아 볼 수 없었기 때문이에요. 위 문구는 문서에 적힌 그대로예요.

이 길로 깔면 실행 파일은 %USERPROFILE%\.local\bin\claude.exe 에 놓여요. %USERPROFILE% 은 윈도우가 “내 사용자 폴더”(보통 C:\Users\내이름)를 가리킬 때 쓰는 이름이에요. 그리고 문서에는 이 방식이 뒤에서 알아서 새 버전으로 올라간다고 적혀 있어요.

표에 나오는 WSL 은 윈도우 안에서 리눅스를 돌리는 기능이에요. 샌드박싱은 클로드 코드가 돌리는 명령이 건드릴 수 있는 파일과 인터넷 주소를 정해진 범위 안으로 묶어 두는 기능인데, 윈도우에 그대로 까는 길에서는 지원하지 않는다고 표에 적혀 있어요. 리눅스 도구를 쓰는 개발자가 고르는 길이고, 처음이라면 맨 윗줄 “네이티브 Windows”(윈도우에 그대로 까는 길)면 돼요.

3단계 설치 확인

문서는 설치가 끝나면 터미널 창을 새로 열라고 해요. 열려 있던 창은 방금 깔린 프로그램의 자리를 아직 모를 수 있어서예요. 새 PowerShell 창에서 이 줄을 쳐요.

claude --version

이 줄은 깔린 클로드 코드의 버전을 물어보는 명령이에요. 대화를 시작하지 않고 버전만 출력하고 끝나요.

• 이 화면이 나오면 맞음: 숫자 뒤에 (Claude Code) 가 붙어 나와요. 문서의 예시는 2.1.211 (Claude Code) 이고, 10월 8일 이 PC 에서는 2.1.292 (Claude Code) 였어요. 숫자는 깐 날에 따라 달라요.
• ‘claude’ is not recognized 가 나오면: 설치 폴더가 PATH 에 없는 거예요. 아래 “막혔을 때 볼 곳”으로 가세요.

더 자세히 보고 싶으면 점검 명령이 하나 더 있어요.

claude doctor

이 줄은 설치 상태를 한 번 훑어보는 명령이에요. 문서 표현으로는 대화를 시작하지 않고 설치 상태, 설정 파일 오류, 경고와 고치는 법을 읽기 전용으로 출력해 줘요. 무언가를 바꾸지 않으니 마음 놓고 돌려도 돼요.

그림에서 볼 줄은 맨 아래 “No installation issues found.” 예요. 문제가 없다는 뜻이에요. 그림은 이 PC 에서 나온 글자를 옮긴 것이고, 사용자 이름은 “사용자이름”으로 바꿨고 커밋 번호 한 줄과 계정 종류가 드러나는 두 줄은 뺐어요. 그리고 이 PC 는 예전 npm 방식으로 깔려 있어서 Running 줄이 npm-global 이고 Path 도 npm 폴더예요. 위 설치 스크립트로 깔았다면 이 두 줄은 다르게 나와요.

4단계 작업 폴더

클로드 코드는 “지금 서 있는 폴더”를 작업 폴더로 삼아요. 그 폴더 안의 파일을 읽고 고쳐요. 그래서 아무 데서나 켜지 말고, 일할 폴더를 하나 만들어 그 안에서 켜는 게 좋아요.

터미널에는 늘 “지금 폴더”가 있어요. 줄 앞의 PS C:\Users\내이름> 에서 C:\Users\내이름 이 지금 폴더예요. 이렇게 폴더 위치를 글자로 적은 것을 경로라고 불러요.

mkdir my-first-project
cd my-first-project

첫 줄 mkdir 은 폴더를 새로 만드는 명령이고(make directory), 둘째 줄 cd 는 그 폴더 안으로 들어가는 명령이에요(change directory). 폴더 이름은 마음대로 지어도 되는데, 띄어쓰기 없이 영어와 숫자로 짓는 편이 뒤탈이 없어요. 이미 있는 폴더에서 일하려면 mkdir 은 건너뛰고 cd 뒤에 그 폴더 경로를 적어요.

• 이 화면이 나오면 맞음: mkdir 뒤에 폴더 이름이 든 표가 한 번 찍히고, cd 뒤에 줄 앞 글자 끝이 \my-first-project> 로 바뀌어요.
• 이미 있다는 오류가 나오면: 같은 이름의 폴더가 벌써 있는 거예요. cd 만 치면 돼요.

홈 폴더(C:\Users\내이름) 바로 그 자리에서 켜지 말라는 데에는 문서에 적힌 이유가 있어요. 클로드 코드는 처음 여는 폴더에서 “이 폴더를 믿느냐”고 묻는데, 홈 폴더에서 시작하면 그 대답이 저장되지 않아 켤 때마다 다시 물어요. 문서도 프로젝트 폴더 안에서 시작하라고 적었어요.

5단계 첫 실행·로그인

작업 폴더 안에서 이 한 단어를 쳐요.

claude

이 줄은 클로드 코드를 대화 모드로 켜는 명령이에요. 처음 켜면 로그인부터 하게 돼요.

문서에 적힌 로그인 순서는 이래요.

1. claude 를 치면 웹 브라우저 창이 자동으로 열려요.
2. 브라우저에서 클로드 계정으로 로그인해요. Pro·Max 를 내고 있는 claude.ai 계정 그대로예요. 회사에서 Team·Enterprise 를 쓴다면 관리자가 초대한 그 계정으로 해요.
3. 브라우저가 안 열리면 터미널에서 c 를 눌러요. 로그인 주소가 복사되니 브라우저 주소창에 붙여 넣으면 돼요.
4. 브라우저가 터미널로 돌아가지 않고 로그인 코드를 보여 주면, 그 코드를 터미널의 “Paste code here if prompted” 자리에 붙여 넣어요.
5. 터미널에 “Login successful” 이 뜨면 Enter 를 눌러요.

한 번 로그인하면 로그인 정보가 저장돼서 다음부터는 다시 묻지 않는다고 문서에 적혀 있어요. 계정을 바꾸고 싶을 때는 클로드 코드 안에서 /login 을 쳐요.

로그인 말고도 첫 실행 때 만나는 것이 더 있어요. 어느 것이 먼저 뜨는지는 문서에 적혀 있지 않아서, 적힌 내용만 모았어요.

• 폴더 신뢰 확인 창(workspace trust dialog): 처음 여는 폴더에서 떠요. 내가 만든 폴더라면 믿는다고 답하면 돼요. 남에게 받은 폴더라면 그 폴더가 클로드 코드에 무엇을 허락하게 돼 있는지 이 창이 목록으로 보여 주니 읽어 보고 정하세요.
• 입력 칸: 로그인이 끝나면 글을 적는 칸이 나오고, 그 위에 버전·지금 쓰는 모델·작업 폴더가 보인다고 빠른 시작 문서에 적혀 있어요.
• 권한 확인 창: 파일을 만들거나 고치기 전에 해도 되느냐고 물어요. Yes 를 고르면 진행해요. 다만 문서에는 v2.1.283 부터 터미널 세션이 auto 모드로 시작한다고 적혀 있어서, 이 창이 덜 뜰 수 있어요(클로드 코드 사용법 처음부터 글의 “묻는 창이 뜰 때”에 자세히).
• 화면 테마 고르기: 첫 실행에 테마를 고르는 화면이 나오는지는 읽은 문서에서 찾지 못했어요(미확인). 테마는 언제든 /theme 이나 /config 로 바꿀 수 있다고만 적혀 있어요.

로그인 브라우저 화면, 폴더 신뢰 확인 창, 첫 입력 칸의 실제 모습은 이 글에 싣지 못했어요. 이미 로그인된 PC 라 다시 만들 수 없었고, 문서에도 그 화면 그림은 없어요.

6단계 첫 요청과 나가기

입력 칸에 하고 싶은 말을 적고 Enter 를 누르면 돼요. 빠른 시작 문서가 처음 해 보라고 드는 질문은 이런 것들이에요.

what does this project do?

이 줄은 명령이 아니라 프롬프트예요. “이 프로젝트가 무슨 일을 하는 거야?”라는 뜻이고, 클로드가 폴더 안 파일을 읽고 요약해 줘요. 문서에는 파일을 일일이 알려 줄 필요 없이 클로드 코드가 필요한 파일을 알아서 읽는다고 적혀 있어요.

방금 만든 빈 폴더라면 읽을 게 없으니 만들어 달라는 요청이 더 맞아요. 문서가 드는 예시를 하는 일에 따라 나누면 이래요.

누가	문서의 예시 요청	뜻
코드를 모르는 분	make me a simple webpage that says hello world	인사말이 뜨는 간단한 웹 페이지 만들기
코드를 모르는 분	look at the screenshots on my Desktop and rename them based on what’s in each image	바탕 화면 캡처 파일 이름을 내용에 맞게 바꾸기
이제 막 배우는 분	add a hello world function to the main file	주 파일에 간단한 함수 하나 넣기
이제 막 배우는 분	there’s a bug where users can submit empty forms – fix it	빈 칸으로도 제출되는 오류 고치기

출처: 클로드 코드 문서 terminal-guide 의 What’s next, quickstart 의 Step 4·Step 6. 10월 8일 확인.

웹 페이지를 만들어 달라고 하면 클로드가 파일을 만들기 전에 허락을 구해요. Enter 를 눌러 Yes 를 고르면 파일이 생기고, 만들어진 HTML 파일(웹 페이지의 내용을 적은 파일)을 두 번 눌러 열면 브라우저에 뜬다고 터미널 가이드에 적혀 있어요.

문서의 예시 요청은 모두 영어예요. 한국어로 적어도 되는지는 클로드 코드 문서에 따로 적혀 있지 않았어요. 다만 Claude API 문서의 다국어 지원(Multilingual support) 쪽 언어 표에 Korean 이 들어 있고, 표에 없는 언어도 여럿 다룬다고 적혀 있어요.

문서 예시 말고, 같은 형식으로 적어 볼 만한 요청을 몇 개 더 들면 이래요. 제가 든 예시이고 결과를 재 본 것은 아니에요.

누가	이런 요청
코드를 모르는 분	이 폴더의 CSV 파일 세 개를 한 파일로 합쳐 줘. 첫 줄 제목은 한 번만 남겨 줘
코드를 모르는 분	report.txt 의 맞춤법과 어색한 문장을 고치고, 고친 곳을 목록으로 알려 줘
이제 막 배우는 분	이 오류 글이 무슨 뜻인지 쉬운 말로 풀어 줘(오류 글을 붙여 넣기)
이제 막 배우는 분	이 함수에 빈 값이 들어오면 멈추는데, 고치기 전에 이유부터 알려 줘

CSV 는 표를 쉼표로 나눠 적은 텍스트 파일이에요. 엑셀에서 “다른 이름으로 저장”으로 만들 수 있어요.

알아 둘 키는 몇 개 안 돼요.

하고 싶은 것	누르거나 치는 것	적힌 문서
클로드가 하던 일 멈추기	Esc	터미널 가이드
명령 목록 보기	/help	빠른 시작
나가기	/exit (같은 말 /quit)	빠른 시작, 명령 목록
나가기(키)	빈 입력 칸에서 Ctrl+D 두 번	빠른 시작, 터미널 가이드
나가기(키)	Ctrl+C 두 번	대화 모드 문서
아까 대화 이어 하기	claude -c	빠른 시작
옛 대화 골라 열기	claude -r	빠른 시작

출처: 클로드 코드 문서 quickstart·terminal-guide·interactive-mode·commands. 10월 8일 확인.

나가는 법은 문서마다 조금 다르게 적혀 있어요. 빠른 시작은 “/exit 또는 Ctrl+D 두 번”, 터미널 가이드는 “exit 를 치거나 빈 입력 칸에서 Ctrl+D 두 번”이에요. 대화 모드 문서에는 Ctrl+C 도 나와요. 아무것도 돌고 있지 않을 때 한 번 누르면 적던 글이 지워지고, 한 번 더 누르면 나가져요. 헷갈리면 /exit 하나만 기억하면 돼요.

나갔다가 다시 이어 하려면 같은 폴더에서 claude -c 를 쳐요. 그 폴더에서 가장 최근에 하던 대화가 다시 열려요. claude -r 은 예전 대화 목록에서 골라 여는 명령이에요.

터미널에서 claude --help 를 치면 쓸 수 있는 옵션이 영어로 길게 나와요. 이 PC 에서는 300줄쯤이었고, 그림에는 앞부분과 위에서 말한 세 줄만 옮겼어요.

막혔을 때 볼 곳

설치 문제 해결 문서 맨 위에는 “보이는 오류 문구 → 고치는 법” 표가 있어요. 오류가 나면 그 문구를 이 표에서 찾는 게 가장 빨라요.

윈도우에서 설치와 로그인 때 자주 만나는 것만 추리면 이래요. 오류 문구는 문서의 글자 그대로예요.

보이는 글	이유	할 일
‘claude’ is not recognized	설치 폴더가 PATH 에 없음	새 창 열기, 안 되면 아래 PATH 명령
‘irm’ is not recognized	CMD 에서 PowerShell 명령을 침	PowerShell 열기 또는 CMD 용 명령
The token ‘&&’ is not a valid statement separator	PowerShell 에서 CMD 명령을 침	irm 으로 시작하는 줄 쓰기
Could not create SSL/TLS secure channel	오래된 윈도우 10 에서 흔함	아래 TLS 줄을 먼저 돌리고 다시 설치
Claude Code does not support 32-bit Windows	PowerShell (x86) 창이 열림	(x86) 없는 PowerShell 로 다시
The process cannot access the file …	앞선 설치가 아직 돌거나 백신이 검사 중	다른 설치 창을 닫고, 아래 두 줄로 다시
App unavailable in region	지원하지 않는 나라	지원 국가 목록 확인(한국은 있음)
OAuth error: Invalid code	로그인 코드가 잘렸거나 시간이 지남	Enter 로 다시, 브라우저에서 빨리 끝내기

출처: 클로드 코드 문서 troubleshoot-install 의 Find your error 와 각 절, terminal-guide 의 Windows troubleshooting. 10월 8일 확인.

가장 흔한 건 맨 윗줄, claude 를 못 찾는 경우예요. PATH 는 윈도우가 “명령 이름을 들으면 뒤져 보는 폴더 목록”이에요. claude 라고 쳤을 때 윈도우는 이 목록의 폴더들에서 claude 라는 프로그램을 찾는데, 설치 폴더가 목록에 없으면 깔려 있어도 못 찾아요. 먼저 창을 닫고 새로 열어 보세요. 그래도 안 되면 문서의 순서대로 해요.

그림의 파란 상자는 VS Code 확장만 깐 분이 자주 걸리는 자리예요. 확장은 자기 안에 클로드 코드를 따로 품고 있고 그걸 PATH 에 넣지 않아요. 그래서 확장만 깔았다면 터미널에서 claude 를 쳐도 못 찾는 게 정상이고, 터미널에서 쓰려면 위 2단계 설치를 따로 해야 한다고 문서에 적혀 있어요.

먼저 설치 폴더가 PATH 에 들어 있는지 봐요.

$env:PATH -split ';' | Select-String '\.local\\bin'

이 줄은 PATH 목록을 한 줄씩 나눠 그 가운데 .local\bin 이 든 줄만 보여 줘요. 무언가 나오면 들어 있는 거고, 아무것도 안 나오면 없는 거예요. 없으면 아래 두 줄을 차례로 돌려요.

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

첫 줄은 지금 내 PATH 를 읽어 두고, 둘째 줄은 그 끝에 설치 폴더를 붙여 다시 저장해요. 여기서 PATH 처럼 윈도우가 이름을 붙여 기억해 두는 값을 환경 변수라고 불러요. 저장한 뒤에는 PowerShell 을 닫고 새로 열어 claude --version 을 다시 쳐 보세요.

claude 가 어디에 깔려 있는지 직접 볼 수도 있어요. where.exe 는 그 이름의 프로그램이 놓인 자리를 찾아 주는 윈도우 명령이고, Test-Path 는 그 자리에 파일이 있는지 True·False 로 답해요.

where.exe claude
Test-Path "$env:USERPROFILE\.local\bin\claude.exe"

이 그림은 npm 으로 깐 PC 의 출력이라 npm 폴더가 나오고 Test-Path 가 False 예요. 설치 스크립트로 깔았다면 where.exe 가 .local\bin\claude.exe 를 가리키고 Test-Path 는 True 가 나와야 해요. where.exe 에 두 군데 넘게 나오면 여러 번 깔린 거라, 문서는 하나만 남기라고 권해요.

“The process cannot access the file … because it is being used by another process” 는 설치 프로그램이 다운로드 폴더(%USERPROFILE%\.claude\downloads)에 쓰지 못했다는 뜻이에요. 문서는 설치 중인 다른 PowerShell 창을 닫고 백신 검사가 끝나기를 기다린 뒤, 아래 두 줄로 그 폴더를 지우고 다시 설치하라고 적었어요.

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads"
irm https://claude.ai/install.ps1 | iex

첫 줄은 받다 만 설치 파일이 든 폴더를 통째로 지우는 줄이고, 둘째 줄은 설치를 다시 돌리는 줄이에요.

“Could not create SSL/TLS secure channel” 은 문서가 오래된 윈도우 10 에서 흔하다고 적은 오류예요. 아래 첫 줄을 먼저 돌리고 설치 줄을 다시 돌려요.

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
irm https://claude.ai/install.ps1 | iex

첫 줄은 이 창이 서버와 주고받을 때 쓰는 보안 방식을 TLS 1.2 로 맞추는 줄이에요.

회사 PC 에서 설치가 아예 다운로드하지 못하고 멈춘다면 프록시를 의심해 볼 만해요. 프록시는 회사 컴퓨터와 인터넷 사이에서 오가는 것을 필터링하는 중간 서버예요. 먼저 다운로드하는 서버에 연결되는지 이 줄로 봐요.

curl.exe -sI https://downloads.claude.ai/claude-code-releases/latest

이 줄은 설치 파일을 다운로드하는 서버에 인사만 건네 보고 답의 헤더 부분을 출력해요. PowerShell 에서는 curl 이 다른 명령의 별칭이라 꼭 curl.exe 라고 쳐야 한다고 문서에 적혀 있어요.

• 이 화면이 나오면 맞음: 첫 줄이 HTTP/1.1 200 OK 예요. 서버에는 연결되는 거예요.
• 403 이 나오면: 문서는 프록시나 네트워크 필터가 막았거나 지원하지 않는 지역인 경우가 많다고 적었어요.
• 아무것도 안 나오거나 Could not resolve host 가 나오면: 네트워크가 연결을 막고 있는 거예요.

회사 프록시를 거쳐야 한다면 설치 전에 프록시 주소를 환경 변수로 알려 주라고 문서에 나와 있어요. 주소는 회사 전산 담당자에게 물어보세요. 아래 주소는 문서의 예시라 그대로 치면 안 돼요.

$env:HTTP_PROXY = 'http://proxy.example.com:8080'
$env:HTTPS_PROXY = 'http://proxy.example.com:8080'
irm https://claude.ai/install.ps1 | iex

앞의 두 줄은 이 창에서만 통하는 프록시 주소를 적어 두는 줄이고, 셋째 줄이 설치예요. 회사 보안 장비 때문에 인증서 오류(unable to get local issuer certificate)가 난다면, PowerShell 설치는 윈도우 인증서 저장소를 보니 전산 담당자에게 회사 인증서를 윈도우에 넣어 달라고 하라는 게 문서의 안내예요.

로그인이 꼬였을 때 문서가 권하는 순서는 간단해요. 클로드 코드 안에서 /logout, 창을 닫고, claude 를 다시 켜서 로그인을 처음부터 해요. 유료 요금제를 내는데도 로그인 뒤 “API Error: 403 Request not allowed”(요청이 허락되지 않았다는 오류)가 나오면 claude.ai/settings 에서 구독이 살아 있는지 보라고 적혀 있어요.

익숙해졌다면

여기부터는 며칠 써 본 뒤에 봐도 되는 내용이에요.

업데이트부터요. 설치 스크립트로 깔았다면 클로드 코드가 켜질 때와 켜져 있는 동안 새 버전을 확인해 뒤에서 받아 두고, 다음에 켤 때 적용해요. 기다리지 않고 바로 올리려면 터미널에서 claude update 를 쳐요.

설치하는 방법은 스크립트 말고도 두 가지가 문서에 더 있어요.

설치 방법	필요한 것	업데이트
설치 스크립트(권장)	없음	알아서
WinGet	없음	손으로
npm	Node.js 22 이상	알아서, 안 되면 손으로

출처: 클로드 코드 문서 setup 의 Install Claude Code·Update Claude Code·Install with npm. 10월 8일 확인.

WinGet 은 마이크로소프트가 만든 윈도우용 프로그램 설치 도구예요. 이 길로 깔려면 PowerShell 에 아래 줄을 쳐요.

winget install Anthropic.ClaudeCode

이 줄은 WinGet 에게 클로드 코드를 찾아 깔라고 시키는 명령이에요. 이 길은 알아서 올라가지 않아서, 가끔 winget upgrade Anthropic.ClaudeCode 를 쳐서 올리라고 문서에 적혀 있어요.

npm 으로 처음 까는 줄은 이거예요.

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

이 줄은 npm 에게 클로드 코드 패키지를 컴퓨터 전체에서 쓸 수 있게(-g) 깔라고 시키는 명령이에요. npm 방식은 예전부터 쓰던 분이나 Node.js 를 이미 쓰는 분의 길이에요. 문서는 npm 으로 깔아도 설치 스크립트와 같은 실행 파일이 들어온다고 적었고, 올릴 때는 npm update -g 말고 아래 줄을 쓰라고 해요.

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

이 줄은 클로드 코드의 가장 새 버전을 npm 으로 다시 깔아 덮어쓰는 명령이에요.

npm 방식은 직접 겪은 일이 하나 있어요. npm 으로 깐 PC 에서 10월 7일에 claude update 를 돌렸더니 “npm global folder isn’t writable”, “Unable to fetch latest version from npm registry” 라는 글과 함께 실패했어요. 관리자 권한으로 해도 같았어요. 실제로는 폴더에 쓰는 것도 npm 저장소 연결도 멀쩡했고, 위의 npm install 줄로 직접 올리니 2.1.211 에서 2.1.292 로 바로 올라갔어요. 제 생각에는 새로 까는 분이라면 문서가 권하는 설치 스크립트 쪽이 손이 덜 가요.

npm 방식에서는 PowerShell 이 “running scripts is disabled on this system” 이라며 막는 일도 문서에 나와 있어요. PowerShell 의 실행 정책이 npm 이 만든 .ps1 실행 파일을 막는 건데, 설치 스크립트 방식에는 해당하지 않는다고 적혀 있어요.

터미널이 손에 익으면 자주 쓰게 되는 것들이에요.

• claude “할 일”: 켜면서 첫 요청을 같이 보내요. 문서의 예는 claude “fix the build error” 예요.
• claude -p “질문”: 대화 창을 열지 않고 한 번 묻고 답만 받고 끝나요.
• 입력 칸에서 / 를 치면 쓸 수 있는 명령과 스킬 목록이 떠요.
• 위쪽 화살표는 앞서 보낸 글을 다시 불러와요.
• Shift+Tab 은 권한 모드를 돌려 가며 바꿔요. 권한 모드는 클로드가 묻지 않고 할 수 있는 일의 범위를 정하는 설정이에요.

프롬프트를 쓰는 요령도 문서에 있어요. “fix the bug” 처럼 뭉뚱그리지 말고 “로그인할 때 틀린 비밀번호를 넣으면 빈 화면이 뜨는 오류를 고쳐 줘”처럼 무엇이 어떻게 잘못됐는지 적으라는 것, 큰일은 1·2·3 으로 나눠 적으라는 것, 고치기 전에 먼저 살펴보게 하라는 것 세 가지예요.

더 깊이

설치가 끝나면 그다음은 “덜 묻게, 덜 쓰게, 내 방식대로” 만드는 일이에요. 하나씩 따로 다룬 글이 있어요.

하고 싶은 것	볼 글
권한 확인 창이 너무 자주 뜸	권한 설정 allow·ask·deny
큰일을 계획부터 세우게	plan 모드 단축키와 승인 창
알아서 진행하게 두기	auto 모드가 막는 것
한도가 빨리 참	사용량 아끼는 법 모음
반복하는 일을 묶기	스킬 만들기
매번 돌아야 할 일 걸기	훅(hooks)

설정은 settings.json 이라는 파일에 적어요. 설치 문서에 나오는 것만 짚으면, 업데이트를 한 주쯤 늦게 받는 안정 채널로 바꾸는 autoUpdatesChannel, 자동 업데이트를 끄는 DISABLE_AUTOUPDATER, Git Bash 자리를 알려 주는 CLAUDE_CODE_GIT_BASH_PATH 가 있어요. 처음에는 손댈 일이 없고, 채널은 클로드 코드 안에서 /config 로도 바꿀 수 있어요.

회사에서 여럿이 쓴다면 프록시와 회사 인증서를 환경 변수로 넣는 법이 네트워크 설정 문서(network-config)에 따로 있어요. HTTPS_PROXY, NO_PROXY, NODE_EXTRA_CA_CERTS 같은 이름이 거기 나와요. SOCKS 방식 프록시는 지원하지 않는다고 적혀 있어요.

코덱스·다른 CLI 는

터미널에서 쓰는 다른 코딩 AI 도 설치 모양은 비슷해요. 윈도우 기준으로 각 회사 문서에 적힌 것만 옮겼어요.

도구	윈도우에 까는 길	필요한 것	로그인·요금제
클로드 코드	PowerShell 설치 스크립트, WinGet, npm	윈도우 10 1809 이상. npm 은 Node.js 22 이상	브라우저 로그인. Pro 부터, 무료 안 됨
코덱스 CLI (OpenAI)	PowerShell 설치 스크립트, npm	CLI 문서에 조건 없음(미확인)	Sign in with ChatGPT 또는 API 키. 가격 문서는 Plus 칸부터 CLI
안티그래비티 CLI (구글)	PowerShell 설치 스크립트, CMD 용 스크립트	macOS·Linux·Windows. 그 밖은 미확인	개인 구글 계정. 요금제 없이도 됨

출처: 클로드 코드 문서 setup, OpenAI 코덱스 CLI 문서·인증 문서·가격 문서(이상 10월 8일 확인), 안티그래비티 문서 Getting started·Installation and auth(10월 7일 확인).

윈도우 설치 명령은 각 문서에 이렇게 나와 있어요. 상자 하나가 도구 하나라서, 깔 도구의 상자만 복사하세요.

코덱스 CLI(새 PowerShell 창에서):

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

안티그래비티 CLI(PowerShell):

irm https://antigravity.google/cli/install.ps1 | iex

문서끼리 말이 조금 다른 칸이 한 군데 있어요. 코덱스는 가격 문서의 Plus 칸부터 “웹·CLI·IDE 확장·iOS 에서 Codex”라는 줄이 나오는데, 문서 목록에 붙은 그 문서 소개 줄은 Free·Go 요금제에도 Codex 가 들어 있다고 적었어요. Free·Go 로 CLI 가 되는지는 딱 잘라 적힌 곳을 찾지 못했어요.

제미나이 CLI 는 표에서 뺐어요. 2026년 6월 18일부터 개인 구글 계정과 Google AI Pro·Ultra 로는 쓸 수 없고 그 자리를 안티그래비티 CLI 가 이어받았기 때문이에요. 제미나이 CLI 설치 문서에는 지금도 npm install -g @google/gemini-cli 와 Node.js 20 이상, 윈도우 11 24H2 이상이라는 조건이 남아 있어요. 옮기는 법은 안티그래비티 CLI 설치·로그인 글에, 세 도구의 기능을 비교한 표는 클로드 코드·코덱스·제미나이 CLI 비교 글에 있어요.

한국에서 되나

돼요. 설치 문서는 쓸 수 있는 곳을 “Anthropic 지원 국가”로 적었고, 그 목록에 South Korea 가 들어 있어요. Pro·Max 요금제도 한국에서 가입돼요.

궁금한 것	공식 문서에 적힌 것
한국에서 되나	됨(지원 국가 목록에 South Korea)
무슨 요금제	Pro·Max·Team·Enterprise·Console. 무료 안 됨
한국어 문서	있음(code.claude.com/docs/ko)
한국에서 열린 날짜	공식 안내 없음
지원 안 하는 나라에서 깔면	App unavailable in region 이 뜸

출처: 클로드 코드 문서 setup·troubleshoot-install, anthropic.com 지원 국가 목록. 10월 8일 확인.

이 글의 내용은 2026년 10월 8일 기준이에요. 설치 명령과 버전 숫자는 바뀔 수 있으니, 명령이 듣지 않으면 공식 설치 문서의 지금 명령을 먼저 보세요.

같이 보면 좋은 글: 클로드 Pro Max 차이: 22달러·110달러·220달러, 클로드 코드 쓰는 양 따라 고르기

같이 보면 좋은 글: 클로드 코드 권한 설정 allow·ask·deny: 규칙 적는 형식과 덜 묻게 하는 방법

같이 보면 좋은 글: 클로드 코드 사용량 아끼는 법: 대화·캐시·서브에이전트부터 스킬·훅·권한 설정까지

같이 보면 좋은 글: AI 비교 2026: 클로드·챗GPT·제미나이 요금제·한도·기능 표

같이 보면 좋은 글: 코덱스 CLI 설치, 윈도우에서 처음 해 본다면: 터미널 열기부터 로그인·첫 요청까지

같이 보면 좋은 글: 제미나이 CLI 설치 윈도우 초보용: 지금은 안티그래비티 CLI, 터미널 열기부터 첫 요청까지

같이 보면 좋은 글: 클로드 코드 깃 커밋·PR 맡기는 법: 연습 폴더부터 /diff·push 막기·서명 줄까지

같이 보면 좋은 글: 클로드 코드 오류 해결: 529·Prompt is too long·로그인 오류 뜰 때 할 일

참고한 자료

2026년 10월 8일에 확인했어요. 클로드 코드 문서는 영어 문서와 한국어 문서(/docs/ko/)를 같이 봤어요.

• Advanced setup (클로드 코드 공식 문서, 준비물·설치 명령·윈도우 설정·확인·업데이트·npm)
• Quickstart (클로드 코드 공식 문서, 첫 실행·로그인·첫 질문·필수 명령)
• Terminal guide for new users (클로드 코드 공식 문서, 윈도우 순서와 자주 나는 오류)
• Troubleshoot installation and login (클로드 코드 공식 문서, 오류 표·PATH·TLS·프록시·로그인)
• Authentication (클로드 코드 공식 문서, 로그인 순서와 계정 종류)
• Security (클로드 코드 공식 문서, 폴더 신뢰 확인 창과 홈 폴더)
• Configure permissions (클로드 코드 공식 문서, Project allow rules and workspace trust)
• Interactive mode (클로드 코드 공식 문서, Ctrl+C·Ctrl+D)
• Commands (클로드 코드 공식 문서, /exit·/login·/theme·/help)
• Configure your terminal (클로드 코드 공식 문서, /theme 과 /config)
• Enterprise network configuration (클로드 코드 공식 문서, 프록시·회사 인증서)
• Supported countries (Anthropic, South Korea)
• Codex CLI (OpenAI 공식 문서, 설치 명령과 첫 로그인)
• Authentication (OpenAI 공식 문서, Sign in with ChatGPT·API 키)
• Pricing (OpenAI 공식 문서, 요금제 칸별 Codex)
• Gemini CLI installation (제미나이 CLI 공식 문서, 5월 14일 수정, 조건과 6월 18일 알림)
• Installation and auth (안티그래비티 공식 문서, 10월 7일 확인)