> ## Content Index
> Fetch the complete content index at: https://zerodraftlab.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# VS Code에서 Codex 쓰는 법, 결제 전에 꼭 보세요! 요금제별 총정리
- URL: https://zerodraftlab.com/vscode-codex-guide/
- Published: 2026-11-03T03:00:00.000Z
- Updated: 2026-11-03T02:59:59.000Z
- Description: VS Code에서 Codex를 쓰는 순서를 확장 설치, 첫 작업, 승인 모드, 설정 파일로 정리했다. 결제 전에 볼 요금제별 사용 범위는 2026년 11월 공식 문서로 확인했다.
- Author: JooMong
- Tags: 무료

VS Code에서 Codex를 쓰려면 확장을 설치하고 로그인하면 된다. 먼저 확인할 것은 요금제다. 공식 요금 문서의 기능 표는 Plus, Pro, Business, Enterprise·Edu, API 키에서 IDE 확장을 쓸 수 있다고 표시한다. 월 8달러 Go와 Free는 이 표에 없고 데스크톱 앱 사용만 적혀 있으니, 결제 전에 아래 표를 본다. 아래 내용은 2026년 11월 1일에 [OpenAI Codex IDE 문서](https://developers.openai.com/codex/ide?ref=zerodraftlab.com)에서 확인했다. 직접 설치해 시험한 기록은 아니다.

## VS Code용 Codex를 쓸 수 있는 요금제

![Codex 요금제별 공식 문서의 IDE 확장 표기를 적은 표. Free와 Go는 데스크톱 앱 사용만 적혀 있다. Plus, Pro, Business, Enterprise·Edu는 기능 표에 IDE 확장 사용 가능으로 표시돼 있다. API 키도 IDE 확장을 쓸 수 있고 클라우드 기능은 제외다. Plus부터 API 키까지 줄을 형광펜으로 칠했다. Free와 Go는 IDE 표기가 없다는 뜻이고 안 된다고 확인한 것은 아니다. 2026년 11월 1일 공식 문서 기준이다.](https://storage.ghost.io/c/da/13/da13bbbc-4992-4354-bf2c-1426bcf8788c/content/images/2026/11/zdl-vscode-codex-guide-plan-labels-1.png)

2026년 11월 1일 Codex 요금 문서의 표기를 옮겼고, 표기가 없는 요금제를 직접 시험하지는 않았다.

| 요금제            | 월 가격             | 공식 문서의 IDE 확장 표기                                  |
| -------------- | ---------------- | ------------------------------------------------- |
| Free           | 0달러              | 데스크톱 앱 사용만 적혀 있고, 순차 제공이다.                        |
| Go             | 8달러              | 데스크톱 앱 사용만 적혀 있고, 순차 제공이다.                        |
| Plus           | 20달러             | 웹, CLI, IDE 확장, iOS에서 사용                          |
| Pro            | 100달러부터          | 100, 200, 500달러 요금제. 기능 표에 IDE 확장 사용 가능으로 표시돼 있다. |
| Business       | 사용자당 20달러(연간 결제) | 2명 이상. 월간 결제는 25달러. 기능 표에 IDE 확장 사용 가능으로 표시돼 있다.  |
| Enterprise·Edu | 영업 문의            | 기능 표에 IDE 확장 사용 가능으로 표시돼 있다.                      |
| API 키          | API 사용량 기준       | CLI, SDK, IDE 확장에서 사용. 클라우드 기능은 제외                |

가격과 범위는 [Codex 요금 문서](https://developers.openai.com/codex/pricing?ref=zerodraftlab.com) 기준이다. 요금제와 모델은 자주 바뀌므로 결제 전에 원문을 확인한다. Claude Code와 비교하고 있다면 [Codex와 Claude Code 비교](https://zerodraftlab.com/codex-vs-claude-code/)를 보면 된다.

## VS Code에 Codex 확장 설치하기

1. VS Code에서 확장 화면을 연다.
2. [Codex 확장](https://marketplace.visualstudio.com/items?itemName=openai.chatgpt&ref=zerodraftlab.com)(확장 ID `openai.chatgpt`)을 찾아 설치한다.
3. Codex 아이콘을 선택한다. 보이지 않으면 명령 팔레트에서 `Codex: Open Codex Sidebar`를 실행한다.
4. 로그인한다.

공식 문서는 Cursor, Windsurf, VS Code Insiders에도 같은 확장을 설치한다고 적는다.

## Windows에서 쓸 때

IDE 문서 본문에는 운영체제별 지원 범위가 따로 적혀 있지 않다. 설정 문서에는 Windows용 옵션이 있다. WSL2가 있는 Windows에서 `chatgpt.runCodexInWindowsSubsystemForLinux`를 `true`로 바꾸면 Codex가 WSL 안에서 실행된다. 값을 바꾸면 VS Code가 다시 로드된다.

## Codex로 첫 작업 시키기

IDE 문서가 설명하는 흐름은 세 가지다.

- **편집기 맥락 쓰기:** 열린 파일, 선택한 코드, 최근 채팅을 입력창에서 바로 참조한다.
- **변경 검토하기:** 요약과 변경된 줄을 보고, 원하는 수정만 남긴 뒤 같은 채팅에서 이어서 요청한다.
- **오래 걸리는 일 넘기기:** 로컬에서 빠르게 반복하다가, 오래 걸리는 작업은 Codex 클라우드로 넘길 수 있다. API 키로는 클라우드 기능을 쓸 수 없다.

처음에는 범위가 좁은 작업이 낫다. 예를 들어 파일 하나를 열고 "이 함수의 입력 검증을 추가하고, 기존 테스트를 실행해 결과를 알려 줘"라고 요청한다. 이 예시는 ZDL이 든 것이다. Git 저장소에서 시작하면 바뀐 내용을 되돌리기 쉽다.

![VS Code의 Codex 흐름 세 가지를 번호로 적은 그림. 1 편집기 맥락 쓰기는 열린 파일, 선택한 코드, 최근 채팅을 입력창에서 참조한다. 2 변경 검토하기는 요약과 변경된 줄을 보고 원하는 수정만 남긴 뒤 이어서 요청하며, 빨간 화살표가 2에서 1로 돌아간다. 3 오래 걸리는 일 넘기기는 Codex 클라우드로 넘길 수 있고 API 키로는 쓸 수 없다. 첫 요청 예시는 파일 하나를 열고 이 함수의 입력 검증을 추가하고 기존 테스트를 실행해 결과를 알려 달라고 하는 것이며 ZDL이 든 예시다. Git 저장소에서 시작하면 바뀐 내용을 되돌리기 쉽다.](https://storage.ghost.io/c/da/13/da13bbbc-4992-4354-bf2c-1426bcf8788c/content/images/2026/11/zdl-vscode-codex-guide-first-task.png)

세 흐름은 Codex IDE 문서 기준이고, 첫 요청 문장은 ZDL이 든 예시다.

## 승인 모드와 샌드박스 설정

Codex가 무엇을 승인 없이 실행하는지는 [승인·보안 문서](https://developers.openai.com/codex/agent-approvals-security?ref=zerodraftlab.com)에 나온 두 값으로 정해진다. 설정 파일에 적어 두면 CLI와 IDE 확장이 함께 쓴다. CLI에서는 `/permissions`로 고른다. IDE 확장에서는 입력창 아래의 권한 메뉴에서 고른다. 구성에 따라 `Ask for approval`, `Approve for me`, `Full access`가 보인다.

| 설정                 | 값                             | 뜻                                      |
| ------------------ | ----------------------------- | -------------------------------------- |
| sandbox\_mode      | read-only                     | 읽기만 한다.                                |
| workspace-write    | 현재 작업 폴더에서 읽기, 편집, 명령 실행을 한다. |                                        |
| danger-full-access | 샌드박스 없음. 공식 문서가 권장하지 않는다.     |                                        |
| approval\_policy   | on-request                    | 샌드박스 안의 일은 그대로 하고, 밖으로 나가는 일은 승인을 묻는다. |
| never              | 승인을 묻지 않는다. CI 같은 환경에 쓴다.     |                                        |

Git 저장소의 권장값은 `workspace-write`와 `on-request`를 묶은 `Auto`다. Git이 아닌 폴더는 `read-only`를 권장한다. 네트워크는 기본으로 꺼져 있다. `approval_policy`의 `untrusted` 값은 폐지됐고, 설정에 남아 있으면 클라이언트가 시작되지 않을 수 있다. 프로젝트별 `trust_level = "untrusted"`는 계속 쓸 수 있다. 예전 글의 설정을 그대로 복사하면 안 되는 이유다.

![Codex 설정 값 두 개를 표로 나눈 그림. sandbox_mode는 어디까지 손대는지를 정한다. read-only는 읽기만 하고, workspace-write는 현재 작업 폴더에서 읽기, 편집, 명령 실행을 하며, danger-full-access는 샌드박스가 없고 공식 문서가 권장하지 않는다. approval_policy는 언제 묻는지를 정한다. on-request는 샌드박스 밖으로 나가는 일만 승인을 묻고, never는 승인을 묻지 않으며 CI 같은 환경에 쓴다. workspace-write와 on-request를 형광펜으로 칠했고 둘을 묶은 Auto가 Git 저장소의 권장값이다. Git이 아닌 폴더는 read-only를 권장하고, 네트워크는 기본으로 꺼져 있다. approval_policy의 untrusted 값은 폐지됐고 설정에 남아 있으면 클라이언트가 시작되지 않을 수 있다.](https://storage.ghost.io/c/da/13/da13bbbc-4992-4354-bf2c-1426bcf8788c/content/images/2026/11/zdl-vscode-codex-guide-approval-axes-1.png)

값과 권장 조합은 2026년 11월 1일 승인·보안 문서 기준이고, 이 조합을 실행해 보지는 않았다.

## Codex 설정 파일 위치와 모델 변경

사이드바의 톱니바퀴 아이콘에서 `Codex Settings`를 열고 `Open config.toml`을 선택하면 설정 파일을 바로 고칠 수 있다.

- **개인 기본값:** `~/.codex/config.toml`
- **프로젝트별 설정:** 신뢰한 프로젝트의 `.codex/config.toml`

CLI와 IDE 확장은 같은 설정을 함께 쓴다. 모델은 `model`과 `model_reasoning_effort` 값으로 정한다. 쓸 수 있는 모델은 계정과 워크스페이스에 따라 다르다.

```toml
sandbox_mode = "workspace-write"
approval_policy = "on-request"
model_reasoning_effort = "medium"
```

위 값은 문법을 보여 주는 예시다. 키 이름은 공식 문서에서 확인했지만, 이 조합을 실행해 보지는 않았다. 입력창 동작이나 글자 크기처럼 편집기에 속한 설정은 `config.toml`이 아니라 VS Code 설정에 저장된다. VS Code 설정에서 `@ext:openai.chatgpt`나 설정 이름으로 검색한다. 글자 크기는 VS Code 기본 설정인 `chat.fontSize`를 쓴다.

터미널에서 쓰는 코딩 에이전트가 궁금하다면 [클로드 코드 사용법](https://zerodraftlab.com/claude-code-usage-guide/)을 본다.

[이메일로 다음 글 받기](#/portal/signup)