클로드 코드 · 코덱스 설치

오토프로그 1기 · 1강 수업자료. 쓰는 도구를 고르고, 명령을 한 줄씩 복사해 붙여넣고 Enter.

시작 메뉴 → Windows PowerShell 을 여세요. (CMD 아님 · (x86) 아님 · 관리자 권한 필요 없음)

1

Git 설치

winget install --id Git.Git -e --source winget

already installed 가 나와도 정상. 다음으로.

2

클로드 코드 설치

winget install --id Anthropic.ClaudeCode -e --source winget

Successfully installed 가 보이면 됩니다.

3

창을 완전히 껐다가 새로 열기

PowerShell 창을 닫고 새로 여세요. VS Code 안이라면 VS Code 창을 전부 끄고 다시. 이걸 안 하면 4번에서 claude 를 못 찾습니다.

4

실행

claude

브라우저가 열리면 클로드 계정으로 로그인. 안 뜨면 화면의 주소를 복사해 주소창에.

수업에서는 이렇게 켭니다 — 확인 창 없이 바로 실행되는 모드. 4번의 claude 대신 이걸 쓰세요.
claude --dangerously-skip-permissions

파일 수정·설치를 매번 묻지 않습니다. 남의 코드나 낯선 폴더에서는 그냥 claude 로.

설치가 끝났으면 — 나머지는 클로드·코덱스에게 시키세요

아래 글을 그대로 복사해 대화창에 붙여넣기. 내 컴퓨터가 맥인지 윈도우인지 보고 알맞게 깔아 줍니다.

A

Node.js

Node.js 가 깔려 있는지 확인하고, 없으면 LTS 버전으로 설치해 줘. 끝나면 버전을 알려 줘.
B

Vercel CLI · Supabase CLI — 2주차 배포·DB

Vercel CLI 와 Supabase CLI 를 설치해 줘. 둘 다 npm 전역 설치로 하면 돼. 설치 중에 나오는 경고(deprecated, 설치 스크립트 건너뜀 등)는 문제가 아니니 설명하지 말고, 끝나면 vercel --version 과 supabase --version 결과만 표로 보여 줘.

"esbuild 설치 스크립트가 실행되지 않았어요" 같은 안내가 떠도 정상입니다 — 요즘 npm 이 남의 설치 스크립트를 기본으로 막는데, esbuild 는 그 스크립트 없이도 돌아갑니다. 버전이 나오면 끝.

C

VS Code 확장 두 개 — 파일 아이콘 · 메뉴 한국어

VS Code 가 아직 없으면 위 「사이트 가입」 탭 4번에서 받아 설치한 뒤:

VS Code 확장 두 개 설치해 줘. pkief.material-icon-theme 하고 ms-ceintl.vscode-language-pack-ko. 끝나면 VS Code 를 껐다 켜라고 알려 줘.
D

상태줄 — 클로드 코드만

E 의 셋팅 스크립트가 상태줄(모델 · 컨텍스트 % 막대 · 5시간/주간 한도)을 자동으로 깔아 줍니다 — 창을 껐다 켜면 화면 아래에 보입니다. 코덱스는 기본으로 있어요.

모양을 바꾸고 싶을 때만 클로드 대화창에:

/statusline 모델 이름이랑 컨텍스트 사용률을 막대로 보여줘
E

전역 설정

클로드 코드/코덱스 전역 설정 페이지에서 호칭만 적고 스크립트를 복사해 붙여넣으면 끝. 윈도우는 「설치 스크립트 (윈도우)」 탭.

막혔을 때 — 화면 문구로 찾으세요

'claude' 또는 'codex' 를 찾을 수 없습니다 / is not recognized / command not found 설치한 그 창에서 바로 쳤을 때 납니다. 창을 완전히 닫고 새로 여세요. VS Code 는 창 전체를 끄고 다시. 맥은 ⌘Q. 그래도 안 되면 아래 어디에 깔렸는지 확인.
어디에 깔렸는지 확인 (윈도우)
where.exe claude

…\WinGet\Links\claude.exe 가 나오면 정상. 아무것도 안 나오면 아래를 넣고 창을 다시 껐다 켜세요.

[Environment]::SetEnvironmentVariable("Path","$env:LOCALAPPDATA\Microsoft\WinGet\Links;" + [Environment]::GetEnvironmentVariable("Path","User"),"User")

여러 줄이 나오면 예전 설치와 겹친 것 — .local\bin\claude.exe 는 옛 스크립트 설치본이니 그 파일을 지우고, npm 으로 깔았었다면 npm uninstall -g @anthropic-ai/claude-code. %USERPROFILE%\.claude 폴더는 지우지 마세요(로그인·설정).

claude 를 치면 데스크톱 앱이 열립니다 (첫 줄이 WindowsApps\Claude.exe) 클로드 데스크톱을 최신으로 올린 뒤, 설정 → 앱 → 고급 앱 설정 → 앱 실행 별칭 에서 Claude 항목을 끄고 창을 다시 여세요.
'winget' 을 찾을 수 없습니다 윈도우 10 구버전. Microsoft Store → 앱 설치 관리자(App Installer) 업데이트, 또는 윈도우 업데이트 후 다시.
Claude Code does not support 32-bit Windows Windows PowerShell (x86) 를 연 것. (x86) 이 안 붙은 쪽으로.
클로드가 Git Bash 를 못 찾는다고 합니다 (윈도우) Git 이 어디 깔렸는지 알려 줍니다. 아무 반응 없는 게 정상, 그 뒤 창을 다시 여세요.
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_GIT_BASH_PATH","$env:ProgramFiles\Git\bin\bash.exe","User")
코덱스: 이 시스템에서 스크립트를 실행할 수 없으므로 (윈도우) 설치 명령 앞의 powershell -ExecutionPolicy ByPass -c 를 빼고 친 것. 1번 명령 전체를 다시 복사.
맥: "손상되어 열 수 없습니다" / 실행하자마자 꺼짐
xattr -d com.apple.quarantine $(which codex)
맥: command not found (껐다 켜도)
export PATH="$HOME/.local/bin:$PATH"
회사 노트북이라 설치가 막힙니다 백신·보안 프로그램이 막는 경우. 혼자 우회하지 말고 정보보안 담당자에게: "Anthropic 의 Claude Code CLI 를 설치하려 합니다. claude.exe 와 이 프로그램이 실행하는 cmd.exe, bash.exe 를 예외 처리해 주세요."

확인 시점 2026-09-12 · 클로드 코드 winget 패키지 Anthropic.ClaudeCode · 코덱스 CLI 0.154.0 (--yolo 실측 통과). 그래도 안 되면 오류 메시지를 그대로 복사해 클로드에게 보여 주고 "이거 고쳐 줘".