15. IDE Extension (VS Code · Cursor · JetBrains)
VS Code(및 Cursor/Windsurf 포크) · JetBrains IDE에서 Codex를 직접 사용하는 확장 가이드. Chat / Agent / Agent Full Access 3가지 모드, 모델 스위처와 reasoning effort, @file 참조, 이미지 드래그앤드롭, Cloud delegation까지 한 페이지로 정리합니다.
IDE 안에서 Codex를 쓰려면 VS Code(+ Cursor / Windsurf) 또는 JetBrains 마켓플레이스에서 "OpenAI Codex" 확장을 설치하세요. App과 같은 ChatGPT 계정으로 로그인하며, 같은 프로젝트를 열면 자동 동기화됩니다.
이 페이지에서 배우는 것
- IDE Extension은 무엇이고, Codex App과 어떻게 다른가
- VS Code · Cursor · Windsurf · JetBrains에서의 설치·인증 흐름
- Chat / Agent / Agent Full Access 3가지 모드의 권한 차이
- 모델 스위처·reasoning effort·@file 참조·이미지 첨부 같은 Composer 기능
- 장시간 작업을 Cloud로 오프로드하는 Cloud delegation
- App 슬래시 커맨드와 IDE 슬래시 커맨드의 차이
IDE Extension이란? — App과의 비교
IDE Extension은 VS Code/Cursor/Windsurf/JetBrains 안에서 Codex를 직접 호출하는 확장입니다. 같은 Codex 엔진을 쓰고 같은 ChatGPT 계정으로 인증하지만, 인터페이스가 코드 편집기 안에 통합되어 있어 작업 흐름이 자연스럽습니다.
@file로 즉시 참조. 같은 화면에서 diff 확인 + 적용. 사소한 작업·리뷰·설명 요청에 강점.IDE context 옵션이 노출되어 IDE에서 보고 있는 파일을 자동 첨부.지원 IDE와 설치
| IDE | 설치 위치 | 비고 |
|---|---|---|
| VS Code | 마켓플레이스 → "OpenAI Codex" | 가장 완성도 높은 구현 |
| VS Code Insiders | 같은 확장 | 최신 빌드 |
| Cursor | VS Code 확장 그대로 | VS Code 포크라 동일 확장 사용 |
| Windsurf | VS Code 확장 그대로 | VS Code 포크 |
| JetBrains IDE | JetBrains 마켓플레이스 → "OpenAI Codex" | Rider / IntelliJ / PyCharm / WebStorm 모두 동일 플러그인 |
인증은 IDE 설치 직후 안내되는 OAuth 흐름으로 진행합니다. App에 이미 로그인되어 있으면 같은 토큰을 재사용합니다(~/.codex/auth.json).
3가지 모드 — Chat / Agent / Agent Full Access
IDE Composer 상단의 모드 드롭다운에서 현재 권한 수준을 선택합니다.
on-request와 유사.danger-full-access와 같으며, 신뢰된 워크플로 외에는 권장하지 않습니다.Composer 기능
- 모델 스위처 + reasoning effort — Composer에서
gpt-5-codex등 모델과low/medium/high추론 노력을 즉시 변경. 짧은 작업은 low로 응답 속도를 올리고, 어려운 리팩토링은 high로 올립니다. @참조 —@filename으로 파일 첨부,@symbol로 함수·클래스 참조. App의 동작과 동일합니다(8. 단축키 페이지의 Composer 접두사 참고).- 이미지 드래그앤드롭 /
$imagegen— 스크린샷·디자인 mock을 Composer에 끌어다 놓아 시각 컨텍스트로 첨부.$imagegenSkill로 이미지를 생성·편집. - 웹 검색 — 설정에서
cached(IDE 기본) /live(prompt-injection 위험 알림 후) /disabled선택. - diff 미리보기 — 변경을 적용하기 전 IDE 자체 diff 뷰에서 확인하고 hunk 단위로 적용/거부.
Cloud Delegation — 장시간 작업 오프로드
IDE 안에서 시작한 작업이 30분, 1시간 걸린다면 IDE를 계속 켜둘 필요 없이 Cloud로 오프로드할 수 있습니다. IDE에 "Run on Cloud" 옵션이 노출되며, 클라우드 컨테이너에서 작업이 계속되고 결과 diff를 다시 IDE로 끌어옵니다.
- follow-up — Cloud로 보낸 작업에 추가 메시지를 보내거나 진행 상태를 확인할 수 있습니다.
- 실행 환경 상속 — Cloud 환경의 setup script · secrets · maintenance script가 작용합니다(17. Cloud Environments 참고).
- diff 적용 — 완료된 작업의 결과를 로컬에 가져올 때
codex apply와 같은 흐름이 IDE에서 자동 실행됩니다.
슬래시 커맨드 차이
App의 6개 빌트인 슬래시(/feedback /mcp /plan-mode /review /status /pet) 외에 IDE는 /skills와 /model이 추가로 동작합니다(공식 Skills 문서: "In CLI/IDE, run /skills or type $ to mention a skill"). 활성화된 Skill도 슬래시 메뉴에 자동 등록됩니다.
| 슬래시 | App | IDE | CLI |
|---|---|---|---|
/feedback /mcp /plan-mode /review /status | ✓ | ✓ | ✓ |
/pet | ✓ | — | — |
/skills | — | ✓ | ✓ |
/model | — | ✓ (모델 스위처 UI 대체) | ✓ (인터랙티브 세션) |
| 활성 Skill 자동 등록 | ✓ | ✓ | ✓ |
실전 팁
- 처음에는 Chat 모드로 코드 설명만 시켜보세요 — 권한 사고 없이 모델 품질만 확인.
- 같은 프로젝트를 App과 IDE 둘 다 열면 Composer에 "IDE context" 옵션이 노출됩니다. "Auto context"로 IDE에서 보고 있는 파일을 자동 첨부.
- JetBrains 사용자는 IDE 자체의 keymap을 따르며, Codex 전용 단축키는 Settings > Keymap에서 검색해 변경 가능합니다.
- Cursor/Windsurf 사용자는 자체 AI 기능과 Codex가 동시에 활성화될 수 있으니 한 작업에 하나만 사용해 컨텍스트 충돌을 피하세요.
한계점
⚠️ 알아둘 점
- App 전용 기능(Computer Use, In-app Browser, Worktree 다중 스레드, Automations)은 IDE에서 사용 불가
- IDE Extension은 매우 빠르게 업데이트됩니다 — 정기적으로 마켓플레이스에서 업데이트 확인
- JetBrains 플러그인은 VS Code 버전보다 일부 기능 도입이 늦을 수 있습니다
- 커스텀 키바인딩 충돌이 잦으므로 IDE Settings > Keymap에서 충돌 확인 권장
공식 출처
- Codex IDE Extension (OpenAI Developers)
developers.openai.com/codex/ide - IDE — Features
developers.openai.com/codex/ide/features - IDE — Settings
developers.openai.com/codex/ide/settings - IDE — Slash Commands
developers.openai.com/codex/ide/slash-commands