학습 블록
permission profile
권한 프로필 개념
Codex CLI 한국어 매뉴얼 v1.1 (AI 치트키) · _local/Codex_CLI_한국어_매뉴얼_v1.1_Part3.pdf · Codex 설정에는 permission profile이라는 별도 개념도 있다.
CH3-P3 · 학습 챕터
03. Codex CLI · P3
설정 · 세션 슬래시
Part 3는 permission profile, 원격 app-server, --search, 그리고 세션 슬래시(/new, /resume, /fork, /clear 등)를 다룹니다.
정본: Codex CLI 한국어 매뉴얼 v1.1 (AI 치트키) · _local/Codex_CLI_한국어_매뉴얼_v1.1_Part3.pdf대상: 바이브코더 · Codex CLI 중급 — Cloud·옵션·슬래시 명령
챕터 이동chapter-nav
이전·다음 챕터로 이동합니다. 본문은 아래 학습 블록 카드에서 펼칩니다.
전체 학습 블록 카드learn-blocks
학습 블록
--remote
원격 app-server 연결
Codex CLI 한국어 매뉴얼 v1.1 (AI 치트키) · _local/Codex_CLI_한국어_매뉴얼_v1.1_Part3.pdf · codex -h
학습 블록
codex app-server
앱 서버 모드
Codex CLI 한국어 매뉴얼 v1.1 (AI 치트키) · _local/Codex_CLI_한국어_매뉴얼_v1.1_Part3.pdf · lsof -nP -iTCP:8765 명령어로 연결 상태를 확인해 보자.
학습 블록
--search
웹 검색 허용
Codex CLI 한국어 매뉴얼 v1.1 (AI 치트키) · _local/Codex_CLI_한국어_매뉴얼_v1.1_Part3.pdf · codex -h
학습 블록
/new
새 대화 시작
Codex CLI 한국어 매뉴얼 v1.1 (AI 치트키) · _local/Codex_CLI_한국어_매뉴얼_v1.1_Part3.pdf · /new는 Codex TUI 안에서 새 대화를 시작하는 slash command이다.
학습 블록
/clear
화면·대화 초기화
Codex CLI 한국어 매뉴얼 v1.1 (AI 치트키) · _local/Codex_CLI_한국어_매뉴얼_v1.1_Part3.pdf · 공식 문서에서는 /clear를 "터미널을 비우고 새 chat을 시작하는 명령"으로 설명한다.
학습 블록
/resume
세션 이어하기
Codex CLI 한국어 매뉴얼 v1.1 (AI 치트키) · _local/Codex_CLI_한국어_매뉴얼_v1.1_Part3.pdf · /resume,
학습 블록
/fork
세션 분기
Codex CLI 한국어 매뉴얼 v1.1 (AI 치트키) · _local/Codex_CLI_한국어_매뉴얼_v1.1_Part3.pdf · /resume은 저장된 이전 conversation을 다시 불러오는 명령이다.
학습 블록
/rename
스레드 이름
Codex CLI 한국어 매뉴얼 v1.1 (AI 치트키) · _local/Codex_CLI_한국어_매뉴얼_v1.1_Part3.pdf · /new는 TUI 안에서 쓰는 slash command이다.
학습 블록
/side
사이드 대화
Codex CLI 한국어 매뉴얼 v1.1 (AI 치트키) · _local/Codex_CLI_한국어_매뉴얼_v1.1_Part3.pdf · /side는 임시 side conversation을 시작하는 명령이다.
학습 블록
/compact
대화 압축
Codex CLI 한국어 매뉴얼 v1.1 (AI 치트키) · _local/Codex_CLI_한국어_매뉴얼_v1.1_Part3.pdf · 이미 Codex가 수정한 파일, 실행한 명령, background terminal, git 상태는 별도로 확인해야 한다.
학습 블록
/logout
TUI 로그아웃
Codex CLI 한국어 매뉴얼 v1.1 (AI 치트키) · _local/Codex_CLI_한국어_매뉴얼_v1.1_Part3.pdf · /logout을 사용하고, Codex TUI 자체를 닫으려면
학습 블록
/exit
TUI 종료
Codex CLI 한국어 매뉴얼 v1.1 (AI 치트키) · _local/Codex_CLI_한국어_매뉴얼_v1.1_Part3.pdf · /clear는 TUI 안에서 쓰는 slash command이다.
학습 블록
/status
세션 상태
Codex CLI 한국어 매뉴얼 v1.1 (AI 치트키) · _local/Codex_CLI_한국어_매뉴얼_v1.1_Part3.pdf · /status에서 context 여유가 많이 줄어든 것을 확인했을 때
학습 블록
/title
상태줄 제목
Codex CLI 한국어 매뉴얼 v1.1 (AI 치트키) · _local/Codex_CLI_한국어_매뉴얼_v1.1_Part3.pdf · /title은 터미널 창이나 탭 제목에 어떤 정보를 표시할지 설정하는 명령이다.
학습 블록
/statusline
상태줄 설정
Codex CLI 한국어 매뉴얼 v1.1 (AI 치트키) · _local/Codex_CLI_한국어_매뉴얼_v1.1_Part3.pdf · /statusline은 Codex TUI 안의 status line에 표시할 항목을 고르는 명령이다.
학습 블록
/keymap
키맵 커스터마이즈
Codex CLI 한국어 매뉴얼 v1.1 (AI 치트키) · _local/Codex_CLI_한국어_매뉴얼_v1.1_Part3.pdf · /keymap은 Codex TUI 안에서 키보드 단축키를 확인하고 바꾸는 slash command이다.
학습 블록
/copy
응답 복사
Codex CLI 한국어 매뉴얼 v1.1 (AI 치트키) · _local/Codex_CLI_한국어_매뉴얼_v1.1_Part3.pdf · /copy는 Codex TUI에서 가장 최근에 완료된 Codex 응답을 클립보드로 복사하는 slash command이다.
학습 블록
/mention
파일 멘션 (개요)
Codex CLI 한국어 매뉴얼 v1.1 (AI 치트키) · _local/Codex_CLI_한국어_매뉴얼_v1.1_Part3.pdf · /diff는 현재 git 변경 내용을 보여 주는 명령이다.
선택 블록 본문block-detail
permission profile
권한 프로필 개념
--profile은 Codex 전체 설정 묶음을 고르는 CLI 옵션이다.
관련 개념
Codex 설정에는 permission profile이라는 별도 개념도 있다.
이것은 --profile과 같은 기능이 아니다.
--profile은 Codex 전체 설정 묶음을 고르는 CLI 옵션이다.
반면 permission profile은 파일 접근이나 네트워크 접근 같은 권한 정책을 재사용하기 위한 설정이다.
default_permissions와 [permissions.
언제 사용하나
-p, --profile은 다음 상황에서 사용한다. 한두 번만 바꿀 설정이면 -m, -s, -c 같은 전용 옵션이 더 간단하다. 반복해서 쓰는 설정 조합이면 profile이 더 적합하다.
주의사항
--profile은 profile을 새로 만들어 주는 옵션이 아니다. config.toml에 먼저 profile이 정의되어 있어야 한다. profile 이름을 틀리면 원하는 설정이 적용되지 않거나 실행이 실패할 수 있다. 자동화에 넣기 전에는 config.toml의 profile 이름을 확인해야 한다. profile에는 권한과 sandbox 관련 설정도 들어갈 수 있다. danger-full-access, approval_policy = "never" 같은 강한 설정을 profile에 넣으면 매번 그 위험한 설정을 쉽
codex --profile review
작업별로 모델과 권한 설정을 다르게 쓰고 싶을 때 읽기 전용 분석, 일반 개발, 깊은 리뷰처럼 실행 모드를 나누고 싶을 때 자동화 스크립트에서 긴 옵션 목록을 줄이고 싶을 때 팀 문서에 실행 방식을 profile 이름으로 남기고 싶을 때 여러 설정을 매번 -c로 쓰지 않고 재사용하고 싶을 때 게 재사용하게 된다.
권한이 큰 profile은 이름부터 분명하게 짓고, 사용 범위를 좁히는 것이 좋다. profile은 계정 전환 기능이 아니다. OpenAI 로그인 계정이나 결제 계정을 바꾸는 용도로 이해하면 안 된다. 공식 문서 기준으로 profile 기능은 experimental 성격이며, 향후 릴리스에서 바뀌거나 제거될 수 있다. 또한 현재 문서 기준으로 Codex IDE extension에서는 profile이 지원되지 않는다. CLI용 설정 묶음으로 이해하는 편이 안전하다.
세부 도움말 확인
이 매뉴얼은 -p, --profile 옵션이 무엇인지 이해하기 위한 개요이다. 세부 옵션 설명은 현재 설치된 CLI의 help에서 확인하는 것이 정확하다. codex exec에서 사용할 때는 다음 도움말을 확인한다. profile에 넣을 수 있는 설정 키는 config.toml 문서와 현재 CLI 버전에 따라 달라질 수 있다. 자세한 설정 키는 현재 Codex 설정 문서와 config reference를 확인한다.
정리
-p, --profile은 config.toml에 정의한 설정 묶음을 이름으로 선택하는 옵션이다. 반복해서 쓰는 모델, 권한, sandbox, 승인 정책 조합을 profile로 만들어 두고 실행할 때 불러올 수 있다. 단발성 변경은 -m, -s, -c 같은 전용 옵션이 간단하다. 반복해서 쓰는 실행 모드는 --profile로 관리하는 편이 명확하다.
codex