AI 코딩 CLI 명령어 가이드

세션 중 언제든 모델을 바꿀 수 있습니다. (Opus 4.8은 Claude Code v2.1.154+ 필요)
opus Opus 4.8 · 최신 최강, Max·API 기본값
opus[1m] Opus 4.8 · 1M 컨텍스트 명시 (대규모 코드베이스 전체 분석)
sonnet Sonnet 4.6 · Pro 기본값, 빠르고 효율적
sonnet[1m] Sonnet 4.6 · 1M 컨텍스트
haiku Haiku 4.5 · 가장 빠름, 간단한 수정
opusplan 플랜 단계는 opus, 실행 단계는 sonnet으로 자동 전환
팁: 평소 sonnet → 막히면 opus 전환 → 해결 후 sonnet 복귀. Opus는 Max·Team·Enterprise·API에서 자동으로 1M 컨텍스트(Pro는 크레딧 필요) — 굳이 켜려면 opus[1m]. 버전 고정하려면 /model claude-opus-4-8

한 번 설정하면 이후 모든 응답에 반영됩니다.
low 빠른 응답 · 짧고 단순한 작업
medium 비용 절감 · 약간의 지능 희생 감수
high 균형 · 대부분의 코딩 작업 (Opus 4.8 기본값)
xhigh 더 깊은 추론 · Opus 4.8·4.7만 지원 (4.7은 이게 기본값)
max 최대 깊이 · 토큰 제한 없음, 세션 한정
ultracode xhigh + 동적 워크플로우 자동 오케스트레이션 · 세션 한정
auto 모델 기본값으로 리셋
팁: Opus 4.8 기본값은 high(4.7은 xhigh였음). xhigh는 Opus 4.8·4.7만 — Sonnet 4.6·Opus 4.6에선 자동으로 high로 동작. ultrathink는 한 메시지에만, /effort는 세션 전체에 적용

메시지에 ultrathink를 포함하면 그 턴만 더 깊이 사고하도록 요청합니다.
/effort와 달리 해당 메시지 한 번에만 적용, 세션 설정은 안 바뀜. 'think hard' 같은 말은 일반 텍스트일 뿐 — 키워드로 인식되는 건 ultrathink뿐

대화가 길어졌을 때 이전 대화를 요약하여 공간을 확보합니다.
주제를 지정하면 해당 내용 위주로 요약. 긴 작업 중간에 주기적으로 쓰면 효율적

코드와 대화를 이전 체크포인트로 되돌립니다.
되돌릴 지점 선택 UI가 표시됩니다.
코드만 복원 / 대화만 복원 / 둘 다 복원 선택 가능.
단축키: Esc 두 번 연타. 잘못된 수정이 적용됐을 때 즉시 복구

읽기 전용 상태로 들어가 계획만 수립합니다. 파일을 수정하거나 명령을 실행하지 않음.
큰 작업 시작 전 방향성부터 맞출 때 유용. 승인하면 실행 단계로 진입

완료 조건을 정해두면 그 조건이 충족될 때까지 Claude가 알아서 여러 턴 돌립니다. 화면 위에 경과 시간 · 턴 수 · 토큰 사용량이 라이브로 표시돼서 진행 상황을 한눈에 봅니다.
/goal clear 목표를 다 이루기 전에 중간에 해제할 때. 조건이 충족되면 자동으로 풀리므로 평소엔 입력할 필요 없음.
긴 반복 작업을 끝까지 끌고 갈 때 강력. /plan은 설계 단계, /goal은 끝까지 실행 단계

같은 작업을 정해둔 간격마다 자동으로 다시 돌립니다. 상태 폴링이나 반복 점검처럼 '계속 지켜봐야 하는' 일에 적합.
5m·10m·1h 반복 간격 (분·시간) · 슬래시 명령이든 일반 프롬프트든 반복 가능
간격을 적으면 그 주기로 고정, 생략하면 Claude가 작업 성격에 맞춰 다음 실행 시점을 스스로 정함. CI 통과 대기·배포 모니터링·주기적 PR 점검처럼 한 번이 아니라 '될 때까지·바뀔 때까지' 봐야 하는 일에. /goal이 한 목표를 끝까지 끌고 가는 거라면, /loop은 같은 작업을 간격마다 되풀이

이번 세션에서 수정된 파일들의 diff를 보여줍니다.
좌우 화살표로 git diff와 턴별 diff를 전환할 수 있습니다.
커밋 전에 변경 내역을 최종 리뷰할 때 유용

현재 브랜치/diff의 변경분을 리뷰합니다. effort 레벨로 범위를 조절: low·medium은 확실한 것만 적게, high·max는 넓게(불확실한 것 포함), ultra는 클라우드에서 여러 에이전트를 병렬로 돌려 심층 리뷰.
--comment 결과를 PR 인라인 코멘트로 게시 · --fix 지적사항을 작업트리에 바로 적용
/security-review가 보안 집중이라면 /code-review ultra는 아키텍처·품질·엣지케이스까지 종합. 예전 이름 /ultrareview는 이제 /code-review ultra의 별칭(deprecated)

로컬 /plan과 달리 클라우드에서 더 깊게 계획을 짜고, 결과를 로컬에서 실행하거나 원격에서 계속 돌릴 수 있습니다.
큰 리팩토링이나 멀티 파일 작업처럼 단순 /plan으로 감당 안 되는 규모에 적합

한 대화로 조율하기엔 큰 작업을, Claude가 JavaScript 오케스트레이션 스크립트를 짜서 백그라운드에서 다수 서브에이전트로 돌립니다. 중간 결과는 스크립트 변수에 담기고 대화 컨텍스트엔 최종 결과만 남음.
/workflows 진행 중·완료 런을 보고 일시정지·중단·재개 · 마음에 들면 s로 명령어로 저장(재사용)
한도: 동시 최대 16개 · 런당 총 1,000개 에이전트. v2.1.154+ · 모든 유료 플랜(Pro는 /config에서 켜기).
코드베이스 전체 버그 스윕, 수백 파일 마이그레이션, 여러 각도로 교차검증하는 리서치에 적합. ⚠️ 에이전트를 대량으로 띄우므로 토큰 소모가 큼. /goal이 한 대화를 끝까지 끌고 가는 거라면, 워크플로우는 작업을 코드로 짜서 대규모 병렬 실행

대화 내용을 전부 삭제하고 새 세션으로 시작합니다.
주제가 완전히 바뀔 때 사용. 파일 변경사항은 유지됨 (git으로 관리)

프로젝트 루트에 CLAUDE.md 파일을 생성합니다. 프로젝트 규칙, 빌드 명령어 등을 적어두면 매 세션마다 자동 참고.
팀원 모두가 동일한 규칙으로 Claude를 사용할 수 있게 해줌

본인의 Claude Code 사용 패턴을 분석해서 신규 팀원이 따라할 수 있는 ramp-up 가이드를 자동으로 만들어줍니다.
/init이 프로젝트 규칙 정리라면, /team-onboarding은 "이 사람이 어떻게 쓰는지" 워크플로우 자체를 정리

이번 세션에서 사용한 토큰 수와 예상 비용을 표시합니다.
API 사용자에게 유용. Max 플랜은 월정액이라 참고용

대화 중에 터미널 명령이 필요할 때 세션을 벗어나지 않고 실행합니다. 결과가 대화 컨텍스트에 포함됩니다.

같은 모델의 빠른 출력 버전을 켜고 끕니다. 모델이 바뀌는 게 아니라 같은 품질로 속도만 올라감.
Opus 4.8·4.7에서 사용 가능(4.6은 곧 지원 종료). 출력 속도 약 2.5배, 토큰당 비용은 더 높음. 단 Opus 4.8 fast는 이전 모델 대비 3배 저렴해짐(리서치 프리뷰)

푸시투토크 방식의 음성 받아쓰기를 켜고 끕니다. 지정한 키를 누르는 동안만 음성이 입력됨.
손이 바쁠 때나 긴 프롬프트를 빠르게 말로 넣을 때 유용

현재 컨텍스트 윈도우 사용량을 시각적으로 표시합니다.
부족해지면 /compact로 공간 확보

현재 버전, 모델, 계정, 연결 상태를 표시합니다.

claude.ai/code 웹에서 현재 터미널 세션을 원격으로 조작합니다.
모바일이나 다른 기기에서 진행 상황을 보고 지시를 보낼 수 있음. 단축 별칭은 /rc

짧은 대화형 레슨으로 Claude Code의 기능을 직접 배워봅니다.
처음 쓰는 명령이 있을 때 /help로 설명을 읽는 대신, /powerup으로 따라 해보며 익히기 좋음

터미널 종료 후에도 이전 대화를 그대로 이어갈 수 있습니다.
--continue는 prompt 없이 바로 복귀, --resume은 골라서 복귀.
긴 작업 중간에 터미널을 닫거나 재부팅해도 안전. Codex의 codex --continue와 동일한 결

백그라운드에서 도는 모든 세션을 상태별 대시보드 하나로 봅니다. 터미널 탭 여러 개 띄울 필요 없음.
/bg 세션 안에서 현재 대화를 백그라운드로 보냄
세션은 작업중 · 입력대기 · 완료 등 상태로 그룹핑되고 색·아이콘으로 구분.
Space 미리보기 · Enter 진입(attach) · Ctrl+X 두 번 삭제
터미널을 꺼도 supervisor 프로세스가 세션을 계속 돌림. 셸에선 claude attach/logs/stop <id>로 관리.
"버그수정 + PR리뷰 + 테스트조사" 동시에 던져두고 입력 필요한 것만 처리. ⚠️ 병렬 N개 = 토큰 N배 소진. v2.1.139+ research preview (Pro/Max/Team/Enterprise/API)

특정 시점(도구 호출 전/후, 권한 요청, 세션 종료 등)에 쉘 명령·HTTP·LLM 프롬프트를 자동 실행하도록 등록합니다.
대표 이벤트: PreToolUse (도구 호출 전 — 차단 가능) · PostToolUse · PermissionRequest · Stop
설정은 ~/.claude/settings.json 또는 프로젝트의 .claude/settings.json에 저장됨.
"매번 X 하면 자동으로 Y 실행" 같은 결정론적 규칙은 메모리가 아니라 hooks로 박아야 동작. 예: 파일 저장 후 자동 lint

매번 뜨는 도구 승인 프롬프트를 규칙으로 박아 없애거나, 위험한 동작을 아예 차단합니다.
현재 허용/차단 규칙과 각 규칙이 어느 설정 파일에서 왔는지까지 보여줍니다.
규칙 우선순위 deny → ask → allow (deny가 항상 먼저).
설정 파일은 3곳, 충돌 시 뒤로 갈수록 우선: ~/.claude/settings.json(전역) → .claude/settings.json(프로젝트·공유) → .claude/settings.local.json(개인·gitignore).
환경변수는 "env": { "KEY": "값" }, "X 하면 자동 Y"는 /hooks로 처리.
제일 쉬운 길은 그냥 말로 시키는 것 — "npm·sqlite 명령 허용해줘", "이 권한 프로젝트 설정으로 옮겨줘" 하면 settings.json을 알아서 고쳐줌. 테마·모델 같은 단순 설정은 /config, 권한 모드는 Shift+Tab으로 default→acceptEdits→plan 순환

슬래시 명령·서브에이전트·스킬·훅을 묶은 플러그인을 한 번에 설치합니다. Anthropic 공식 마켓플레이스 + 커뮤니티 git repo 지원.
자주 쓰는 워크플로우(리뷰, 배포, 테스트 자동화)는 직접 만들지 말고 마켓플레이스에서 가져오는 게 빠름

.claude/skills/<name>/SKILL.md 형식으로 만들면 /<name>로 호출됩니다. Claude가 상황에 따라 자동으로 호출하기도 함.
예전 custom slash command가 이 형태로 통합됨. 팀 공유 가능 — repo에 .claude/ 디렉토리 커밋만 하면 됨

IDE에서 열린 파일·선택 영역·진단을 세션 컨텍스트로 가져옵니다. 또는 IDE 확장에서 터미널 세션을 직접 띄움.
VS Code/Cursor/JetBrains 확장 설치 후 사용 가능. 매번 파일을 @로 첨부하지 않아도 됨

사용 가능한 모든 슬래시 명령어와 설명을 표시합니다.
프롬프트에서 /만 입력하면 자동완성으로 명령어 탐색 가능

터미널에서 바로 실행합니다. 모델을 지정하거나 기본 모델(gpt-5.4)로 실행 가능.
설정 파일: ~/.codex/config.toml. OpenAI API 키 필요

세션 안에서 모델과 effort를 함께 변경할 수 있습니다.
선택 UI가 표시되어 모델과 effort를 고를 수 있습니다.
사용 가능 모델: gpt-5.4 (기본) · gpt-5.3-codex 등
Claude Code의 /model과 같은 역할

5단계: minimal · low · medium · high · xhigh
기본값: config.toml의 model_reasoning_effort로 설정
세션 중 별도 /effort 명령은 없음. /model에 통합되어 있음

config.toml 또는 세션 내 /permissions로 설정합니다.
approval_policy
untrusted 모든 작업 승인 필요
on-request 기본값 · 대화형 승인
never 전부 자동 실행
sandbox_mode
read-only 읽기만 (기본) · workspace-write 쓰기 허용 · danger-full-access 제한 없음

Claude Code의 CLAUDE.md에 해당하는 파일. 프로젝트 규칙을 정의합니다.
하위 디렉토리에도 배치 가능 (계층적 적용).
두 도구를 함께 쓸 땐 CLAUDE.md와 AGENTS.md 둘 다 만들어두면 됨

세션의 최상위 목표를 한 줄로 박아둡니다. 에이전트가 모든 작업을 이 목표에 비추어 우선순위를 매기고, 곁가지로 빠지면 스스로 복귀합니다.
서브커맨드 (v0.128+)
/goal pause 자동 추진 일시정지 (목표는 유지)
/goal resume 정지·중단된 목표 다시 추진 — 터미널 끊겼다 살아나면 자동 재개
/goal clear 목표 해제 (완료 전 중단할 때)
목표는 persist돼서 터미널 종료·리부팅 후 resume 시 알아서 작업 재개. 모호하면 에이전트도 모호해짐 — 완료 조건을 동사로 명확히. /goal 다시 입력하면 목표 갱신

읽기 전용 상태로 들어가 계획만 수립합니다. 파일 수정·명령 실행 안 함. 사용자 confirmation 받은 뒤 실행 단계로 전환.
3-4개 파일 이상 건드릴 작업엔 무조건 plan 박는게 안전. Claude Code의 /plan과 동등한 결

~/.codex/agents/ 의 md 파일을 서브에이전트로 호출합니다. 메인 컨텍스트가 더러워지지 않게 분리.
파일 예시 (~/.codex/agents/reviewer.md):
---
name: reviewer
description: PR 리뷰 전용
---
너는 시니어 리뷰어. 보안/성능/가독성 순서로...
Claude Code의 .claude/agents/와 같은 결. 자주 쓰는 페르소나는 미리 박아두면 효율

세션 도중 approval_policy를 즉시 변경합니다. config.toml 수정 없이 임시로 풀거나 잠글 수 있음.
untrusted 모든 작업 confirm · on-request 기본값 · never 전부 자동
신뢰되는 반복 작업은 never로 빠르게, 운영 코드 만지면 untrusted로 보수적. 한 세션 안에서 자유롭게 토글

이번 세션에서 수정한 파일들의 diff를 보여줍니다. workspace-write sandbox에서 의도치 않게 건드린 파일 잡기에도 유용.
파일 인자 없이 호출하면 전체 변경 표시. 인자 넣으면 해당 파일만.
커밋 전 최종 점검용. git diff와 달리 staging 여부 무관하게 모든 변경 표시

conversation_id 기반으로 이전 세션을 그대로 복원합니다. 터미널 종료·리부팅 후에도 컨텍스트 유지.
--continue는 prompt 없이 바로 마지막 대화로 진입 — 가장 빠른 복귀 방식.
세션 도중에는 /resume으로 picker를 열 수도 있음.
긴 마이그레이션·디버깅이 중간에 끊겨도 안전. /goal로 박아둔 목표는 resume 시 자동으로 작업 재개됨 (v0.128+)

대화형 TUI 없이 프롬프트 1개 실행하고 종료합니다. cron, CI, git hook 등 자동화에 사용.
stdout으로 결과가 흘러나오므로 다른 명령과 파이프 가능. codex(대화형)와 구분 — exec는 응답 끝나면 즉시 종료

같은 컨텍스트에서 두 가지 다른 접근을 비교할 때 쓰는 분기 명령.
"이대로 갈까 vs 다른 방향 시도해볼까" 갈림길에서 원본 세션을 망치지 않고 실험. resume picker에서도 fork 가능

현재 브랜치 변경분을 자동으로 리뷰합니다. Claude Code의 /code-review ultra에 해당.
베이스 브랜치 지정 가능. 커밋 전 빠른 셀프 리뷰 용도

VS Code · Cursor 등에서 열린 파일·선택 영역·LSP 진단을 세션 컨텍스트로 가져옵니다.
에디터에서 보고 있는 파일을 일일이 @로 첨부할 필요 없음. workspace-aware /diff와 함께 쓰면 효율적

현재 세션의 thread ID, 활성 모델, 권한 설정, 토큰 사용량, 남은 컨텍스트 용량을 보여줍니다.
"지금 컨텍스트를 얼마나 썼나" 확인할 때는 /status. 남은 용량이 낮으면 /compact로 요약해 토큰 공간을 확보

TUI 하단 상태줄에 표시할 항목을 고르고 순서를 바꿉니다. 기본 상태줄에는 context-remaining이 포함됩니다.
매번 /status 치기 귀찮으면 statusline에 context-remaining을 유지. 모델·현재 폴더·git 브랜치·토큰 관련 항목도 함께 배치 가능

대화가 길어졌을 때 이전 내용을 요약해서 토큰 공간을 확보합니다.
주제를 지정하면 그 부분 위주로 요약. Claude Code의 /compact와 같은 결

활성화된 MCP 서버 목록 확인 + 동적 추가·제거.
config.toml 수정 + 재시작 없이 임시로 도구 붙일 때 유용. 영구 등록은 여전히 toml에

사용 가능 모델: Claude · GPT · Gemini · DeepSeek · Ollama(로컬) 등
API 키만 있으면 어떤 모델이든 사용 가능. 로컬 모델도 지원해서 무료로 쓸 수 있음

Aider는 명시적으로 추가한 파일만 편집합니다.
/read-only로 추가하면 참고만 하고 수정은 안 함. 스펙 문서 넣을 때 유용

/model 세션 중 모델 변경
/undo 마지막 AI 커밋 되돌리기
/diff 변경사항 확인
AI가 수정할 때마다 자동으로 git commit됨. /undo로 즉시 복구 가능

에디터에서 코드에 AI! 주석을 달면 Aider가 자동으로 감지하여 처리합니다.
IDE에서 코드 작성하면서 CLI가 백그라운드에서 자동 처리. Claude Code에는 없는 기능

한 모델이 설계하고, 다른 모델이 구현합니다.
예: Opus가 설계 → Sonnet이 구현. 비용 절약하면서 품질 유지

Aider는 AI가 파일을 수정할 때마다 자동으로 git commit합니다.
커밋 메시지도 AI가 자동 작성. /undo로 마지막 커밋 되돌리기 가능

agent 대화형 세션 (구 별칭: cursor-agent도 동작)
agent -p "..." 1회성 헤드리스 실행
& "메시지" 메시지 앞에 & 붙이면 Cloud Agent로 이관
Pro($20/월) 이상 필요. GitHub Actions·CI 스크립트에서도 동작. 다른 CLI들(클코·코덱스·Aider)과 같은 워크플로 가능

선택 영역 안에서 핀포인트 수정. 채팅 패널 안 열어도 됨.
Cursor의 가장 오래된 시그니처 (2023부터 안 바뀜). 짧은 수정엔 Agent보다 빠름

Cursor 3.0(2026/4) 이후 메인 AI 표면. 옛 Chat·Composer 패널이 여기로 통합됨.
Agent 자율 멀티파일 수정
Ask 질문·설명만 (코드 수정 X)
Manual 도구 호출 직접 제어
⚠️ "Composer"는 이제 패널 이름이 아니라 Cursor 자체 모델(Composer 2/2.5) 이름. 패널은 "Agent". 헷갈리는 사람 진짜 많음

한 줄이 아니라 다음 편집 위치까지 예측해서 여러 줄 한번에.
Tab 제안 수락
Esc 제안 거부
모든 유료 플랜(Hobby 빼고) 무제한. "커서 못 떠나는 이유" 1순위로 자주 꼽힘

@파일명 특정 파일
@폴더/ 폴더 (이어서 / 치면 깊이 탐색)
@Docs 인덱싱된 문서 (직접 URL 추가 가능)
@Terminals 터미널 출력
@Past Chats 이전 대화
@Commit · @Branch diff 첨부
옛 @codebase·@web는 사라짐 — 코드베이스 검색은 Cmd+Return, 웹은 Agent가 필요시 알아서 호출

Frontmatter로 4가지 활성화 모드:
alwaysApply: true 항상 로드
globs: [...] 매칭 파일 열릴 때 자동 부착
description만 → Agent가 필요시 판단해서 로드
없음 → @룰이름으로 수동 호출
⚠️ 기존 .cursorrules(루트 단일 파일)는 Agent 모드에서 silently 무시됨 — 실측 0/9 follow vs .mdc는 9/9. Agent 쓰면 무조건 .mdc로 마이그

원격 VM에서 격리 실행 → 결과는 PR로 옴. 자리 비울 때·긴 작업에.
Pro($20/월) 이상. 50 step 작업당 대략 $0.30~0.60. 2025/10 Background Agent → Cloud Agent로 리네임됨

agy 대화형 TUI
agy -p "..." 1회성 프롬프트 (응답 후 종료)
agy inspect 현재 프로젝트 컨텍스트 요약
2026-05 기준 무료 preview. Google 계정 로그인. 유료 AI Ultra는 $100/월·사용량 5배

Gemini CLI의 GEMINI.md·설정·커스텀 명령을 Antigravity로 자동 이관.
Agent Skills·Hooks·Subagents·Extensions (Antigravity에선 plugins) 그대로 전환
2026/6/18부로 Google AI 무료·Pro·Ultra 사용자는 Gemini CLI 서빙 중단 → Antigravity 전환 필수. Enterprise Code Assist는 유지

/goal 작업 완주까지 일시정지 없이 자율 실행
/fast 계획 단계 건너뛰고 바로 실행
/goal은 범위 큰 작업·자리 비울 때 / /fast는 명백한 단발 수정에. 둘 다 사람 확인이 줄어드니 신중하게

/grill-me 시작 전에 에이전트가 먼저 명세 캐묻게 함 (애매한 요구사항 정밀화)
/btw 메인 작업 흐름 안 끊고 사이드 질문 (컨텍스트 유지)
/grill-me는 큰 신규 작업 시작 시 추천. 헛삽질 줄임

/artifact 에이전트가 만든 계획·파일·코드 변경 목록 검토
/context 토큰 사용 분석 + 체크포인트 관리
긴 세션에선 /context로 어디서 토큰 새는지 보고 /clear나 /rewind로 정리

/agent <이름> "..." 비동기 서브에이전트 디스패치
/mcp MCP 서버 연결 관리
/skills 로컬·전역 스킬 워크플로 브라우즈
서브에이전트는 Claude Code의 /agents와 비슷한 컨셉. 병렬 작업 가능

.agents/skills/<이름>.md 형식으로 마크다운 파일 두면 파일명이 슬래시 명령으로 자동 등록
팀에서 자주 쓰는 워크플로를 슬래시로 박아둠. Claude Code의 ~/.claude/agents/와 유사 컨셉