Codex 앱 설정

설정 패널에서 Codex 앱의 동작 방식, 파일 열기 방식, 도구 연결 방식을 조정할 수 있습니다. 앱 메뉴에서 Settings를 열거나 Cmd+,를 누릅니다.

일반

파일이 열릴 위치와 스레드에 표시할 명령 출력의 양을 선택합니다. 여러 줄 프롬프트에 Cmd+Enter를 요구하거나, 스레드가 실행되는 동안 절전 모드를 방지할 수도 있습니다.

알림

턴 완료 알림이 표시되는 시점과 앱이 알림 권한을 요청할지 여부를 선택합니다.

에이전트 구성

앱의 Codex 에이전트는 IDE 및 CLI 확장과 같은 구성을 상속합니다. 일반 설정은 앱 내 컨트롤을 사용하고, 고급 옵션은 config.toml을 편집합니다.

모양

Settings에서 기본 테마를 선택하고, 강조색과 배경색 및 전경색을 조정하고, UI와 코드 글꼴을 바꿔 Codex 앱의 모양을 변경할 수 있습니다. 사용자 지정 테마를 공유할 수도 있습니다.

Codex pets

Codex pets는 앱에서 선택적으로 사용할 수 있는 애니메이션 companion입니다. Settings에서 Appearance로 이동해 Pets를 선택하면 기본 제공 pet을 선택하거나 로컬 Codex 홈에서 사용자 지정 pet을 새로 고칠 수 있습니다. 작성 영역에 /pet을 입력하거나, Settings > Appearance에서 Wake Pet 또는 Tuck Away Pet을 사용하거나, Cmd+K 또는 Ctrl+K를 눌러 같은 명령을 실행하면 floating overlay를 전환할 수 있습니다.

overlay는 다른 앱을 사용하는 동안에도 활성 Codex 작업을 볼 수 있게 합니다. 활성 스레드를 표시하고, Codex가 실행 중인지, 입력을 기다리는지, 리뷰 준비가 되었는지를 반영하며, 짧은 진행 상황 안내와 함께 표시해 스레드를 다시 열지 않고도 변경 내용을 훑어볼 수 있게 합니다.

자체 pet을 만들려면 hatch-pet 스킬을 설치합니다.

$skill-installer hatch-pet

명령 메뉴에서 스킬을 다시 로드합니다. Cmd+K 또는 Ctrl+K를 누르고 Force Reload Skills를 선택한 뒤, 스킬에 pet 생성을 요청합니다.

$hatch-pet create a new pet inspired by my recent projects

Git

Git 설정을 사용해 브랜치 이름 규칙을 표준화하고 Codex가 force push를 사용할지 선택합니다. Codex가 커밋 메시지와 pull request 설명을 생성할 때 사용할 프롬프트도 설정할 수 있습니다.

Integrations & MCP

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

브라우저 사용

이 설정을 사용해 함께 제공되는 Browser 플러그인을 설치하거나 활성화하고, Codex Chrome 확장을 설정하고, allowlist와 blocklist에 있는 웹사이트를 관리합니다. 웹사이트를 allowlist에 넣지 않았다면 Codex는 사용 전에 묻습니다. blocklist에서 사이트를 제거하면 Codex가 브라우저에서 해당 사이트를 사용하기 전에 다시 물을 수 있습니다.

브라우저 미리보기, 댓글, 브라우저 사용 워크플로는 앱 내 브라우저를 참고하십시오.

Computer Use

macOS에서는 설정 후 Computer Use 설정을 확인해 데스크톱 앱 접근 권한과 관련 기본 설정을 검토합니다. 시스템 수준 접근을 철회하려면 macOS 개인정보 보호 및 보안 설정에서 화면 기록 또는 손쉬운 사용 권한을 업데이트합니다.

개인화

기본 personality로 Friendly, Pragmatic, None 중 하나를 선택합니다. personality 지침을 비활성화하려면 None을 사용합니다. 언제든지 업데이트할 수 있습니다.

사용자 지정 지침을 추가할 수도 있습니다. 사용자 지정 지침을 편집하면 AGENTS.md의 개인 지침이 업데이트됩니다.

컨텍스트 인식 제안

컨텍스트 인식 제안은 Codex를 시작하거나 다시 돌아올 때 이어서 처리하고 싶은 후속 작업과 재개할 작업을 표시하는 데 사용합니다.

메모리

사용할 수 있는 경우 메모리를 활성화하면 Codex가 과거 스레드의 유용한 컨텍스트를 이후 작업으로 가져갈 수 있습니다. 설정, 저장 위치, 스레드별 제어는 메모리를 참고하십시오.

보관된 스레드

Archived threads 섹션은 날짜와 프로젝트 컨텍스트가 포함된 보관 채팅을 나열합니다. 스레드를 복원하려면 Unarchive를 사용합니다.