VS Code에 Codex 연결하기

Codex 앱과 VS Code 확장은 다른 시작 경로입니다

이 글은 VS Code 안에서 Codex를 사용하는 경로입니다. 독립 데스크톱 앱이나 CLI를 먼저 설치하는 글이 아닙니다. VS Code 준비, 실습 폴더, 로그인 가능한 ChatGPT 계정을 준비하세요.

공식 문서에서 현재 지원하는 운영체제·편집기 조건과 계정 이용 범위를 확인합니다. Windows에서 별도 실행 환경 안내가 나온다면 공식 Windows 문서를 따릅니다. 처음부터 모든 사용자에게 WSL이나 별도 API 키가 필요하다고 가정하지 않습니다.

VS Code에서 code6office-practice 폴더를 엽니다.
확장 프로그램 화면을 엽니다. Mac은 Command+Shift+X, Windows는 Ctrl+Shift+X를 사용합니다.
OpenAI 공식 IDE 안내 · 영문의 VS Code 설치 링크에서 공식 Codex 확장으로 이동합니다.
공식 게시자와 확장 이름을 확인하고 설치합니다. 이름이 비슷하다는 이유로 다른 확장을 설치하지 마세요.
설치가 끝나면 Codex 아이콘을 선택합니다. 보이지 않으면 명령 팔레트에서 Codex: Open Codex Sidebar를 찾아 엽니다.
계정 로그인 안내에서 ChatGPT 계정으로 인증하는 경로를 선택합니다. 브라우저가 열리면 계정을 확인하고 인증한 뒤 VS Code로 돌아옵니다.
현재 계정의 이용 가능 상태를 확인합니다. 로그인에 성공했다고 모든 기능이 무료·무제한인 것은 아닙니다.

Codex 대화 입력칸에 다음처럼 말해보세요.

나는 개발을 처음 시작했어.
현재 작업 폴더와 파일 목록을 설명해줘.
열려 있는 파일이 다른 프로젝트에 속해 있다면 먼저 알려줘.
아직 파일 수정이나 명령 실행은 하지 말아줘.

예상한 폴더를 설명하면 다음 단계로 넘어갑니다. HTML 파일 하나 만들기를 따라 파일을 생성하고, 변경 비교 화면과 실제 브라우저 결과를 확인하세요.

현재 열린 파일과 선택한 코드가 요청의 맥락에 포함될 수 있습니다. 수정 대상이 맞는지 확인하고, 처음에는 여러 AI 도구가 같은 폴더를 동시에 수정하게 하지 않습니다.

Codex 아이콘이 없어요: 확장이 현재 VS Code 창에서 설치·활성화됐는지 확인하고 공식 명령으로 패널을 엽니다.
계정 이용 권한 오류: 로그인 계정·조직 정책·현재 이용 조건을 확인합니다. API 결제를 다시 시도하기 전에 인증 방식을 구분하세요.
폴더를 못 찾는다고 해요: 파일 하나만 연 상태인지 확인하고 폴더 열기로 다시 연결합니다.
Windows 환경 설정 안내가 나와요: 공식 문서에서 해당 환경 요구 사항을 확인하세요. 다른 운영체제의 터미널 명령을 복사하지 않습니다.
원치 않은 파일을 바꿨어요: 변경 목록을 검토하고 필요한 부분만 반영합니다. 승인 전에 대상 경로를 읽는 습관이 중요합니다.

종료 전에 파일 저장 상태를 확인하세요. 다음 날 같은 폴더에서 Codex 패널을 다시 열고, 이전 대화와 별도로 현재 파일 상태를 확인하게 요청합니다.

확인한 공식 문서는 영문으로 제공되어 언어를 표시했습니다. 안내는 한국어로 풀어썼으며, 이 글은 모든 PC에서 직접 설치해 검증한 기록은 아닙니다.