Cursor에서 로컬 프로젝트를 열어 둔 상태라면, 첫 목표는 Codex에게 큰 기능을 맡기는 것이 아닙니다. 공식 IDE 확장을 연결하고, 열린 파일 하나에 되돌릴 수 있는 작은 변경을 요청한 뒤, 실제 diff를 검토하는 데까지 진행해 보세요. 이 한 번의 흐름으로 설치와 계정 연결뿐 아니라 프로젝트 맥락, 변경 검토, 복구 방법이 제대로 작동하는지도 확인할 수 있습니다.
아래 내용은 2026년 8월 15일에 확인한 OpenAI 공식 문서를 기준으로 합니다. Cursor와 확장 버전에 따라 아이콘 위치나 화면 배치는 달라질 수 있으므로, 특정 위치보다 명령 이름과 실제 동작을 기준으로 확인하세요.
공식 Codex IDE 확장을 설치합니다
OpenAI의 Codex IDE 문서는 Cursor를 지원 편집기로 안내하고 공식 Cursor 확장 경로를 제공합니다. Cursor의 확장 관리 화면에서 설치 대상을 열었다면 이름만 보지 말고 게시자와 확장 식별 정보가 공식 경로의 openai.chatgpt와 일치하는지 확인하세요. 이름이 비슷한 제3자 확장을 설치하면 이후 화면과 인증 절차가 이 안내와 맞지 않을 수 있습니다.
이번 절차의 대상은 Cursor 안에 Codex 사이드바를 추가하는 Codex IDE 확장입니다. Cursor 자체 에이전트나 터미널의 Codex CLI 화면을 보고 있다면 설치 경로와 진입점이 달라 아래 절차와 맞지 않습니다.
설치가 끝났다면 Codex를 사용할 로컬 프로젝트 폴더를 Cursor에서 여세요. 확장이 재시작 또는 창 다시 로드를 요구하면 현재 화면의 안내를 먼저 따릅니다.
사이드바를 열고 계정을 연결합니다
아이콘이 바로 보이면 눌러도 되지만, 보이지 않을 때는 명령 팔레트가 더 확실합니다. 공식 IDE 문서에 안내된 명령은 Codex: Open Codex Sidebar입니다.
- Cursor에서 명령 팔레트를 엽니다.
Codex: Open Codex Sidebar를 입력합니다.- 해당 명령을 실행해 Codex 사이드바가 열리는지 확인합니다.
- 로그인 화면이 나타나면 표시된 절차에 따라 계정을 연결합니다.
- 사이드바에서 새 요청을 입력할 수 있는 상태인지 확인합니다.
OpenAI의 한국어 Codex 소개는 ChatGPT 계정으로 Codex를 연결해 코드 편집기와 터미널에서 사용하는 방식을 설명합니다. 다만 실제 접근 가능 여부와 사용 한도는 계정, 지역, 현재 제공 조건에 따라 달라질 수 있습니다. 특정 요금제가 반드시 필요하다고 추측하지 말고, 로그인 뒤 화면에 표시되는 계정 상태와 안내를 기준으로 판단하세요.
사이드바가 열렸다는 사실만으로 프로젝트 연결까지 확인된 것은 아닙니다. 다음 단계에서 실제 파일 맥락과 변경 검토가 작동하는지 확인해야 합니다.
첫 요청 전에 되돌릴 지점을 만듭니다
OpenAI는 첫 IDE 작업 전후에 Git 체크포인트를 두도록 권장합니다. 원격 저장소를 새로 만들 필요는 없지만, 현재 작업과 Codex의 제안을 구분할 수 있는 깨끗한 기준점은 필요합니다.
프로젝트가 이미 Git으로 관리되고 있다면 먼저 현재 상태를 확인하세요.
bashgit status
미완성 변경이 있다면 무엇이 본인 작업인지 기록하고, 평소 팀 절차에 맞게 커밋하거나 별도 브랜치에서 진행합니다. 기존 변경을 지우거나 강제로 초기화해서는 안 됩니다. 첫 시도는 새 파일 하나나 작은 함수 하나처럼 영향 범위가 분명한 작업을 고르세요.
좋은 첫 작업은 다음 조건을 만족합니다.
- 결과를 코드에서 바로 확인할 수 있다.
- 수정할 파일이나 함수가 명확하다.
- 유지해야 할 동작을 한두 문장으로 설명할 수 있다.
- 프로젝트의 기존 테스트나 린트로 확인할 수 있다.
- 제안이 틀려도 diff를 거부하거나 Git으로 복구하기 쉽다.
인증 정보, 운영 환경 설정, 대규모 마이그레이션처럼 영향 범위가 큰 작업은 연결 상태와 검토 흐름을 확인한 뒤로 미루는 편이 안전합니다.
열린 코드로 작은 작업을 요청합니다
Codex IDE 확장 문서에 따르면 확장은 열린 파일과 선택한 코드를 맥락으로 사용할 수 있고, 제안한 변경을 편집기 안에서 검토할 수 있습니다. 먼저 수정할 파일을 열고, 가능하면 대상 함수나 블록을 선택하세요.
예를 들어 입력 검증이 빠진 함수라면 다음처럼 요청할 수 있습니다.
“선택한 함수가 빈 문자열을 받을 때 명확한 오류를 반환하도록 수정안을 만들어 주세요. 함수 이름과 기존 반환 형식은 유지하고, 관련 테스트가 있다면 필요한 테스트 변경도 함께 보여 주세요.
요청에는 세 요소를 넣으면 검토가 쉬워집니다.
- 대상: 열린 파일, 선택한 함수, 오류가 발생한 위치
- 원하는 변화: 수정하거나 설명해야 할 동작
- 제약: 유지할 공개 인터페이스, 건드리지 않을 파일, 실행할 검증
“프로젝트를 개선해 주세요”처럼 범위가 열린 요청은 첫 확인에 적합하지 않습니다. Codex가 저장소 전체를 훑게 하기보다, 한 번에 판단할 수 있는 범위를 주고 응답이 현재 코드와 맞는지 먼저 보세요.
응답이 아니라 diff를 검토합니다
설명이 자연스럽거나 코드가 그럴듯해 보여도 곧바로 수락하지 마세요. 변경 검토 화면에서 실제 파일별 diff를 열고 다음 항목을 확인합니다.
| 검토 항목 | 확인할 질문 | 문제가 있을 때 |
|---|---|---|
| 범위 | 요청한 파일과 함수 중심으로 바뀌었는가? | 관련 없는 변경은 제외하고 범위를 다시 지정한다. |
| 동작 | 요구한 예외 처리나 결과가 구현됐는가? | 입력과 기대 결과를 더 구체적으로 설명한다. |
| 호환성 | 함수 시그니처와 기존 반환 형식이 유지됐는가? | 바뀌면 안 되는 계약을 명시해 다시 요청한다. |
| 안전성 | 설정, 비밀 정보, 의존성이 뜻밖에 바뀌지 않았는가? | 적용하지 말고 변경 이유부터 확인한다. |
| 검증 | 테스트, 린트, 빌드 중 무엇을 실행해야 하는가? | 프로젝트의 기존 명령으로 직접 확인한다. |
제안된 코드의 일부만 이해되지 않아도 멈춰서 설명을 요청할 수 있습니다. Codex에게 “이 변경이 필요한 이유와 실패할 수 있는 입력을 설명해 주세요”라고 물은 뒤, 답변을 프로젝트 코드와 테스트에서 다시 확인하세요.
변경을 적용했다면 저장소에서 원래 사용하던 테스트, 린트 또는 빌드 명령을 실행합니다. 성공 메시지만 보지 말고 실패한 테스트가 없는지, 예상하지 않은 생성 파일이 생기지 않았는지도 살펴보세요. 마지막으로 다시 git status와 git diff를 확인하면 첫 체크포인트 이후 바뀐 범위를 한눈에 볼 수 있습니다.
bashgit status git diff
결과가 기대와 다르면 편집기의 변경 거부 기능이나 팀에서 사용하는 Git 복구 절차로 되돌립니다. 기존에 있던 사용자 변경과 Codex가 만든 변경이 섞여 있다면 전체 파일을 무작정 되돌리지 말고, diff에서 정확한 범위를 구분한 뒤 처리하세요.
막힌 지점별로 원인을 좁힙니다
명령 팔레트에 Codex 명령이 없습니다
확장 관리 화면에서 공식 확장이 설치되어 있고 현재 작업 공간에서 활성화되어 있는지 확인하세요. 설치 직후라면 Cursor가 창 다시 로드를 요구하는지도 봅니다. 비슷한 이름의 확장이나 Codex CLI만 설치한 상태가 아닌지 공식 확장 경로와 다시 대조하세요.
사이드바는 열리지만 요청을 보낼 수 없습니다
사이드바에 표시되는 로그인, 계정 접근, 네트워크 오류 문구를 그대로 확인합니다. 계정별 기능 제공이나 지역 조건은 바뀔 수 있으므로 재설치를 반복하기 전에 현재 안내를 따르세요. 회사 네트워크나 프록시를 사용하는 환경이라면 조직 정책으로 연결이 제한되는지도 관리자에게 확인해야 할 수 있습니다.
답변이 열린 코드와 맞지 않습니다
대상 파일을 실제로 열었는지, 필요한 코드만 선택했는지 확인합니다. 파일의 역할과 유지 조건을 요청에 적고 범위를 함수 하나로 줄여 다시 시도하세요. 그래도 관련 없는 제안이 이어지면 큰 변경을 맡기지 말고 확장 상태와 저장소 접근 권한부터 점검합니다.
변경 내용이 어디에 표시되는지 모르겠습니다
일반 설명 응답과 코드 수정 제안은 다릅니다. “설명해 주세요” 대신 현재 열린 파일에 수정안을 만들도록 명확히 요청하고, 편집기에 나타나는 파일별 변경 검토 화면을 확인하세요. 버튼 위치는 버전에 따라 달라질 수 있으므로 화면에 없는 이름이나 위치를 추측해 클릭하지 마세요.
검토를 마치고 다음 작업으로 넘어갑니다
Codex의 답변이 생성된 것만으로는 연결과 변경 흐름을 확인했다고 보기 어렵습니다. 다음 항목을 직접 확인한 뒤에 작업 범위를 넓히세요.
Codex: Open Codex Sidebar로 사이드바에 접근할 수 있다.- 열린 파일이나 선택 코드가 요청에 반영된다.
- 변경 대상과 제약을 포함한 작은 작업을 맡길 수 있다.
- 파일별 diff에서 예상한 변경과 예상 밖 변경을 구분할 수 있다.
- 프로젝트의 기존 검증 명령을 실행했다.
- 변경을 수락하거나 안전하게 되돌릴 수 있다.
이 흐름이 한 번 안정적으로 작동하면 다음 작업부터 범위를 조금씩 넓히세요. 한 번에 더 많은 파일을 맡기더라도 체크포인트, 명확한 제약, diff 검토, 기존 테스트라는 네 가지 안전장치는 그대로 유지하는 편이 좋습니다.
