Windows 11 환경에서, Claude Code GUI / Codex GUI를 설치하고 사용하기 위한 셋업 과정.
# `1. OpenAI에서 권장하는 Useful developer tools 설치`
OpenAI의 Codex 문서 (https://developers.openai.com/codex/app/windows) 에서 권장하는 셋업을 설치.
`Git` https://git-scm.com/install/windows
`Node.js` https://nodejs.org/ko/download
- Node.js 설치 완료 후 추가적으로 스크립트를 실행해서 Addon을 설치할 것이냐고 물어보는데, 설치함.
`Python` https://www.python.org/downloads/windows/
- Node.js에서 Python 3.14.7이 설치 되어있을텐데, 다른 버전이 필요하다면 설치.
`DotNet SDK 10` https://dotnet.microsoft.com/ko-kr/download/dotnet/10.0
---
### `2-1. PowerShell 7 설치`
PowerShell 7을 설치하는 이유는 기본 탑재된 PowerShell 5 버전보다 훨 낫기 때문. 특히 한국어 환경에서 인코딩이 깨지는 경우가 많은데, PowerShell 7을 사용하면 기본적으로 UTF-8 인코딩을 사용해서 문제가 생기지 않음.
`PowersShell 7` https://github.com/PowerShell/PowerShell/releases/
- Preview 버전 말고, Release 버전으로 `PowerShell-*-win-x64.msi` 설치.
### `2-2. rg grep 설치`
PowerShell에서 사용하는 도구. Claude Code / Codex가 파일을 탐색할 때 많이 사용함. (https://github.com/burntsushi/ripgrep)
```PowerShell 7
choco install ripgrep
```
---
### `3. 마무리 과정`
`vc-redist` https://learn.microsoft.com/ko-kr/cpp/windows/latest-supported-vc-redist?view=msvc-170
([direct](https://aka.ms/vc14/vc_redist.x64.exe))
- Node.js install 때 설치되어 있을수도 있음.
`Claude Code GUI` https://code.claude.com/docs/ko/desktop
`Codex GUI` https://chatgpt.com/ko-KR/download/
---
### `4. 개인적인 별도 셋업`
`Go Lang` https://go.dev/dl/
`Wails-2`
```PowerShell
go install github.com/wailsapp/wails/v2/cmd/wails@latest
```
`WebView2` https://developer.microsoft.com/ko-kr/microsoft-edge/webview2?form=MA13LH&cs=3181348501
- Windows 11에는 기본 탑재되어있는데, 확인하고 싶으면 PowerShell에서 `wails doctor` 명령어로 확인.
##### Claude Code Subagent 설정
`C:\Users\USER_NAME\.claude\settings.json`
```
{
"enableWorkflows": false,
"env": {
"CLAUDE_CODE_SUBAGENT_MODEL": "claude-opus-5"
}
}
```
> - 동적 워크플로우 Off : 토큰 부담.
> - 서브에이전트 OPUS 5로 강제 설정 : Fable 5 사용의 경우 서브에이전트도 Fable 5로 호출해서 토큰 부담되므로, Opus 5로 강제 설정.