개발자 설정

일반 설정 페이지에서는 프로필, 키보드 단축키, 알림, 화면 표시, 개인화, 메모리, 보관된 채팅을 비롯한 앱 환경설정을 다룹니다.

프로젝트 및 터미널 동작

파일이 열리는 위치, 채팅에 표시할 명령 출력의 양, 터미널 탭이 기본적으로 열리는 위치를 선택합니다.

코드 리뷰

설정 > Git 에서 리뷰 제공 방식 을 사용하여 가능한 경우 현재 채팅에서 /review를 실행하려면 인라인 을 선택하고, 별도의 리뷰 채팅을 시작하려면 분리됨 을 선택합니다.

IDE 확장 프로그램 동기화

ChatGPT 데스크톱 앱과 IDE 확장 프로그램이 같은 프로젝트에서 열려 있으면 활성 채팅과 편집기 컨텍스트를 공유합니다. Codex에서 편집기에 현재 열려 있는 파일을 사용할 수 있도록 앱 작성 창에서 IDE 컨텍스트 를 켭니다. 앱 프롬프트에서 해당 편집기 컨텍스트를 제외하려면 이 기능을 끕니다.

IDE 확장 프로그램에서 앱 채팅을 열거나 앱에서 IDE 채팅을 이어갈 수 있습니다. 두 환경 모두 같은 프로젝트를 기준으로 공유할 채팅과 컨텍스트를 결정합니다.

에이전트 구성

앱의 Codex 에이전트는 IDE 확장 프로그램 및 CLI와 동일한 구성을 상속합니다. 일반적인 설정에는 앱 내 컨트롤을 사용하고, 고급 옵션에는 config.toml을 편집합니다. 자세한 내용은 에이전트 승인 및 보안과 구성 기본 사항을 참조하세요.

Git

Git 설정을 사용하여 브랜치 이름 지정 방식을 표준화하고 Codex에서 강제 푸시를 사용할지 선택합니다. Codex가 커밋 메시지와 풀 리퀘스트 설명을 생성할 때 사용하는 프롬프트도 설정할 수 있습니다.

통합 및 MCP

Model Context Protocol(MCP)을 통해 외부 도구를 연결합니다. 권장 서버를 활성화하거나 자체 서버를 추가할 수 있습니다. 서버에 OAuth가 필요한 경우 앱에서 인증 흐름을 시작합니다. MCP 구성이 config.toml에 저장되므로 이러한 설정은 Codex CLI와 IDE 확장 프로그램에도 적용됩니다. 자세한 내용은 Model Context Protocol을 참조하세요.

브라우저 개발자 모드

개발자 모드 에서 전체 CDP 액세스 활성화 를 켜면 ChatGPT가 성능 프로파일링과 심층적인 브라우저 디버깅에 Chrome DevTools Protocol을 사용할 수 있습니다. 조직에서 전체 CDP 액세스를 비활성화한 경우 로컬에서 활성화할 수 없습니다. 설정, 위험, 승인 및 관리자 요구 사항은 개발자 모드를 참조하세요.

Codex CLI는 ~/.codex/config.toml에서 개인 기본 설정을 읽습니다. 프로젝트별 재정의가 필요한 경우 신뢰할 수 있는 프로젝트나 하위 폴더에 .codex/config.toml 파일을 추가하세요. CLI와 IDE 확장 프로그램은 이러한 구성 계층을 공유합니다.

설정 확인하기

다음 명령을 사용하여 현재 세션에 적용되는 설정을 파악할 수 있습니다.

/status를 실행하여 활성 모델, 승인 정책, 쓰기 가능한 루트 및 토큰 사용량을 확인합니다.
/debug-config를 실행하여 우선순위 순서로 구성 계층을 확인하고 관리형 정책 요구 사항의 출처를 확인합니다.
인식되지 않는 config.toml 키를 무시하지 않고 오류로 처리하려면 --strict-config 옵션으로 Codex를 시작합니다.

전체 대화형 명령 참조는 개발자 명령을 참조하세요.

한 번의 실행에만 적용할 설정 변경하기

전용 플래그가 있으면 사용하세요. 대표적인 예로는 --model, --sandbox, --ask-for-approval, --profile, --search가 있습니다. -c 또는 --config를 사용하면 지원되는 구성 키의 값을 한 번의 실행에만 재정의할 수 있습니다.

아래와 같이 모델을 재정의하려면 GPT-6.1 Sol에 대한 액세스 권한이 필요합니다. 계정이나 워크스페이스에서 사용할 수 없다면 --model을 생략하거나 /model에 나열된 모델을 선택하세요. 요금제별 GPT-6.1 Sol 사용 가능 여부를 참고하세요.

codex --model gpt-6.1-sol
codex --profile deep-review
codex --config model_reasoning_effort='"medium"'

명령줄 플래그와 --config 값의 우선순위가 가장 높습니다. 전체 플래그 목록은 개발자 명령을 참조하세요.

구성 계층

CLI는 프로젝트, 프로필, 사용자, 시스템 및 기본 제공 설정보다 명령줄 플래그와 --config 재정의를 먼저 적용합니다. 이 우선순위를 활용하여 공유 기본값은 구성 파일에 두고 일회성 변경 사항은 명령줄에 지정하세요.

전체 순서와 일반적인 옵션은 구성 기본 사항을 참조하세요.

TUI에서 설정 변경하기

대화형 터미널 UI에서는 일반적인 세션 및 표시 설정을 선택할 수 있는 선택기를 제공합니다.

목표	명령	관련 구성
모델 선택	`/model`	`model`, `model_reasoning_effort`
권한 변경	`/permissions`	승인 및 샌드박스 설정
응답 스타일 선택	`/personality`	`personality`
선택적 도구 구성	`/experimental`, `/memories`	기능별 `config.toml` 키
터미널 UI 사용자 지정	`/keymap`, `/statusline`, `/title`, `/theme`	`[tui]` 아래의 키
편집 기본값 설정	`/vim`, `/raw`	`tui.vim_mode_default`, `tui.raw_output_mode`

일부 명령은 현재 세션에만 적용되며, 일부 선택기에서는 선택 사항을 저장할 수 있습니다. 향후 세션의 기본값으로 사용하려면 관련 구성 키를 설정하세요. 터미널 테마, 편집기, 자동 완성 및 단축키 워크플로에 대해서는 CLI 사용자 지정을 참조하세요.

설정 참고 자료

고급 구성에서는 프로필, 일회성 재정의 및 기타 고급 워크플로를 설명합니다.
구성 참조에는 사용 가능한 키와 값이 나열되어 있습니다.
구성 샘플에서는 완전한 예제 파일을 제공합니다.
환경 변수에서는 CLI와 설치 프로그램에서 사용하는 변수를 설명합니다.

Codex IDE 확장 프로그램에는 두 가지 설정 계층이 있습니다.

Codex 설정 은 모델, 추론 수준, 권한, 샌드박스, MCP server 및 개인화를 포함하여 Codex CLI와 공유되는 에이전트 동작을 제어합니다. Codex는 config.toml에서 이러한 설정을 읽습니다.
편집기 설정 은 VS Code 및 호환 편집기 내에서 확장 프로그램이 작동하는 방식을 제어합니다. 이러한 설정은 편집기의 설정 시스템에서 chatgpt.* 키를 사용합니다.

Codex 설정 열기

Codex 사이드바에서 톱니바퀴 아이콘을 선택한 다음 Codex Settings 를 선택합니다. 일반적인 에이전트 제어에는 설정 패널을 사용하고, 활성 구성 계층을 직접 편집하려면 Open config.toml 을 선택합니다.

구성 계층 순서와 일반적인 키는 구성 기본 사항을 참조하세요. 지원되는 모든 config.toml 키는 구성 참조를 참조하세요.

에디터 설정 변경하기

설정을 변경하려면 다음 단계를 따르세요.

편집기 설정을 엽니다.
@ext:openai.chatgpt, Codex 또는 설정 이름을 검색합니다.
값을 업데이트합니다.

확장 프로그램은 Codex 채팅 화면에 VS Code의 기본 제공 채팅 글꼴 설정도 적용합니다.

에디터 설정 레퍼런스

설정	기본값	설명
`chatgpt.commentCodeLensEnabled`	`true`	Codex가 처리할 수 있도록 `TODO` 주석 위에 CodeLens를 표시합니다.
`chatgpt.openOnStartup`	`false`	확장 프로그램의 시작이 완료되면 Codex 사이드바에 포커스를 둡니다.
`chatgpt.followUpQueueMode`	`queue`	실행 중에 보낸 메시지가 다음 실행을 기다릴지(`queue`), 현재 실행의 방향을 조정할지(`steer`) 선택합니다. 확장 프로그램은 레거시 `interrupt` 값을 `steer`로 처리합니다. 메시지 하나에 대해 이 동작을 반대로 적용하려면 `Cmd`/`Ctrl`+`Shift`+`Enter`를 누르세요.
`chatgpt.composerEnterBehavior`	`enter`	`Enter`를 누르면 항상 전송할지(`enter`), 여러 줄 프롬프트를 `Cmd`/`Ctrl`+`Enter`로 전송할지(`cmdIfMultiline`), 아니면 항상 보조 키를 눌러야 할지(`cmdAlways`) 선택합니다.
`chatgpt.reviewDelivery`	`inline`	가능하면 현재 채팅에서 `/review`를 실행하거나(`inline`), 별도의 리뷰 채팅을 시작합니다(`detached`).
`chatgpt.localeOverride`	자동	Codex UI에 사용할 언어를 설정합니다. 자동으로 감지하려면 비워 두세요.
`chatgpt.runCodexInWindowsSubsystemForLinux`	`false`	Windows 전용: WSL을 사용할 수 있으면 WSL에서 Codex를 실행합니다. 리포지토리와 도구가 WSL2에 있거나 Linux 네이티브 도구가 필요할 때 사용하세요. 이 설정을 변경하면 VS Code가 다시 로드됩니다.
`chatgpt.cliExecutable`	설정 안 됨	개발 전용: Codex CLI 실행 파일의 경로를 설정합니다. Codex CLI를 개발하는 경우가 아니라면 이 설정은 필요하지 않습니다. 번들 실행 파일을 수동으로 재정의하면 확장 프로그램의 일부 기능이 작동하지 않을 수 있습니다.
`chat.fontSize`	편집기 기본값	채팅 내용과 작성기를 포함하여 Codex 사이드바의 채팅 텍스트를 제어합니다.
`chat.editor.fontSize`	편집기 기본값	코드 조각과 diff를 포함하여 Codex 채팅에서 코드로 렌더링되는 콘텐츠를 제어합니다.

위의 chatgpt.* 키는 IDE 확장 프로그램에 속하며 config.toml에 넣지 않습니다. 공유 에이전트 설정은 구성 기본 사항, 고급 구성, 구성 참조를 사용하세요.

최근 검색

추천 검색

문서 탐색