AI 코딩 CLI 명령어 가이드

Claude Code · Codex · Cursor · Gemini · Aider 등 AI 코딩 CLI의 핵심 명령어와 실전 사용법. 바이브 커뮤니티가 정리합니다.

Claude Code Anthropic의 AI 코딩 에이전트

/model

AI 모델 전환

세션 중 언제든 모델을 바꿀 수 있습니다.
입력 예시/model opus
/model sonnet
/model opus[1m]
opus Opus 4.7 (200K) · 최신 최강
opus[1m] Opus 4.7 (1M) · 대규모 코드베이스 전체 분석
sonnet Sonnet 4.6 · 기본값, 빠르고 효율적
sonnet[1m] Sonnet 4.6 (1M) · 컨텍스트 확장
haiku Haiku 4.5 · 가장 빠름, 간단한 수정
팁: 평소 sonnet → 막히면 opus 전환 → 해결 후 sonnet 복귀. [1m] 별칭은 Max/Team 플랜 필요

/effort

응답 깊이 조절 (세션 전체 적용)

한 번 설정하면 이후 모든 응답에 반영됩니다.
입력 예시/effort high
/effort max
low 빠른 응답 · 오타 수정, 간단한 질문
medium 기본 · 일반적인 코딩 작업
high 깊은 분석 · 복잡한 구현
xhigh 더 깊은 추론 · Opus 4.7 전용
max 최대 깊이 · Opus 4.7 전용
auto 작업에 따라 자동 조절 (기본값)
팁: ultrathink는 한 메시지에만 적용되지만, /effort는 세션 전체에 적용됨

ultrathink

한 번만 최대 깊이로 사고

메시지에 ultrathink를 포함하면 해당 응답만 최대 thinking 예산으로 처리합니다.
입력 예시이 버그 ultrathink 해서 원인 찾아줘
/effort와 달리 해당 메시지 한 번에만 적용. 세션 설정은 바뀌지 않음

/compact

컨텍스트 압축

대화가 길어졌을 때 이전 대화를 요약하여 공간을 확보합니다.
입력 예시/compact
/compact 인증 관련 작업만 유지해줘
주제를 지정하면 해당 내용 위주로 요약. 긴 작업 중간에 주기적으로 쓰면 효율적

/rewind

변경 되돌리기

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

/plan

플랜 모드 진입

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

/goal

완료 조건 설정 후 멀티턴 자동 추진 (clear)

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

/diff

변경사항 확인

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

/ultrareview

다중 에이전트 심층 리뷰

여러 에이전트를 병렬로 돌려 현재 브랜치의 변경 전체를 깊이 리뷰합니다.
입력 예시/ultrareview
/security-review가 보안 집중이라면, /ultrareview는 아키텍처·품질·엣지케이스까지 종합

/ultraplan

클라우드에서 플랜 작성 후 실행

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

/clear

대화 초기화

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

/init

CLAUDE.md 생성

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

/team-onboarding

팀원용 온보딩 가이드 자동 생성

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

/cost

세션 비용 확인

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

! 명령어

쉘 명령 실행 (대화 중)

대화 중에 터미널 명령이 필요할 때 세션을 벗어나지 않고 실행합니다. 결과가 대화 컨텍스트에 포함됩니다.
입력 예시! git status
! npm test
! ls -la src/

/fast

빠른 응답 모드 토글

같은 모델의 빠른 출력 버전을 켜고 끕니다. 모델이 바뀌는 게 아니라 속도만 올라감.
입력 예시/fast
Opus 4.6 전용 (4.7은 미지원). 응답 속도 약 2.5배, 토큰당 비용은 더 높음

/voice

음성 입력 토글

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

/context

컨텍스트 사용량 확인

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

/status

세션 상태 확인

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

/remote-control

claude.ai/code 원격 제어 (/rc)

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

/powerup

인터랙티브 레슨

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

claude --continue · --resume

직전 세션 이어가기 / 세션 picker

터미널 종료 후에도 이전 대화를 그대로 이어갈 수 있습니다.
터미널에서 입력claude --continue # 또는 -c, 가장 최근 세션 즉시 복귀
claude --resume # picker UI에서 세션 선택
claude --resume <session-id>
--continue는 prompt 없이 바로 복귀, --resume은 골라서 복귀.
긴 작업 중간에 터미널을 닫거나 재부팅해도 안전. Codex의 codex --continue와 동일한 결

claude agents · --bg

여러 백그라운드 세션 한 화면 관리 (Agent View)

백그라운드에서 도는 모든 세션을 상태별 대시보드 하나로 봅니다. 터미널 탭 여러 개 띄울 필요 없음.
터미널에서 입력claude agents # 대시보드 열기
claude --bg "결제 테스트 깨진거 고쳐줘" # 바로 백그라운드 세션 생성
/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)

/hooks

이벤트 훅 설정 (자동 실행)

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

/permissions · settings.json

도구 권한 + 설정 파일 관리

매번 뜨는 도구 승인 프롬프트를 규칙으로 박아 없애거나, 위험한 동작을 아예 차단합니다.
세션 안에서 입력/permissions
현재 허용/차단 규칙과 각 규칙이 어느 설정 파일에서 왔는지까지 보여줍니다.
settings.json 예시"permissions": {
  "allow": ["Bash(npm run test:*)", "Bash(sqlite3:*)"],
  "ask": ["Bash(git push:*)"],
  "deny": ["Read(.env)", "Bash(rm -rf *)"]
}
규칙 우선순위 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 순환

/plugin

플러그인 설치/관리 (마켓플레이스)

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

Skills (.claude/skills/)

프로젝트 전용 슬래시 명령 자작

.claude/skills/<name>/SKILL.md 형식으로 만들면 /<name>로 호출됩니다. Claude가 상황에 따라 자동으로 호출하기도 함.
파일 예시.claude/skills/deploy/SKILL.md
---
name: deploy
description: 프로덕션 배포 절차
---
배포 단계 1. ... 2. ...
예전 custom slash command가 이 형태로 통합됨. 팀 공유 가능 — repo에 .claude/ 디렉토리 커밋만 하면 됨

/ide

VS Code · JetBrains 연동

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

/help

명령어 목록 보기

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

Codex CLI OpenAI의 오픈소스 CLI 코딩 에이전트

codex

기본 실행

터미널에서 바로 실행합니다. 모델을 지정하거나 기본 모델(gpt-5.4)로 실행 가능.
터미널에서 입력codex "이 함수 리팩토링해줘"
codex --model gpt-5.4 "버그 고쳐줘"
설정 파일: ~/.codex/config.toml. OpenAI API 키 필요

/model

모델 변경 (세션 중)

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

--effort

추론 깊이 설정 (5단계)

5단계: minimal · low · medium · high · xhigh
터미널에서 입력 (실행 시)codex --effort xhigh "아키텍처 분석해줘"
세션 중 변경/model 입력 → effort 함께 선택
기본값: config.toml의 model_reasoning_effort로 설정
세션 중 별도 /effort 명령은 없음. /model에 통합되어 있음

권한 설정

approval_policy + sandbox_mode

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

AGENTS.md

프로젝트 설정 파일

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

/goal

세션 최상위 목표 설정 (pause·resume·clear)

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

/plan

Plan mode 진입

읽기 전용 상태로 들어가 계획만 수립합니다. 파일 수정·명령 실행 안 함. 사용자 confirmation 받은 뒤 실행 단계로 전환.
세션 안에서 입력/plan 인증 리팩토링 단계 짜줘
/plan 이 모듈을 3개로 분리하는 방법 검토
3-4개 파일 이상 건드릴 작업엔 무조건 plan 박는게 안전. Claude Code의 /plan과 동등한 결

/agents

서브에이전트 호출

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

/approvals

승인 정책 즉시 변경

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

/diff

세션 변경사항 확인

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

codex resume · --continue

세션 부활 / 직전 대화 이어가기

conversation_id 기반으로 이전 세션을 그대로 복원합니다. 터미널 종료·리부팅 후에도 컨텍스트 유지.
터미널에서 입력codex --continue # 또는 -c, 가장 최근 대화 즉시 이어감
codex resume # 최근 세션 picker UI
codex resume --last # 현재 디렉토리의 마지막 세션
codex resume --all # 모든 디렉토리 포함 picker
codex resume <session-id>
--continue는 prompt 없이 바로 마지막 대화로 진입 — 가장 빠른 복귀 방식.
세션 도중에는 /resume으로 picker를 열 수도 있음.
긴 마이그레이션·디버깅이 중간에 끊겨도 안전. /goal로 박아둔 목표는 resume 시 자동으로 작업 재개됨 (v0.128+)

codex exec

비대화형 1회 실행 (스크립트·CI용)

대화형 TUI 없이 프롬프트 1개 실행하고 종료합니다. cron, CI, git hook 등 자동화에 사용.
터미널에서 입력codex exec "lint 에러 전부 고쳐줘"
codex exec --model gpt-5.4 "테스트 추가"
echo "PR 설명 써줘" | codex exec
stdout으로 결과가 흘러나오므로 다른 명령과 파이프 가능. codex(대화형)와 구분 — exec는 응답 끝나면 즉시 종료

codex fork

기존 세션을 분기해 새 가지 시작

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

/review

내장 PR 리뷰

현재 브랜치 변경분을 자동으로 리뷰합니다. Claude Code의 /ultrareview에 해당.
세션 안에서 입력/review
/review main..HEAD
베이스 브랜치 지정 가능. 커밋 전 빠른 셀프 리뷰 용도

/ide

IDE 컨텍스트 주입

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

/compact

컨텍스트 압축

대화가 길어졌을 때 이전 내용을 요약해서 토큰 공간을 확보합니다.
세션 안에서 입력/compact
/compact 인증 관련 작업만 유지해줘
주제를 지정하면 그 부분 위주로 요약. Claude Code의 /compact와 같은 결

/mcp

MCP 서버 관리

활성화된 MCP 서버 목록 확인 + 동적 추가·제거.
세션 안에서 입력/mcp list
/mcp add slack /path/to/slack-mcp/index.js
/mcp remove slack
config.toml 수정 + 재시작 없이 임시로 도구 붙일 때 유용. 영구 등록은 여전히 toml에

Aider 오픈소스 멀티모델 CLI 에이전트 — aider.chat

설치 + 실행

Python 기반, 모든 LLM 사용 가능

설치 (Mac/Linux)curl -LsSf https://aider.chat/install.sh | sh
실행aider
aider --model sonnet "이 버그 고쳐줘"
aider --model gpt-5.4 file1.py file2.py
사용 가능 모델: Claude · GPT · Gemini · DeepSeek · Ollama(로컬) 등
API 키만 있으면 어떤 모델이든 사용 가능. 로컬 모델도 지원해서 무료로 쓸 수 있음

/add · /drop

편집할 파일 추가/제거

Aider는 명시적으로 추가한 파일만 편집합니다.
세션 안에서 입력/add src/auth.py src/db.py
/drop src/db.py
/read-only docs/spec.md
/read-only로 추가하면 참고만 하고 수정은 안 함. 스펙 문서 넣을 때 유용

/model · /undo · /diff

모델 전환, 되돌리기, 변경 확인

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

--watch-files

IDE 연동 모드 (Aider만의 기능)

에디터에서 코드에 AI! 주석을 달면 Aider가 자동으로 감지하여 처리합니다.
터미널에서 실행aider --watch-files
에디터에서 코드에 주석 작성# AI! 이 함수에 에러 핸들링 추가해줘
IDE에서 코드 작성하면서 CLI가 백그라운드에서 자동 처리. Claude Code에는 없는 기능

--architect

설계자 모드 (2개 모델 협업)

한 모델이 설계하고, 다른 모델이 구현합니다.
터미널에서 입력aider --architect
예: Opus가 설계 → Sonnet이 구현. 비용 절약하면서 품질 유지

Git 자동 커밋

모든 AI 수정을 자동으로 커밋

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

Gemini CLI Google의 CLI 코딩 에이전트 — 무료 사용 가능

설치 + 실행

Node.js 기반, Google 계정으로 무료

설치npm install -g @google/gemini-cli
실행gemini
gemini "이 프로젝트 설명해줘"
gemini -p "README 요약해줘"
gemini 대화형 세션
-p 1회성 실행 (응답 후 종료)
Google 계정 로그인만 하면 하루 1,000회 무료. API 키 없이도 사용 가능

/model · -m

모델 선택

실행 시 모델 지정gemini -m flash
gemini -m pro
세션 중 변경/model set flash
pro Gemini 2.5 Pro · 복잡한 추론
flash Gemini 2.5 Flash · 빠르고 균형적
flash-lite 가장 빠름 · 간단한 작업
Plan 모드에서는 Pro가 설계, Flash가 구현하는 자동 라우팅

GEMINI.md

프로젝트 설정 파일

Claude Code의 CLAUDE.md, Codex의 AGENTS.md에 해당합니다.
세션 안에서 생성/init
메모리 확인/추가/memory show
/memory add "테스트는 pytest로 실행"
settings.json에서 CLAUDE.md나 AGENTS.md도 읽도록 설정 가능

! · @ · /plan

쉘 실행, 파일 참조, 계획 모드

세션 안에서 입력! git status
@ src/main.py 이 파일 분석해줘
/plan
! 쉘 명령 실행 (Claude Code와 동일)
@파일 파일 내용을 프롬프트에 주입
/plan 읽기 전용 계획 모드 진입
@ 명령은 Claude Code에 없는 기능. 파일을 빠르게 컨텍스트에 넣을 때 유용

--sandbox · --yolo

보안 실행 / 전체 자동 승인

터미널에서 입력gemini --sandbox "테스트 전부 돌려줘"
gemini -y "알아서 고쳐줘"
--sandbox Docker 컨테이너 안에서 실행 (안전)
-y 모든 작업 자동 승인
둘을 함께 쓰면: 샌드박스 안에서 전부 자동 실행. 실험할 때 좋음