요즘 누구나 아주 간단하게 앱을 만들수가 있는데요. 다양한 AI 도구들 때문인데요. 최근에 제가 사용을 하고 있는 것중에 하나가 바로 OpenAI 의 Codex 입니다. ChatGPT 사이트에서 왼쪽에 있는 사이드바에서 직접 Codex 를 사용을 할수도 있지만 Visual Studio 에서 쉽게 Extention 으로 설치 한후에 API 키 발급 없이 로그인 한번 해주면 쉽게 IDE 환경에서도 사용을 할수가 있습니다. 

일단, 기존에 사용했던 Claude Code 와 어떤점이 다른지는 조금더 사용을 해봐야 할거 같지만, Claude Code 에서 개발하던 코드 그대로를 Codex 로 가지고 와서 이어서 해보는 중입니다. 그러다가 문제가 하나 생겼는데요. 바로 한글이 깨지는 현상이 있다는 건데요. 

Visual Studio Code 에서 Codex 사용시 한글이 있다면 코드 깨짐 주의

처음에는 아무런 생각없이 Codex 에 이것저것 요청을 하면서 작업을 하다가 갑자기 실행이 안되는 순간이 찾아 왔습니다. 잘 되다가 갑자기 안되어서 상당히 난감했는데요. 어이없는 상황에 처하게 됩니다. 바로 주석이나, 텍스트중에 존재하는 한글로 인해서 코드가 깨지는 현상이 있는건데요. 

이건 한글이 많이 포함이 되어 있을수록 더 심하게 깨지는거 같습니다. 코드가 짧을 경우에는 어떻게 해서든 복구를 해볼수도 있겠지만 그렇지 않은 경우에는 정말 복구 하기에도 난애한 상황이더라구요. 

아래 보시는 것처럼 한글로 되어 있는 것들이 많이 손상이 되어 있는것을 볼수가 있습니다. 이 상태에서는 인코딩 문제때문에 실행이 안되기도 하지만 깨진 한글로 인해서 문법 오류가 발생을 하기도 합니다. 하지만 이 상태에서 한번 적용을 완료했다면 복구가 불가능합니다. 

Visual Studio Code 에서 OpenAI Codex 사용 할 때 한글이 깨지는 경우1

한글이 깨진 경우 복구 할수 있는 방법은?

그렇다면 실제로 Visual Studio Code 에서 Codex 로 작업을 하다가 한글이 깨진 경우 어떻게 해야 할까요? 이것저것 찾아 보다보니 복구 할수 있는 방법은 백업본이 없다면 불가능 하다는겁니다. 저는 원래 프로젝트 폴더 안에 백업용 폴더를 만들어서 거기에 백업을 해놓았었는데... 그것도 한글이 모두 깨진 상태로 있습니다. ^^;

이렇게 백업이 존재 하지 않는다면 간단하게 복구 할수 있는 방법은 없는거 같습니다. 물론 전문가 분들은 방법이 있을지도 모르겠습니다. 

그래서 저 같은 경우에는 계속 해서 한글을 복구해 달라는 요청을 해서 복구를 했습니다. 이때 기존과 완벽하게 동일한 코드로 복구가 안되는 경우도 많이 있습니다. 그래서 기능 자체가 변경이 되거나 하는 경우도 있더라구요. 

어쨌든 이 방법도 먹힌다는 사실을 알아 두시면 좋을거 같습니다. 

한글이 깨지는 현상 방지 하기

그러면 한글이 깨지는 현상을 어떻게 방지를 하면 좋을까요? 인터넷에 찾아 보다 보니 제일 간단한 방법이 하나 있어서 그 방법으로 해결을 했습니다. 이 방법을 적용을 하니 일단, 적용후에는 한글이 깨지거나 하는 적은 없었습니다.

일단, 아래와 같이 윈도우11 에서 시작 버튼을 누르신후에 국가로 검색을 합니다. 검색을 하시면 최적의 일치쯤에 "국가 또는 지역" 이 뜨는걸 볼수가 있습니다. 이걸 클릭을 합니다. 

그럼 아래 우측 이미지에서 보시는것처럼 국가 또는 지역 창이 열리게 되는데요. 여기에서 관리자 옵션 탭을 클릭을 합니다. 그리고 그중에서 아래쪽에 있는 시스템 로컬 변경 이라고 되어 있는 부분이 있습니다. 

Visual Studio Code 에서 OpenAI Codex 사용 할 때 한글이 깨지는 경우2Visual Studio Code 에서 OpenAI Codex 사용 할 때 한글이 깨지는 경우3

시스템 로컬 변경이라고 되어 있는 버튼을 클릭을 하시면 아래와 같은 차잉 하나 열기게 됩니다. 기본적으로 현재 시스템 로캘은 한국어로 되어 있습니다. 

그리고 중요 한것은 여기에 아래에 있는 "Beta: 세계 언어 지원을 위해 Unicode UTF-8 사용" 이라고 되어 있는 부분을 체크를 해주시면 됩니다. 이렇게 해주신후에 적용을 위해서는 윈도우를 재시작 해주셔야 합니다. 

Visual Studio Code 에서 OpenAI Codex 사용 할 때 한글이 깨지는 경우4

이렇게 설정을 하시면 이제 Visual Studio Code 에서 Codex 를 사용을 하더라도 한글이 깨져서 코드를 복구 해야 하는 일은 생기지 않을겁니다. 저도 아직까지는 다시 동일한 증상이 발생하지 않고 있네요. Codex 를 사용을 하다가 저랑 비슷한 문제를 겪으신 분들은 참고를 하셔서 적용을 하신후에 사용해 보시기 바랍니다. 그럼 이만 포스팅 마치도록 하겠습니다.