⊞ WINDOWS AI 코딩 도구 치트시트 — Claude Code & Codex CLI · Windows 기준
📋 최근 변경사항 (v2.1.92–107)
  • 긴 작업 중 thinking 힌트를 더 빠르게 표시 (v2.1.107)
  • EnterWorktree 도구에 path 파라미터 추가 — 기존 워크트리로 전환 가능 (v2.1.105)
  • PreCompact 훅 지원 추가 — 컴팩션 차단 가능 (exit 2 또는 {"decision":"block"}) (v2.1.105)
  • 플러그인 monitors manifest 키로 백그라운드 모니터 지원 (v2.1.105)
  • /proactive/loop 의 별칭으로 추가 (v2.1.105)
  • /team-onboarding 명령어 추가 — 팀원 온보딩 가이드 생성 (v2.1.101)
  • OS CA 인증서 스토어 기본 신뢰 추가 — 엔터프라이즈 TLS 프록시 추가 설정 불필요 (v2.1.101)
  • 기본 노력 수준이 API키·Bedrock·Vertex·Enterprise 사용자는 medium에서 high로 변경 (v2.1.94)
  • /vim 명령어 제거됨 — Vim 모드는 /config → Editor mode에서 설정 (v2.1.92)
🔧 스킬 & 에이전트
내장 스킬
/simplify
코드 리뷰 (병렬 에이전트 3개)
/batch
대규모 병렬 변경 (5-30 워크트리)
/debug [desc]
디버그 로그로 문제 해결
/loop [interval]
반복 예약 작업
/claude-api
API + SDK 참조 로드
커스텀 스킬 위치
.claude/skills/<n>/
프로젝트 스킬
~/.claude/skills/<n>/
개인 스킬
스킬 프론트매터
description
자동 호출 트리거
allowed-tools
권한 프롬프트 생략
model
스킬용 모델 재정의
effort
노력 수준 재정의
paths: [globs]
경로별 적용 NEW
context: fork
서브에이전트에서 실행
$ARGUMENTS
사용자 입력 플레이스홀더
${CLAUDE_SKILL_DIR}
스킬 자신의 디렉터리
!`cmd`
동적 컨텍스트 주입
plugin bin/
Bash 도구용 실행 파일 NEW
🖥️ CLI & 플래그
핵심 명령
claude
대화형 시작
claude "q"
프롬프트와 함께 시작
claude -p "q"
헤드리스 (비대화형)
claude -c
마지막 대화 이어가기
claude -r "n"
이름으로 세션 재개
claude update
업데이트
내장 에이전트
Explore
빠른 읽기 전용 (Haiku)
Plan
플랜 모드용 리서치
General
전체 도구, 복잡한 태스크
Bash
터미널 별도 컨텍스트
에이전트 프론트매터
permissionMode
default/acceptEdits/plan/bypass
isolation: worktree
git 워크트리에서 실행
memory:
user|project|local 영구 메모리
background: true
백그라운드 태스크
maxTurns
에이전트 턴 제한
initialPrompt
첫 턴 자동 제출
SendMessage
에이전트 재개 (resume 대체)
@agent-name
하위 에이전트 멘션 NEW
주요 플래그
--model
모델 지정
-w
Git 워크트리
-n / --name
세션 이름 지정
--add-dir
작업 디렉터리 추가
--agent
에이전트 사용
--allowedTools
도구 사전 승인
--output-format
json/stream 출력
--json-schema
구조화 출력 스키마
--max-turns
최대 턴 수 제한
--max-budget-usd
비용 상한
--console
Anthropic Console 인증
--verbose
상세 로그
--bare
최소 헤드리스 (훅/LSP 없음)
--channels
권한 릴레이 / MCP 푸시
--remote
웹 세션 연결
--effort
low/medium/high/max
--permission-mode
plan/default/acceptEdits…
--dangerously-skip-permissions
모든 프롬프트 생략 ⚠️
--chrome
Chrome 연동
PowerShell tool
Windows 옵트인 미리보기 NEW ⊞ WIN
⌨️ 키보드 단축키
일반 제어
Ctrl+C
입력/생성 취소
Ctrl+D
세션 종료
Ctrl+L
화면 지우기
Ctrl+O
상세 출력 전환
Ctrl+R
히스토리 검색
Ctrl+G
프롬프트 편집기 열기
Ctrl+B
백그라운드 실행
Ctrl+T
태스크 목록 전환
Ctrl+V
이미지 붙여넣기
EscEsc
되감기 / 요약
모드 전환
Shift+Tab
권한 모드 순환
Alt+P
모델 전환
Alt+T
Thinking 모드
Alt+O
빠른 모드 NEW
입력
\Enter
줄바꿈 (빠른)
Ctrl+J
줄바꿈 (제어)
/
슬래시 명령어
!
직접 Bash 실행
@
파일 자동완성
세션 선택기
탐색
확장/축소
P
미리보기
R
이름 변경
/
검색
트랜스크립트 (Ctrl+O)
/
검색
N / ⇧N
다음/이전
Q / Esc
종료
⚡ 슬래시 명령어
세션 (Session)
/clear
대화 내용 초기화
/compact [focus]
컨텍스트 압축
/resume
세션 재개/전환
/rename [name]
현재 세션 이름 변경
/branch [name]
대화 브랜치 생성 (/fork)
/cost
토큰 사용량 통계
/context
컨텍스트 시각화 (그리드)
/diff
인터랙티브 diff 뷰어
/copy [N]
마지막(N번째) 응답 복사
/rewind
코드/체크포인트 되감기
/export
대화 내보내기
설정 (Config)
/config
설정 열기
/model [model]
모델 전환 (←→ effort)
/fast [on|off]
빠른 모드 전환
/vim
Vim 모드 전환
/theme
컬러 테마 변경
/permissions
권한 보기/수정
/effort [level]
노력 수준 설정 (low/med/high/max)
/color [color]
프롬프트 바 색상 설정
/keybindings
키보드 단축키 커스텀
/terminal-setup
터미널 키바인딩 설정
도구 (Tools)
/init
CLAUDE.md 생성
/memory
CLAUDE.md 파일 편집
/mcp
MCP 서버 관리
/hooks
훅 관리
/skills
사용 가능한 스킬 목록
/agents
에이전트 관리
/chrome
Chrome 연동
/reload-plugins
플러그인 핫 리로드
/add-dir <path>
작업 디렉터리 추가
특수 (Special)
/powerup
인터랙티브 기능 학습 NEW
/btw <question>
컨텍스트 없는 사이드 질문
/plan [desc]
플랜 모드 (+ 자동 시작)
/loop [interval]
반복 작업 스케줄링
/voice
음성 입력 (20개 언어)
/doctor
설치 상태 진단
/pr-comments [PR]
GitHub PR 코멘트 가져오기
특수 (계속)
/stats
사용량 스트릭 & 설정
/insights
세션 분석 리포트
/desktop
데스크탑 앱에서 계속
/remote-control
claude.ai/code 브릿지 (/rc) NEW
/usage
플랜 한도 & 상태
/schedule
클라우드 예약 작업
/security-review
변경사항 보안 분석
/help
도움말 + 명령어 목록
/feedback
피드백 제출 (별칭: /bug)
/release-notes
전체 변경 내역 보기
/stickers
스티커 주문 🎉
🔌 MCP 서버
서버 추가
--transport http
원격 HTTP 권장
--transport stdio
로컬 프로세스
--transport sse
원격 SSE
스코프
~/.claude.json
로컬 (본인만)
.mcp.json
프로젝트 (VCS 공유)
관리
/mcp
인터랙티브 UI
claude mcp list
전체 서버 목록
claude mcp serve
CC를 MCP 서버로 실행
🧠 워크플로 & 팁
Plan Mode
Shift+Tab
일반 → 자동수락 → 계획 모드
--permission-mode plan
플랜 모드로 시작
Thinking & Effort
Alt+T
사고 모드 켜기/끄기
ultrathink
해당 턴 최대 노력 모드
/effort
○ low · ◐ medium · ● high · ★ max
Git Worktrees
--worktree name
기능별 격리 브랜치
sparsePaths
필요한 디렉터리만 체크아웃
/batch
워크트리 자동 생성
세션 파워 무브
claude -r "name"
이름으로 세션 재개
/btw question
컨텍스트 비용 없는 사이드 질문
SDK / Headless
claude -p "query"
비대화형 실행
--output-format json
구조화 출력
--max-budget-usd 5
비용 상한 설정
cat file | claude -p
파이프 입력
스케줄링 & 원격
/loop 5m msg
반복 작업 예약
/rc
원격 제어
📁 메모리 & 파일
./CLAUDE.md
프로젝트 (팀 공유)
~/.claude/CLAUDE.md
개인 (전체 프로젝트)
/etc/claude-code/
조직 관리 (Managed)
.claude/rules/*.md
프로젝트 규칙
~/.claude/rules/*.md
사용자 규칙
paths:
프론트매터 경로별 규칙
@path/to/file
CLAUDE.md에서 파일 임포트
⚙️ 설정 & 환경 변수
설정 파일
~/.claude/settings.json
사용자 설정
.claude/settings.json
프로젝트 (공유)
.claude/settings.local.json
로컬 전용
~/.claude.json
OAuth, MCP, 상태
.mcp.json
프로젝트 MCP 서버
핵심 설정 항목
modelOverrides
모델 피커 → 커스텀 ID 매핑
worktree.sparsePaths
스파스 체크아웃 경로
hooks: if
조건부 훅 (권한 규칙 문법)
PermissionDenied
자동 모드 거부 훅 NEW
showThinkingSummaries
사고 요약 표시 (기본 off) NEW
hooks: "defer"
헤드리스 일시정지 → 나중에 재개
disableSkillShellExec
스킬/플러그인 !`cmd` 차단 NEW
핵심 환경 변수
ANTHROPIC_API_KEY
API 키
ANTHROPIC_MODEL
모델 지정
CLAUDE_CODE_EFFORT_LEVEL
low/medium/high/max/auto
MAX_THINKING_TOKENS
0 = 사고 비활성화
ANTHROPIC_CUSTOM_MODEL_OPTION
커스텀 /model 항목
CLAUDE_CODE_SUBPROCESS_ENV_SCRUB
서브프로세스 크리덴셜 제거
CLAUDE_STREAM_IDLE_TIMEOUT_MS
스트리밍 감시 (기본 90s)
CLAUDE_CODE_NO_FLICKER
대체 화면 렌더링 (=1) NEW
MCP_CONNECTION_NONBLOCKING
-p에서 MCP 대기 생략 NEW
CLAUDECODE
CC 셸 감지 (=1)
CLAUDE_CODE_MAX_OUTPUT_TOKENS
최대 출력 토큰 (기본 32K)
CLAUDE_CODE_DISABLE_CRON
크론 비활성화
📋 최근 변경사항 (v0.119.0–120.0)
  • Codex 0.120.0 — Realtime V2 백그라운드 에이전트 진행상황 스트리밍 지원 (2026-04-11)
  • TUI 내 훅 활동 표시 개선 — 실행 중 / 완료 훅 분리 표시 NEW
  • TUI 상태줄에 스레드 제목 포함 가능 (configurable status line)
  • /resume 명령어로 TUI에서 ID 및 이름으로 세션 직접 이동 가능 (v0.119.0)
  • Realtime 음성 세션 v2 WebRTC 경로 기본 적용 (v0.119.0)
  • MCP Apps 서버: 리소스 읽기·보다 풍부한 툴 지원 (v0.119.0)
  • Windows 샌드박스 스플릿 파일시스템 관련 버그 수정 (v0.120.0)
  • 업그레이드: npm i -g @openai/codex@latest
🖥️ CLI & 플래그
핵심 명령
codex
대화형 TUI
codex exec "prompt"
비대화형 실행
codex exec resume --last
마지막 exec 세션 이어가기
codex resume --last
대화형 세션 재개
codex fork --last
최근 세션 포크
codex apply TASK_ID
Cloud task diff 로컬 적용
codex cloud list --json
최근 Cloud task 조회
codex mcp list
MCP 서버 목록
codex features list
기능 플래그 확인
codex completion powershell
PowerShell completion 생성
전역 플래그
--model
모델 강제 지정 (예: gpt-5.4)
--sandbox
read-only | workspace-write
--ask-for-approval
untrusted | on-request | never
--full-auto
Auto 프리셋
--yolo
승인/샌드박스 우회 위험
--search
웹 검색 live 모드 전환
--add-dir
추가 디렉터리 쓰기 권한
-c key=value
1회성 config override
exec / 자동화
codex exec -
stdin에서 프롬프트 읽기
cat spec.md | codex exec "Implement this"
프롬프트 + stdin 병행
--json
JSONL 이벤트 출력
--output-last-message out.txt
최종 응답 파일 저장
--output-schema schema.json
구조화 출력 검증
--skip-git-repo-check
Git 저장소 외부 실행 허용
--ephemeral
세션 상태를 디스크에 남기지 않음
MCP / App / Cloud
codex mcp add name -- url
stdio 또는 HTTP MCP 등록
codex mcp login name
OAuth형 MCP 로그인
codex mcp-server
Codex 자체를 MCP 서버로 실행
codex cloud exec --env ENV_ID
Cloud task 직접 제출
codex app
데스크톱 앱 실행
⚡ 슬래시 명령어
세션 제어
/clear
화면과 대화 초기화
/new
새 대화 시작
/resume
저장된 대화 재개
/fork
현재 대화 분기
/compact
컨텍스트 절약
/copy
마지막 응답 복사
/status
모델/권한/토큰 확인
/debug-config
config 레이어 진단
작업 흐름
/plan
계획 모드 전환
/diff
Git diff 검토
/review
작업 트리 리뷰
/mention
파일/폴더 첨부
/agent
에이전트 스레드 전환
/ps
백그라운드 터미널 상태
/mcp
MCP 도구 목록
/apps
앱/커넥터 삽입
설정 전환
/model
모델 및 추론 수준 변경
/fast
Fast mode on/off/status
/permissions
승인 정책 변경
/personality
friendly / pragmatic / none
/experimental
실험 기능 토글
/statusline
하단 상태줄 항목 구성
/logout
로그아웃
🔐 보안 & 샌드박스
추천 조합
--sandbox read-only -a on-request
안전한 브라우징/질의응답
--sandbox workspace-write -a untrusted
파일 편집 허용, 위험 명령 승인
--full-auto
로컬 자동화 프리셋
--yolo
완전 우회, 격리 환경에서만 위험
네트워크 / 보호 경로
[sandbox_workspace_write]
세부 샌드박스 설정
web_search = "cached"
기본 검색 캐시 모드
web_search = "live"
실시간 검색 또는 --search
⚙️ 설정 & 파일
주요 파일 위치
~/.codex/config.toml
사용자 기본 설정
.codex/config.toml
프로젝트별 설정
~/.codex/auth.json
파일 기반 인증 캐시
AGENTS.md
리포지토리 작업 지침
~/.codex/skills
사용자 스킬
.codex/skills
프로젝트 스킬
자주 바꾸는 옵션
model = "gpt-5.4"
기본 모델
approval_policy = "on-request"
승인 정책
sandbox_mode = "workspace-write"
샌드박스 정책
model_reasoning_effort = "high"
추론 강도
personality = "friendly"
응답 스타일
log_dir = "./.codex-log"
로그 저장 경로
cli_auth_credentials_store = "keyring"
인증 저장소
기능 플래그
[features]
옵션 기능 on/off
fast_mode = true
Fast mode
multi_agent = true
서브에이전트 협업
shell_snapshot = true
반복 명령 가속
smart_approvals = false
실험 기능
codex_hooks = false
훅 엔진 실험
플러그인 · MCP
.codex-plugin/plugin.json
플러그인 manifest
skills/
패키징된 스킬
.mcp.json
MCP 매핑
.app.json
App/connector 매핑
~/.codex/plugins/
사용자 스코프 플러그인
./plugins/
로컬 플러그인 디렉터리
⊞ Windows & WSL
Windows 설정
[windows]
Windows 전용 섹션
sandbox = "elevated"
높은 권한 샌드박스 (권장)
sandbox = "unelevated"
일반 권한 대안
/sandbox-add-read-dir C:\path
Windows 읽기 경로 추가
WSL 사용
wsl --install
WSL 설치
code .
WSL 터미널에서 VS Code 열기
npm i -g @openai/codex
WSL 안에서 Codex 설치
chatgpt.runCodexInWindowsSubsystemForLinux
VS Code WSL 설정
🧠 모델 · 워크플로 · 빠른 시작
모델 선택
gpt-5.4
대부분의 전문 작업용 기본 선택
gpt-5.4-mini
빠른 탐색, 경량 서브에이전트
gpt-5.3-codex-spark
실시간/초저지연 연구 프리뷰
codex --model gpt-5.4-mini
CLI에서 즉시 전환
/model
세션 중 모델 전환
/fast on
GPT-5.4 계열 빠른 경로
/fast status
현재 상태 확인
Cloud / 비동기
codex cloud exec --attempts 3
best-of-N 스타일 시도
권장 워크플로
1. 깨끗한 Git 상태에서 시작
2. /plan 또는 read-only로 먼저 방향 확인
3. Auto 또는 workspace-write로 구현
4. /diff/review 로 검토
5. 테스트 후 커밋/PR 생성
운영 팁
API 키 자동화보다 로컬 사용은 ChatGPT 로그인 권장
원격/헤드리스 환경은 --device-auth 우선 검토
프로젝트 규칙은 AGENTS.md.codex/ 에 모음
설치 & 로그인
npm i -g @openai/codex
Codex CLI 전역 설치
brew install --cask codex
macOS 대안 설치
npm i -g @openai/codex@latest
최신 버전 업그레이드
codex login
기본 브라우저 OAuth 로그인
codex login --device-auth
헤드리스/원격 장치용
printenv OPENAI_API_KEY | codex login --with-api-key
API 키 인증
codex login status
인증 상태 확인