codex vscode 사용법 — 설치와 안 될 때
VS Code에서 Codex를 쓰려면 확장 하나만 깔면 되는데, 여기서 대부분 한 번 막힙니다 — 확장의 진짜 ID가 openai.chatgpt이기 때문입니다. 마켓플레이스에 표시되는 이름은 "Codex – OpenAI's coding agent"인데 게시자는 OpenAI, 내부 이름은 chatgpt라서, 명령이나 설정에서 codex.로 찾으면 아무것도 안 나옵니다. 설치·로그인부터 사이드바가 안 보일 때 쓰는 명령, CLI와 뭐가 다른지까지 공식 문서 원문과 마켓플레이스 공식 API로 확인해 정리했습니다. (2026년 9월 6일 기준 · 확장 버전 26.5901.22334 · VS Code 1.136.0)
codex vscode 설치 — 확장 이름이 함정이다
확장 검색창에 "Codex"를 치면 비슷한 이름이 여럿 뜹니다. 정확한 것은 게시자가 OpenAI인 다음 하나입니다.
| 항목 | 값 |
|---|---|
| 확장 ID | openai.chatgpt |
| 표시 이름 | Codex – OpenAI's coding agent |
| 게시자 | OpenAI (openai) |
확실하게 설치하려면 검색창에 확장 ID를 그대로 붙여넣는 것이 가장 빠릅니다. 터미널을 쓴다면 한 줄로도 됩니다.
# 확장 설치
code --install-extension openai.chatgpt
# 설치됐는지 확인
code --list-extensions | grep openai에디터마다 방식이 갈립니다. 공식 문서 기준으로 정리하면 이렇습니다.
| 에디터 | 설치 방법 |
|---|---|
| VS Code · Cursor · Windsurf · VS Code Insiders | Codex 확장(openai.chatgpt)을 설치 |
| Xcode | 확장이 아니라 Xcode의 코딩 어시스턴트에서 에이전트로 Codex를 고른다 |
| JetBrains (IntelliJ 등) | 확장이 아니라 AI Chat에서 Codex를 고른다 |
로그인 — 두 가지 방식이 있다
설치만으로는 안 돌아갑니다. 로그인 방식이 두 가지인데, 이걸 모르고 한쪽만 시도하다 막히는 경우가 많습니다.
| 방식 | 과금 | 어떻게 |
|---|---|---|
| ChatGPT 계정 | 구독 플랜에 포함 | 로그아웃 화면에서 Sign in with ChatGPT → 브라우저 창이 열리고, 로그인하면 자격 증명이 에디터로 돌아온다 |
| API 키 | 쓴 만큼 과금 | OpenAI 대시보드에서 발급한 키를 넣는다 |
로그인 방식은 요금만 가르는 게 아닙니다. ChatGPT 계정으로 로그인하면 사용 기록이 그 워크스페이스의 권한·보존 정책을 따르고, API 키로 로그인하면 API 조직의 정책을 따릅니다. 회사 계정으로 쓸 거라면 이 차이를 먼저 확인하세요. 참고로 Codex 클라우드는 ChatGPT 로그인만 됩니다 — API 키로는 클라우드 위임이 안 됩니다.
Codex 사이드바가 안 보일 때
설치하고 로그인까지 했는데 아이콘이 어디에도 없는 경우가 있습니다. 확장이 망가진 게 아니라 사이드바가 안 열린 것뿐이라, 명령 하나로 해결됩니다.
- 명령 팔레트를 엽니다 — Ctrl+Shift+P (맥은 Cmd+Shift+P)
- Codex: Open Codex Sidebar 를 실행합니다.
매번 이렇게 여는 게 번거로우면, 편집기 설정에서 chatgpt.openOnStartup을 true로 바꾸면 됩니다. 기본값은 false라서 시작할 때 사이드바가 안 뜹니다.
CLI 대신 확장을 쓰는 이유 — 열린 파일이 그대로 문맥이 된다
이미 codex cli 윈도우 설치를 해 뒀다면 "굳이 확장까지?" 싶을 텐데, 문서가 짚는 결정적 차이가 하나 있습니다.
/mention·@ 자동완성으로 파일을 붙여야 합니다.
그래서 확장 쪽 작업 흐름은 이렇게 짧아집니다. ① 관련 파일을 연다 → ② 궁금한 코드를 선택한다 → ③ 그냥 묻는다. 파일 경로를 타이핑해 붙일 필요가 없습니다. 반대로 자동 문맥이 부담스러우면 /ide-context로 껐다 켤 수 있습니다.
명령어와 단축키
확장 명령은 전부 chatgpt.로 시작합니다. 명령 팔레트에서 Codex로 찾아도 되고, 아래 ID로 찾아도 됩니다.
| 명령 ID | 기본 단축키 | 하는 일 |
|---|---|---|
chatgpt.newChat |
Ctrl+N (맥 Cmd+N) | 새 대화 시작 |
chatgpt.addToThread |
없음 | 선택한 코드 범위를 현재 대화 문맥에 추가 |
chatgpt.addFileToThread |
없음 | 파일 전체를 문맥에 추가 |
chatgpt.openSidebar |
없음 | Codex 사이드바 열기 |
chatgpt.newCodexPanel |
없음 | 새 Codex 패널 열기 |
단축키를 붙이려면 명령 팔레트에서 Preferences: Open Keyboard Shortcuts를 실행한 뒤 Codex 또는 명령 ID(예: chatgpt.newChat)로 검색해 연필 아이콘을 누르면 됩니다.
자주 쓰는 슬래시 명령
입력창에 /를 치면 목록이 뜹니다. 전부 외울 필요는 없고, 아래 정도면 대부분 커버됩니다.
| 명령 | 하는 일 |
|---|---|
/status |
대화 ID, 문맥 사용량과 사용 한도 보기 — 답이 이상해지면 여기부터 |
/init |
현재 프로젝트에 AGENTS.md 뼈대를 만들어 준다 |
/review |
커밋 안 한 변경이나 기준 브랜치와 비교해 코드 리뷰 |
/plan |
여러 단계짜리 작업에 계획 모드 켜기 |
/model · /reasoning |
이 대화에 쓸 모델과 추론 강도 고르기 |
/compact |
대화 문맥 압축 — 길어져서 느려질 때 |
/local · /cloud |
내 컴퓨터에서 돌릴지, 클라우드로 넘길지 전환 |
/worktree |
새 깃 워크트리에서 작업 — 본 작업 브랜치를 안 건드린다 |
/mcp |
연결된 MCP 서버 상태 보기 |
/init이 만들어 주는 AGENTS.md는 프로젝트마다 Codex에게 줄 지침을 적어 두는 파일입니다. 어디에 두고 어떤 순서로 읽히는지는 agents.md 작성법에 정리해 뒀습니다.
설정이 두 층으로 나뉜다
설정을 찾다가 헤매는 이유가 여기 있습니다. Codex 설정과 에디터 설정은 사는 곳이 다릅니다.
| 층 | 무엇을 정하나 | 어디에 |
|---|---|---|
| Codex 설정 | 모델, 추론 강도, 권한, 샌드박스, MCP 서버 — CLI와 공유 | config.toml(사이드바 톱니 → Codex Settings) |
| 에디터 설정 | 확장이 VS Code 안에서 어떻게 동작할지 | VS Code 설정의 chatgpt.* 키 |
에디터 설정을 찾을 때는 설정 검색창에 @ext:openai.chatgpt를 넣으면 이 확장 것만 걸러집니다. 자주 건드리는 것들은 이렇습니다.
| 설정 | 기본값 | 설명 |
|---|---|---|
chatgpt.openOnStartup |
false |
에디터를 켜면 Codex 사이드바에 바로 포커스를 준다 |
chatgpt.commentCodeLensEnabled |
true |
TODO 주석 위에 바로 처리 버튼을 띄운다 |
chatgpt.composerEnterBehavior |
enter |
엔터가 항상 전송(enter)인지, 여러 줄일 때만 Ctrl+Enter 전송(cmdIfMultiline)인지 |
chatgpt.followUpQueueMode |
queue |
돌아가는 중에 보낸 말을 다음 차례로 미룰지(queue), 지금 작업 방향을 틀지(steer) |
줄바꿈하려다 자꾸 전송돼 버린다면 chatgpt.composerEnterBehavior를 바꾸면 됩니다. 이건 설정으로 해결되는 문제지 버그가 아닙니다.
어느 플랜부터 쓸 수 있나
여기는 정보가 어긋나 있어 그대로 옮깁니다. 공식 요금 문서에는 Free($0)와 Go($8) 카드에도 Codex가 올라 있고, 문서 색인 설명도 "Free, Go, Plus, Pro, Business, Edu, Enterprise 플랜에 포함"이라고 적혀 있습니다. 반면 마켓플레이스의 확장 소개문은 아직 "Plus, Pro, Business, Edu, Enterprise 플랜에 포함"이라고만 씁니다.
즉 "Plus부터 된다"는 설명은 최신이 아닐 가능성이 큽니다. 무료 계정으로 로그인해 보고 안 되면 그때 플랜을 올려도 늦지 않습니다. 플랜별 한도는 문서에 숫자로 명시돼 있지 않으니, 실제로 얼마나 쓸 수 있는지는 /status로 직접 확인하는 게 정확합니다.
자주 묻는 질문 (FAQ)
Q. 확장을 깔았는데 명령 팔레트에 codex.로 시작하는 게 하나도 없습니다.
정상입니다. 명령 ID는 전부 chatgpt.로 시작합니다(chatgpt.newChat 등). 팔레트에서는 Codex로 검색하면 표시 이름으로 걸립니다.
Q. CLI를 이미 쓰고 있는데 설정을 또 해야 하나요?
모델·권한·샌드박스·MCP 같은 Codex 설정은 config.toml로 CLI와 공유합니다. 다시 잡을 필요가 없습니다. 확장 전용으로 따로 있는 건 chatgpt.* 에디터 설정뿐입니다.
Q. Cursor에서도 되나요?
됩니다. Cursor와 Windsurf는 VS Code 계열이라 같은 확장(openai.chatgpt)이 그대로 설치됩니다. Xcode와 JetBrains만 방식이 다릅니다.
Q. 회사 코드가 클라우드로 나가지 않게 하려면요?
기본은 로컬 실행이고, 클라우드로 넘기는 건 /cloud로 명시할 때입니다. /local로 되돌릴 수 있습니다. 다만 로그인 방식에 따라 적용되는 보존 정책이 달라지므로, 조직 계정이라면 워크스페이스 설정을 먼저 확인하세요.
마무리
정리하면 ① openai.chatgpt를 설치 → ② Sign in with ChatGPT로 로그인 → ③ 안 보이면 Codex: Open Codex Sidebar 세 단계입니다. 이름이 codex가 아니라 chatgpt라는 것만 알고 있으면 설치·설정·명령 검색에서 헤맬 일이 거의 없습니다.
확장은 자주 올라갑니다. 명령이나 설정이 이 글과 다르면 확장 버전을 먼저 확인하고, 슬래시 명령 목록은 입력창에 /를 쳐서 그 자리에서 보는 게 가장 정확합니다.
📚 참고 출처 (2026년 9월 6일 확인 · 확장 정보는 VS Marketplace 공식 API로 조회)
· Codex IDE extension
· Developer commands (IDE)
· Developer settings (IDE)
· Authentication
· Pricing
· VS Marketplace — Codex
COMMENTS