Codex
OpenAI의 데스크톱 앱은 Windows에서 Codex 작업을 지원합니다. 다만 CLI(Command Line Interface·명령줄 도구) 쪽은 아직 실험 단계라 WSL이 필요할 수 있습니다. 앱과 CLI는 설치 방법이 다르다는 점만 기억하세요.
가장 단순한 시작처음이면 데스크톱 앱에서 작은 로컬 폴더를 열고, CLI가 필요한 자동화는 WSL 포함 여부를 따로 판단합니다.
Windows AI 실전 Lab · 2026.7.15 확인
Mac과 조금 다른 Windows 환경,
당황하지 마세요
같은 AI 도구라도 셸(shell·명령을 입력하는 창), 경로, 권한, 동기화 폴더가 다르면 설치법과 오류 복구가 달라집니다. 어떤 도구가 최고인지보다, 내 Windows 환경에서 안전하게 시작해 결과를 확인하는 순서가 먼저입니다.
OS Windows 10·11셸 PowerShell · Git Bash · WSL수준 입문–중급시간 25분비용 가이드 무료
01 · 환경 선택
도구를 설치하기 전에 셸부터 정합니다
한 프로젝트 안에서 PowerShell·Git Bash·WSL(Windows 안에서 Linux를 쓰는 기능)을 무심코 섞으면 같은 명령도 다른 결과를 냅니다.| 환경 | 강점 | 주의점 | 추천 시작 |
|---|---|---|---|
| PowerShell | Windows 파일·Office·관리 명령과 자연스럽게 연결 | 환경변수·따옴표 문법이 달라, Bash 예제를 그대로 붙여넣으면 오류가 나기 쉬움 | 기본값 |
| Git Bash | Bash 명령과 Git 중심 문서를 비교적 그대로 사용 | 일부 Windows 프로그램의 경로·터미널 입출력(TTY) 동작이 다를 수 있음 | Claude Code·Bash 튜토리얼 |
| WSL | Linux 도구·패키지·권한 모델이 필요한 프로젝트 | Windows와 WSL 파일시스템을 오가면 속도·권한·경로 문제가 생김 | Linux 의존 개발 |
| 데스크톱 앱·IDE | 셸 설치보다 UI에서 프로젝트와 작업을 관리 | CLI와 기능·제약이 같다고 생각하면 안 됨 | Codex 앱·Antigravity |
02 · 도구별 시작
4가지 도구, 서로 다른 Windows 접근방법
지원 상황은 바뀔 수 있습니다. 아래 표기는 2026년 7월 15일 공식 문서를 기준으로 확인했습니다.Claude Code
공식 시작 문서는 Windows에서 WSL 1·2 또는 Git for Windows가 제공하는 Git Bash를 지원 경로로 제시합니다. PowerShell에 Bash 명령을 섞기보다 프로젝트의 기본 셸을 먼저 고정하세요.
가장 단순한 시작Bash 예제를 많이 따라갈 입문자는 Git Bash, Linux 도구 체인이 필요한 개발 프로젝트는 WSL이 이해하기 쉽습니다.
Gemini CLI
공식 명령 문서는 Windows에서 PowerShell과 Windows 경로를 다룹니다. FAQ는 Unix의 chmod 명령이 Windows에서 동작하지 않는 사례와 icacls·Git Bash·WSL 같은 대안을 설명합니다.
가장 단순한 시작PowerShell에서 시작하되, 문서의 예제가 chmod·export를 사용하면 Windows용 명령인지 먼저 확인합니다.
Antigravity
Windows 설치 절차는 공식 입문 자료(Codelab)에 정리돼 있습니다. 브라우저와 에디터를 오가며 일하는 방식이 장점이지만, 처음부터 큰 프로젝트보다 복원 가능한 샘플로 권한과 실행 범위를 확인하세요.
가장 단순한 시작새 폴더에서 작은 웹앱을 만들고, 생성 파일·명령·브라우저 결과를 각각 검토하는 방식으로 익힙니다.
03 · 10분 사전 점검
설치보다 먼저 현재 상태를 기록합니다
터미널이 처음이라면: 시작 버튼을 누르고 ‘PowerShell’을 검색해 Enter를 누르면 아래와 같은 창이 열립니다. 명령은 한 줄씩 복사해 붙여넣고 Enter로 실행하세요. 실행 정책을 임의로 바꾸거나 관리자 권한으로 먼저 실행하지 않습니다.Windows PowerShell
# 1. 지금 쓰는 PowerShell 버전 확인
PS C:\Users\jimin> $PSVersionTable.PSVersion
Major Minor Build Revision ----- ----- ----- -------- 5 1 26100 4652
# 2. git·node·npm이 설치돼 있는지 확인
PS C:\Users\jimin> Get-Command git, node, npm -ErrorAction SilentlyContinue
CommandType Name Version Source ----------- ---- ------- ------ Application git.exe 2.47.0.2 C:\Program Files\Git\cmd\git.exe Application node.exe 22.14.0 C:\Program Files\nodejs\node.exe Application npm.cmd 10.9.2 C:\Program Files\nodejs\npm.cmd
ℹ 아무것도 나오지 않으면 그 프로그램이 아직 설치되지 않았거나 PATH에 등록되지 않은 것입니다.
# 3. 내가 지금 어느 폴더에 있는지 확인
PS C:\Users\jimin> Get-Location
Path ---- C:\Users\jimin
# 4. 작업 폴더의 Git 변경 상태 확인
PS C:\Users\jimin> git status --short
M content/posts/draft.md
ℹ 아무것도 나오지 않으면 변경된 파일이 없다는 뜻입니다. 이것도 정상입니다.
# 5. 실행 정책은 바꾸지 말고 현재 값만 확인
PS C:\Users\jimin> Get-ExecutionPolicy -List
Scope ExecutionPolicy ----- --------------- MachinePolicy Undefined UserPolicy Undefined Process Undefined CurrentUser Undefined LocalMachine RemoteSigned
# 6. 한글 파일명이 깨져 보이지 않게 Git 출력 설정
PS C:\Users\jimin> git config --global core.quotepath false
ℹ 아무 메시지도 나오지 않으면 성공입니다. 터미널은 성공했을 때 조용한 경우가 많습니다.
처음 설치와 빌드는 동기화 드라이브 밖의 짧은 경로에서 시험합니다.
관리자 권한은 오류 원인을 확인한 뒤 필요한 명령에만 사용합니다.
복원 가능한 샘플 폴더에서 읽기→수정→검증 흐름을 먼저 익힙니다.
.env, 키, 고객 자료를 넣기 전 도구의 전송·보존 정책을 확인합니다.
04 · 오류 대응
Windows에서 자주 만나는 6가지 Pain Point
오류 메시지를 숨기지 말고 ‘어느 셸·어느 경로·어느 명령’에서 났는지 함께 기록합니다.명령을 찾을 수 없음
주된 원인PATH 또는 설치 셸이 다름
첫 대응Get-Command로 실제 실행 파일 위치를 확인하고 터미널을 새로 엽니다.
한글·공백 경로에서 실패
주된 원인따옴표 누락 또는 도구의 Unicode 처리
첫 대응절대경로를 큰따옴표로 감싸고, 재현되면 C:\work 같은 짧은 로컬 경로에서 시험합니다.
EPERM · EBUSY · EBADF
주된 원인OneDrive·Google Drive 동기화, 백신, 다른 프로세스의 파일 잠금
첫 대응원본을 보존한 채 로컬 임시 작업 폴더에서 설치·빌드를 재현합니다.
chmod · export가 안 됨
주된 원인Unix 명령을 PowerShell에서 실행
첫 대응문서를 사용 중인 셸 문법으로 번역하거나 Git Bash·WSL에서 실행합니다.
글자가 깨짐
주된 원인UTF-8 출력·파일 인코딩 불일치
첫 대응터미널 출력 인코딩과 파일의 UTF-8 여부를 각각 확인합니다.
WSL에서는 되는데 Windows 앱에서 안 됨
주된 원인두 환경의 경로·도구·권한이 분리됨
첫 대응프로젝트 파일과 실행 도구를 한 환경에 모으고 경계 이동을 최소화합니다.
05 · 첫 실습
25분 안에 ‘검증된 작은 변경’ 하나 만들기
설치 성공이 아니라 작업 결과를 사람이 확인하고 되돌릴 수 있어야 실습이 끝납니다.- 5분
샘플 폴더를 고릅니다
민감정보가 없고 Git 상태가 깨끗한 작은 프로젝트를 준비합니다.
- 5분
변경 계약을 씁니다
수정할 파일, 바꾸지 않을 것, 완료 조건, 실행할 검증 명령을 네 줄로 적습니다.
- 10분
한 도구에 맡깁니다
예: README에 Windows 시작 절차 한 단락 추가. 범위를 넓히지 못하게 명시합니다.
- 5분
diff와 검증을 읽습니다
변경 파일, 명령 결과, 남은 위험을 확인하고 문제가 있으면 복원합니다.