Visual Studio Code 에 Codex 를 사용하는 경우 적절한 터미널 사용 방법

현상

아래와 같이 Visual Studio Code를 윈도우 환경에서 구동한 후 Codex 플러그인을 사용하면 아래와 같이 메시지가 자주 나타난다(2026년 5월 기준).

Codex가 보낸 메시지

 

그래서 아래와 같이 해결 방법을 물어봤다.

질문 1

codex 플러그인에 잘 동작하는 터미널을 알려줘. 파워쉘은 계속 인코딩 등 너가 실수하는 것 같아.

답변 1

맞아요. 이 저장소 작업에서는 PowerShell이 가끔 한글/인코딩/와일드카드 처리에서 나를 미끄러지게 합니다. 특히 방금처럼 문서가 UTF-8인데 출력/패치 주변에서 깨져 보이는 일이 생기죠.

Codex 플러그인 기준으로 추천은:

1. Git Bash
   • 가장 추천합니다.
   • rg, sed, awk, grep, cat, git diff 같은 도구 사용이 자연스럽습니다.
   • 와일드카드도 docs/*.md처럼 예상대로 동작합니다.
   • Codex가 일반적인 Unix 스타일 명령을 실수 없이 쓰기 쉽습니다.
2. WSL Ubuntu
   • 가능하면 제일 안정적입니다.
   • 다만 Windows 경로/Playwright 브라우저/venv가 Windows 쪽에 묶여 있으면 약간 번거로울 수 있습니다.
   • Python 실행까지 WSL로 통일할 게 아니라면 Git Bash가 더 가볍습니다.
3. PowerShell
   • Windows 기본이라 편하지만, Codex 작업용으로는 덜 추천합니다.
   • 특히 한글 출력, glob 패턴, quoting, Get-Content 인코딩, heredoc 대체 문법에서 실수가 잦습니다.

제 추천 설정은 VS Code 기본 터미널을 Git Bash로 변경하는 것입니다.

질문 2

"한글/인코딩/와일드카드 처리에서 나를 미끄러지게 합니다." 같은 원인으로 토큰 사용량에도 차이가 있겠지?

답변 2

네, 꽤 차이 납니다.

PowerShell에서 한글/인코딩/와일드카드가 삐끗하면 토큰을 더 씁니다. 이유는 단순해요.

• 깨진 출력이 나오면 내가 같은 파일을 다른 방식으로 다시 읽어야 합니다.
• docs\*.md 같은 와일드카드가 예상과 다르게 실패하면 검색 명령을 다시 짜야 합니다.
• 패치가 문맥 매칭에 실패하면 더 좁은 문맥으로 여러 번 재시도합니다.
• 한글이 깨져 보이면 “실제 파일이 깨진 건지, 터미널 출력만 깨진 건지” 확인하는 추가 명령이 필요합니다.
• PowerShell 전용 문법과 Unix 스타일 명령 사이를 번역하면서 실수 가능성이 올라갑니다.

즉, 같은 작업이라도 Git Bash/WSL에서는 한 번에 끝날 명령이 PowerShell에서는 2~4번 왕복하는 경우가 생기고, 그만큼 도구 출력과 내 판단 설명이 늘어납니다. 토큰뿐 아니라 시간도 늘어나고요.

Codex 관점에서 토큰 효율은 보통 이렇게 봅니다:

1. WSL Ubuntu: 가장 안정적이고 토큰 낭비 적음
2. Git Bash: Windows 프로젝트와 잘 맞고 실용적으로 가장 추천
3. PowerShell: 가능은 하지만 quoting/encoding/glob 문제로 재시도가 늘 수 있음

이 저장소처럼 한글 문서가 많고 docs/*.md, rg, sed, git diff를 자주 쓰는 프로젝트는 Git Bash를 Codex 기본 터미널로 두는 게 토큰 사용량도 줄이는 방향입니다.

해결 방법

사실 이 문제가 제대로 해결되지는 않으나 완화시킬 수 있는 방법은 아래와 같다. 기본 터미널을 Git Bash로 변경하는 것이다. 먼저 아래의 경로에 있는 프로젝트 설정 파일을 연다.

./.vscode/settings.json

settings.json 파일 위치

아래의 값을 설정 파일에 추가한다.

"terminal.integrated.defaultProfile.windows": "Git Bash"

터미널 기본 정보가 입력된 화면

이렇게 설정한 후에 터미널을 다시 열면 아래처럼 Git Bash로 터미널이 열린 것을 확인할 수 있다.

Git Bash로 터미널이 열린 화면

이제는 Codex가 사용하는 기본터미널을 변경해야 한다. 아래의 경로에 가서 Codex 설정 파일을 연다.

%USERPROFILE%\.codex\config.toml

아래의 값을 Codex 설정 파일에 추가한다.

shell_path = "C:\\Program Files\\Git\\bin\\bash.exe"

터미널 정보가 Codex 전역 설정 파일에 추가된 화면

이렇게 하면 인코딩 문제는 덜 발생한다. 내 생각에는 Codex 플러그인 개선과 Codex AI의 개선이 필요하다고 생각한다. 시간이 지날 수록 개선이 되고 있다. 현재 필자는 다시 Powershell로 전환했다.