OPENAI CODEX · WINDOWS + VS CODE
설치부터 첫 코드 수정까지,
C# 개발자를 위한 Codex 시작 가이드
OpenAI Codex는 자연어 요청을 바탕으로 코드를 읽고 수정하며 테스트와 디버깅을 돕는 AI 코딩 에이전트입니다. 이 글에서는 Windows와 Visual Studio Code를 사용해 기존 C# / ASP.NET Core 프로젝트에서 작업을 시작하는 과정을 설명합니다.

VS Code 설치 → Codex 확장 설치 → 로그인 → 프로젝트 폴더 열기 → 작업 요청 → 변경 내용과 빌드 결과 확인
1. Codex로 할 수 있는 작업
개발자가 목표와 작업 범위를 설명하면 Codex가 관련 코드를 살펴보고 변경을 수행합니다. 실제 파일 수정과 명령 실행 범위는 연결된 작업 환경과 권한에 따라 달라집니다.
- 코드 이해: 프로젝트 구조, 요청 처리 흐름, 함수 역할 설명
- 기능 구현: 기존 코드에 맞춘 API와 화면 기능 추가
- 오류 수정: 오류 메시지와 관련 코드를 함께 분석
- 리팩터링: 중복 로직 정리와 가독성 개선
- 검증·문서화: 관련 테스트 작성, 변경 사항 설명, 사용 예제 정리
기존 Visual Studio에서는 빌드·디버깅을 계속하고, 같은 프로젝트 폴더를 VS Code에서 열어 Codex를 사용할 수 있습니다. 두 편집기에서 같은 파일을 동시에 수정할 때에는 저장 내용이 겹치지 않도록 확인하세요.
2. 설치 전 준비 사항
| 항목 | 확인할 내용 |
|---|---|
| Windows PC | 사용 중인 Windows 버전과 최신 확장의 지원 조건 확인 |
| Visual Studio Code | Microsoft의 공식 편집기 설치 |
| OpenAI Codex 확장 | 게시자가 OpenAI인지 확인 |
| 로그인 계정 | Codex를 이용할 수 있는 계정 및 이용 한도 확인 |
| .NET SDK | 프로젝트의 대상 프레임워크와 global.json에 맞는 SDK 설치 |
| C# 편집 지원 | 필요에 따라 Microsoft C# 확장 또는 C# Dev Kit 사용 |
| 프로젝트 폴더 | 소스 코드와 .csproj 또는 솔루션 파일이 있는 폴더 |
| 변경 이력 | Git 커밋 또는 별도 백업으로 작업 전 상태 보관 |
이 글은 VS Code 확장 방식을 기준으로 합니다. Codex CLI를 별도로 설치하는 과정과 혼동하지 마세요. 프로젝트 자체가 Node.js 도구를 사용하는 경우에는 해당 프로젝트의 요구 사항도 준비해야 합니다.
3. VS Code와 Codex 설치
3-1. Visual Studio Code 설치
- VS Code 공식 사이트에서 Windows 설치 파일을 받습니다.
- 설치 안내에 따라 진행한 뒤 VS Code를 실행합니다.
3-2. 공식 Codex 확장 설치
- VS Code에서 Ctrl + Shift + X를 눌러 확장 화면을 엽니다.
- 검색창에 Codex를 입력합니다.
- 게시자가 OpenAI인 확장을 선택합니다.
- Install을 눌러 설치합니다.

3-3. Codex 패널 열기
사이드바에서 Codex 아이콘을 선택합니다. 아이콘이 보이지 않으면 Ctrl + Shift + P로 명령 팔레트를 열고 다음 명령을 검색합니다.
Codex: Open Codex Sidebar
4. 로그인과 프로젝트 열기
4-1. ChatGPT 계정으로 로그인
- Codex 패널에서 Sign in with ChatGPT 등 표시된 로그인 항목을 선택합니다.
- 브라우저에서 사용할 계정으로 로그인하고 인증을 완료합니다.
- VS Code로 돌아와 Codex 패널이 정상적으로 열리는지 확인합니다.

로그인 화면과 메뉴는 확장 버전에 따라 달라질 수 있습니다. 이용 가능 여부와 사용 한도는 계정에 표시되는 안내를 확인하세요.
4-2. 작업할 폴더 선택
- File → Open Folder에서 기존 프로젝트 폴더를 엽니다.
- 왼쪽 탐색기에 소스 파일과 프로젝트 파일이 보이는지 확인합니다.
- 여러 프로젝트가 있다면 수정할 프로젝트와 시작 프로젝트를 구분합니다.
파일 하나만 여는 것보다 프로젝트의 소스와 설정을 함께 볼 수 있는 폴더를 열어야 구조를 파악하기 쉽습니다. 본인이 관리하고 신뢰하는 프로젝트에서 작업을 시작하세요.
5. 첫 작업 요청과 결과 확인
5-1. 먼저 프로젝트 구조 파악
이 프로젝트는 C# / ASP.NET Core 프로젝트입니다. 프로젝트 구조와 주요 실행 흐름을 설명해 주세요. 시작 프로젝트, API 엔드포인트, 데이터베이스 접근 코드를 찾아 주세요. 우선 파일은 수정하지 마세요.
5-2. 작은 범위의 수정 요청
이메일 입력값을 검증하는 코드를 찾아 수정해 주세요. 입력값 앞뒤 공백을 제거하고, 비어 있거나 잘못된 이메일 형식을 처리해 주세요. 기존 응답 형식과 정상 입력의 동작은 유지해 주세요. 수정 후 변경 파일과 검증 결과를 설명해 주세요.
오류를 해결하려면 오류 메시지, 발생 위치, 재현 순서, 기대 결과를 함께 전달하면 좋습니다. 운영 환경의 비밀번호나 API 키는 예제에서 제외합니다.
5-3. 변경 사항과 빌드 결과 확인
변경된 파일의 차이(diff)를 읽고 의도한 범위인지 확인합니다. VS Code 터미널에서 사용할 SDK를 확인하려면 다음 명령을 실행합니다.
dotnet --info
아래는 프로젝트 폴더에서 실행하는 예시입니다. 파일명은 실제 프로젝트에 맞게 바꾸세요.
dotnet restore .\MyApp.csproj dotnet build .\MyApp.csproj
테스트 프로젝트가 있다면 해당 프로젝트를 지정해 실행합니다.
dotnet test .\MyApp.Tests\MyApp.Tests.csproj
이 명령 예시는 .NET SDK 방식의 프로젝트를 기준으로 합니다. 기존 .NET Framework 프로젝트는 Visual Studio의 빌드 도구나 프로젝트별 빌드 절차가 필요할 수 있습니다.
6. 문제 발생 시 확인할 사항
| 항목 | 확인할 내용 |
|---|---|
| Codex 아이콘이 보이지 않음 | 확장이 설치·활성화되어 있는지 확인하고, 명령 팔레트에서 Codex 패널 열기 실행 |
| 로그인이 끝나지 않음 | 브라우저 인증 완료 여부, 로그인 계정, 회사 네트워크·프록시 제한 확인 |
| 프로젝트를 찾지 못함 | 올바른 폴더를 열었는지, 탐색기에 소스와 프로젝트 파일이 보이는지 확인 |
| dotnet 명령을 찾을 수 없음 | .NET SDK 설치 여부와 PATH 확인. 설치 후 터미널 또는 VS Code 다시 시작 |
| SDK 버전 오류 | global.json과 프로젝트 대상 프레임워크에 맞는 SDK 확인 |
| 파일 수정·명령 실행이 제한됨 | 현재 작업 모드, 허용된 폴더와 권한, 화면의 승인 요청 확인 |
| Windows에서 확장이 반응하지 않음 | 확장 오류와 공식 Windows 문제 해결 문서 확인. 필요한 네이티브 의존성 누락 여부 점검 |
- OpenAI 공식 확장을 설치했는가?
- 로그인 후 Codex 패널에서 대화할 수 있는가?
- 프로젝트 구조를 정상적으로 읽는가?
- 변경 파일과 빌드·테스트 결과를 확인했는가?
기존 캡처는 화면 예시입니다. 설치 화면, 기능과 이용 조건은 버전에 따라 달라질 수 있습니다.
공식 참고: Codex IDE 확장 안내 · Windows 실행 환경 및 문제 해결 · Visual Studio Code
