홈 › AI 활용 › 세팅 안내서 (윈도우)

윈도우에서
클로드 코드 세팅 안내서

윤아2026년 10월 24일윈도우 기준

맥 안내서에서 쓴 cmux는 맥에서만 돌아가요. 그래서 윈도우는 길이 조금 달라요. 코딩을 몰라도 따라 할 수 있게, 윈도우에서 클로드 코드를 쓰는 두 가지 길을 정리했어요.

먼저 털어놓을게요. 저는 맥을 써서 이 글의 윈도우 화면을 직접 찍어 보지는 못했어요. 대신 명령과 메뉴 이름은 전부 공식 문서(2026년 10월 24일)로 하나하나 확인했어요. 따라 하다 다른 화면이 나오면 메일로 알려 주세요. 바로 고칠게요.

맥을 쓴다면

cmux + 클로드 코드 + 명령 한 줄 설치킷

맥 안내서로 가기 →

윈도우를 쓴다면

클로드 데스크톱 앱, 또는 윈도우 터미널 + 클로드 코드

이 글을 그대로 따라 하세요

이 글의 순서

준비물
두 갈래 중 고르기
쉬운 길: 클로드 데스크톱 앱
다 쓰는 길: 윈도우 터미널 + 클로드 코드
윈도우 터미널 단축키
코덱스도 같이 쓰려면

부록: 막히는 곳

1. 준비물

윈도우 PC: 윈도우 10(1809 버전 이상) 또는 윈도우 11, 64비트, 메모리 4GB 이상. 관리자 권한은 없어도 돼요.
클로드 유료 요금제: 프로, 맥스, 팀, 엔터프라이즈 중 하나. 무료 요금제로는 클로드 코드를 못 써요. 프로가 월 20달러예요(2026년 10월 기준, 세금 별도).

2. 두 갈래 중 고르기

윈도우에서 클로드 코드를 쓰는 길은 둘이에요.

클로드 데스크톱 앱의 Code 탭: 앱 하나만 깔면 끝. 처음이라면 이쪽을 추천해요.
윈도우 터미널 + 클로드 코드: 글자 화면이지만 클로드 코드 명령을 전부 쓸 수 있고, 코덱스 같은 다른 AI도 옆에 띄울 수 있어요.

	1) 데스크톱 앱	2) 윈도우 터미널
설치	앱 하나	명령 한 줄 + 글꼴, 설정은 손으로
화면	채팅 창, 바뀐 내용 비교 화면	글자 화면(터미널)
쓸 수 있는 AI	클로드만	클로드 코드, 코덱스 등 터미널에서 도는 AI 다 같이
명령어	일부 명령은 안 돼요	클로드 코드 명령 전부
추천	처음 써 보는 분	터미널에 익숙해졌거나 여러 AI를 같이 쓰고 싶은 분

둘 다 깔아도 돼요. 같은 계정, 같은 설정 파일을 읽어서 번갈아 써도 괜찮아요.

3. 쉬운 길: 클로드 데스크톱 앱

claude.com/download에서 윈도우용을 받아 설치해요.
앱을 열고 클로드 계정으로 로그인해요.
왼쪽 사이드바 맨 위의 Code 탭을 눌러요. 클로드 코드가 앱 안에 들어 있어서 따로 깔 건 없어요.
작업할 폴더를 고르고, 한국어로 부탁하면 돼요.

폴더가 곧 작업실이에요. 클로드 코드는 고른 폴더를 작업실로 써요. 그 안의 파일은 바로 읽고 고치고, 바깥 파일은 건드리기 전에 먼저 물어봐요. 그래서 일마다 폴더를 따로 만들어 두면 편해요. 블로그 글은 "블로그" 폴더, 가계부 앱은 "가계부" 폴더처럼요.

앱으로 충분하다면 여기까지만 하셔도 돼요. 한국어 답변이나 대화 기록 보관 기간을 바꾸고 싶다면 4장의 기본 설정만 따라 해 주세요. 앱도 같은 설정 파일을 읽어요.

4. 다 쓰는 길: 윈도우 터미널 + 클로드 코드

4-1. 터미널 열기

키보드에서 ⊞ Windows + X를 누르고, 메뉴에서 터미널(또는 Windows PowerShell)을 골라요. 윈도우 터미널이 없다면 Microsoft Store에서 "Windows Terminal"을 받아요.

4-2. 클로드 코드 설치

터미널 창에 아래 명령을 붙여 넣고 Enter를 눌러요. 받는 동안 진행 표시가 안 나오니 끝날 때까지 기다려 주세요.

PowerShell에 붙여 넣기

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

끝나면 창을 닫고 새로 연 다음, 잘 깔렸는지 확인해요. 버전 숫자가 나오면 성공이에요.

claude --version

Git for Windows는 깔까요? 없어도 클로드 코드는 PowerShell로 돌아가요. 깔아 두면 클로드가 쓸 수 있는 도구가 조금 늘어나요. 처음에는 건너뛰어도 괜찮아요. (Git for Windows 받기)

4-3. 한글 글꼴

윈도우 터미널의 기본 글꼴(Cascadia Mono)은 영문용이라 한글은 윈도우가 다른 글꼴을 빌려 그려요. 그래서 줄이 들쭉날쭉해 보일 수 있어요. 한글 코딩 글꼴로 바꾸면 깔끔해져요. 네이버가 무료로 배포하는 D2Coding을 추천해요.

D2Coding 배포 페이지에서 가장 위에 있는 zip을 받아 풀어요.
안에 있는 .ttf 파일을 더블클릭하고 설치를 눌러요.
윈도우 터미널에서 Ctrl + ,로 설정을 열어요.
왼쪽 아래 프로필의 기본값 › 모양 › 글꼴에서 D2Coding을 고르고 저장해요.
터미널을 껐다 켜면 새 글꼴로 보여요.

4-4. 기본 설정 (한국어, 기록 보관, 비밀 파일 막기)

맥 설치킷이 넣어 주는 기본 설정을 윈도우에서는 손으로 넣어요. 파일 하나만 만들면 돼요. 아래 두 줄을 터미널에 붙여 넣으면 메모장이 열려요. "새 파일을 만들까요?"라고 물으면 예를 눌러요.

New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude" | Out-Null
notepad "$env:USERPROFILE\.claude\settings.json"

메모장에 아래를 붙여 넣고 저장해요.

settings.json 에 붙여 넣기

{
  "language": "korean",
  "cleanupPeriodDays": 365,
  "permissions": {
    "deny": [
      "Read(~/.ssh/**)", "Edit(~/.ssh/**)", "Read(~/.aws/**)",
      "Read(//**/.env)", "Read(//**/.env.*)"
    ]
  }
}

줄	하는 일
`language`	답변을 한국어로
`cleanupPeriodDays`	클로드 코드는 기본으로 30일이 지난 대화 기록을 말없이 지워요. 365일로 늘려 둬요
`deny`	비밀번호나 열쇠가 든 파일(`.ssh`, `.aws`, `.env`)을 AI가 못 읽게 막아요

메모장에 이미 내용이 있다면 덮어쓰지 말고 닫아 주세요. 예전에 클로드 코드 설정을 해 둔 거예요. 이때는 클로드 코드에게 "settings.json에 한국어 답변, 기록 365일 보관, 비밀 파일 읽기 금지를 더해 줘"라고 부탁하는 게 안전해요.

4-5. 처음 켜서 로그인하기

작업할 폴더를 만들고 들어가요. 문서 폴더 안에 "작업실"을 만든다면 이렇게요.
```
mkdir ~\Documents\작업실; cd ~\Documents\작업실
```
claude를 치고 Enter. 처음이면 브라우저가 열리고 로그인하라고 해요. 로그인하면 터미널로 돌아와요.
```
claude
```

첫 부탁을 해 봐요. 한국어로 그냥 말하면 돼요.

예시

이 폴더에 오늘 할 일 체크리스트 html 파일을 만들어 줘. 체크하면 줄이 그어지게.

5. 윈도우 터미널 단축키

cmux의 세로 탭 대신, 윈도우 터미널은 위쪽 탭과 창 나누기로 일을 나눠요. 탭 하나에 일 하나를 맡기면 편해요.

하고 싶은 것	단축키
새 탭	`Ctrl` + `Shift` + `T`
다음 탭으로	`Ctrl` + `Tab`
이전 탭으로	`Ctrl` + `Shift` + `Tab`
창을 좌우로 나누기	`Alt` + `Shift` + `+`
창을 위아래로 나누기	`Alt` + `Shift` + `-`
나눈 창 사이 옮겨 가기	`Alt` + 방향키
지금 탭(나눈 창) 닫기	`Ctrl` + `Shift` + `W`
설정 열기	`Ctrl` + `,`

전체 목록은 윈도우 터미널 공식 문서에 있어요.

6. 코덱스도 같이 쓰려면

코덱스는 오픈AI가 만든 코딩 AI예요. 챗GPT 계정으로 로그인해요. 윈도우 터미널에 아래를 붙여 넣으면 공식 설치 명령으로 깔려요.

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

깔고 나면 새 탭에서 codex를 치고 로그인해요. 한쪽 탭에는 클로드, 다른 탭에는 코덱스를 띄워 같은 일을 시켜 보세요. 코덱스는 윈도우 11을 권장하고, 윈도우 10에서도 돌아가요.

부록

막혔을 때만 펼쳐 보세요.

막히는 곳

'irm'은(는) 내부 또는 외부 명령이 아니라고 나와요

PowerShell이 아니라 명령 프롬프트(CMD)에 붙여 넣은 거예요. ⊞ Windows + X에서 터미널이나 Windows PowerShell을 열고 다시 붙여 넣어요.

claude 를 쳤는데 인식되지 않는다고 나와요

설치 직후의 창은 새 명령을 아직 몰라요. 터미널을 완전히 닫고 새로 열어서 다시 쳐 보세요. 그래도 안 되면 아래 두 줄을 PowerShell에 붙여 넣고, 다시 창을 닫았다 열어요. 클로드 코드가 깔린 곳(%USERPROFILE%\.local\bin)을 윈도우에 알려 주는 명령이에요.

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

&& 토큰이 올바른 문 구분 기호가 아니라고 나와요

명령 프롬프트(CMD)용 명령을 PowerShell에 붙여 넣은 거예요. 이 글의 명령은 전부 PowerShell용이니 이 글에 있는 것을 그대로 써 주세요.

옛날 윈도우 10에서 보안 연결(SSL) 오류가 나요

아래 한 줄을 먼저 붙여 넣고, 설치 명령을 다시 붙여 넣어요.

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

맥처럼 설치킷은 없나요?

아직 없어요. 시험해 볼 윈도우 PC가 없어서, 직접 확인하지 못한 걸 명령 한 줄로 내놓을 수는 없었어요. 대신 4-4의 설정 파일이 맥 설치킷의 핵심 설정과 같아요.

확인한 공식 문서 (2026년 10월 24일): 클로드 코드 설치, 설치 문제 해결, 데스크톱 앱 시작하기, 클로드 코드 설정, 윈도우 터미널 창 나누기, 윈도우 터미널 모양, D2Coding, 코덱스, cmux. 설치 명령이 바뀌면 이 글도 고쳐 둘게요.

윤아, 10년차 콘텐츠 마케터

글 쓰는 마케터에서 AI 쓰는 마케터로 전직 중이에요. 코딩을 모르는 채로 클로드 코드로 앱과 도구를 만들고, 그 과정을 브런치에 연재해요.

브런치링크드인it.is.yoona@gmail.com

윈도우에서클로드 코드 세팅 안내서