OpenAI Codex 설정 방법: Windows + VS Code에서 C# 프로젝트 시작하기

openai text on tv screen
Photo by Andrew Neel on Pexels.com

OPENAI CODEX · WINDOWS + VS CODE

설치부터 첫 코드 수정까지,
C# 개발자를 위한 Codex 시작 가이드

OpenAI Codex는 자연어 요청을 바탕으로 코드를 읽고 수정하며 테스트와 디버깅을 돕는 AI 코딩 에이전트입니다. 이 글에서는 Windows와 Visual Studio Code를 사용해 기존 C# / ASP.NET Core 프로젝트에서 작업을 시작하는 과정을 설명합니다.

코드가 표시된 컴퓨터 화면 — AI 코딩 작업 참고 이미지
개발 작업을 보여 주는 참고 사진이며 Codex 실행 화면은 아닙니다. 사진: Chris Ried / Unsplash
전체 순서

VS Code 설치 → Codex 확장 설치 → 로그인 → 프로젝트 폴더 열기 → 작업 요청 → 변경 내용과 빌드 결과 확인

1. Codex로 할 수 있는 작업

개발자가 목표와 작업 범위를 설명하면 Codex가 관련 코드를 살펴보고 변경을 수행합니다. 실제 파일 수정과 명령 실행 범위는 연결된 작업 환경과 권한에 따라 달라집니다.

  • 코드 이해: 프로젝트 구조, 요청 처리 흐름, 함수 역할 설명
  • 기능 구현: 기존 코드에 맞춘 API와 화면 기능 추가
  • 오류 수정: 오류 메시지와 관련 코드를 함께 분석
  • 리팩터링: 중복 로직 정리와 가독성 개선
  • 검증·문서화: 관련 테스트 작성, 변경 사항 설명, 사용 예제 정리
Visual Studio 2022와 함께 사용할 수 있습니다.

기존 Visual Studio에서는 빌드·디버깅을 계속하고, 같은 프로젝트 폴더를 VS Code에서 열어 Codex를 사용할 수 있습니다. 두 편집기에서 같은 파일을 동시에 수정할 때에는 저장 내용이 겹치지 않도록 확인하세요.

2. 설치 전 준비 사항

항목확인할 내용
Windows PC사용 중인 Windows 버전과 최신 확장의 지원 조건 확인
Visual Studio CodeMicrosoft의 공식 편집기 설치
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 설치

  1. VS Code 공식 사이트에서 Windows 설치 파일을 받습니다.
  2. 설치 안내에 따라 진행한 뒤 VS Code를 실행합니다.

3-2. 공식 Codex 확장 설치

  1. VS Code에서 Ctrl + Shift + X를 눌러 확장 화면을 엽니다.
  2. 검색창에 Codex를 입력합니다.
  3. 게시자가 OpenAI인 확장을 선택합니다.
  4. Install을 눌러 설치합니다.

Codex 공식 확장 페이지 열기

VS Code에서 OpenAI Codex 확장을 설치하는 기존 화면 예시
VS Code에서 OpenAI Codex 확장을 설치하는 기존 화면 예시

3-3. Codex 패널 열기

사이드바에서 Codex 아이콘을 선택합니다. 아이콘이 보이지 않으면 Ctrl + Shift + P로 명령 팔레트를 열고 다음 명령을 검색합니다.

Codex: Open Codex Sidebar

4. 로그인과 프로젝트 열기

4-1. ChatGPT 계정으로 로그인

  1. Codex 패널에서 Sign in with ChatGPT 등 표시된 로그인 항목을 선택합니다.
  2. 브라우저에서 사용할 계정으로 로그인하고 인증을 완료합니다.
  3. VS Code로 돌아와 Codex 패널이 정상적으로 열리는지 확인합니다.
Codex 로그인 및 인증 과정의 기존 화면 예시
Codex 로그인 및 인증 과정의 기존 화면 예시

로그인 화면과 메뉴는 확장 버전에 따라 달라질 수 있습니다. 이용 가능 여부와 사용 한도는 계정에 표시되는 안내를 확인하세요.

4-2. 작업할 폴더 선택

  1. File → Open Folder에서 기존 프로젝트 폴더를 엽니다.
  2. 왼쪽 탐색기에 소스 파일과 프로젝트 파일이 보이는지 확인합니다.
  3. 여러 프로젝트가 있다면 수정할 프로젝트와 시작 프로젝트를 구분합니다.
폴더 선택이 중요합니다.

파일 하나만 여는 것보다 프로젝트의 소스와 설정을 함께 볼 수 있는 폴더를 열어야 구조를 파악하기 쉽습니다. 본인이 관리하고 신뢰하는 프로젝트에서 작업을 시작하세요.

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