Claude Code CLI 문서 — 명령어, 플래그, 헤드리스 모드 (2026)

실행

claude                          # interactive session
claude "fix the failing test"   # start with a prompt
claude -p "summarise this repo"  # print mode: answer, then exit
claude -c                       # continue the most recent session
claude -r                       # pick a session to resume
claude --model claude-opus-5    # choose the model for this session

알아 두면 유용한 플래그

-p, --print — 비대화형 모드입니다. 파이프로 입력을 전달하고 출력을 받습니다. 모든 스크립트 및 CI 사용의 기반입니다.
--output-format text|json|stream-json — 출력 모드용 구조화된 출력입니다.
--model <id> — 엔드포인트에서 제공하는 모든 모델을 사용할 수 있습니다(/v1/models 에서 이 게이트웨이의 모델 목록을 확인할 수 있습니다).
--allowedTools "Read,Edit,Bash(git *)" — 도구를 사전 승인하여 출력 모드가 승인 요청 때문에 멈추지 않도록 합니다.
--dangerously-skip-permissions — 승인 요청을 전혀 표시하지 않습니다. 폐기 가능한 컨테이너나 샌드박스 안에서만 사용하세요.
--max-turns N — 헤드리스 실행 시 에이전트 루프 횟수를 제한합니다.
--add-dir <path> — 세션이 여러 디렉터리에 걸쳐 작업할 수 있게 합니다.

세션 내 슬래시 명령어

/init — 프로젝트용 CLAUDE.md를 작성합니다(규칙, 빌드 명령어, 피해야 할 사항).
/compact [focus] — 대화를 요약하여 컨텍스트 공간을 확보합니다. 가장 효과적인 단일 비용 관리 수단입니다.
/clear — 빈 컨텍스트로 새로 시작합니다.
/model — 세션 도중 모델을 전환합니다. /cost — 현재까지의 토큰 사용량과 지출을 표시합니다. /status — 엔드포인트, 키, 모델, 버전을 표시합니다.
/permissions — 에이전트가 승인 없이 수행할 수 있는 작업을 설정합니다. /config — 설정입니다. /memory — 메모리 파일을 편집합니다.
/mcp — 연결된 MCP 서버를 표시합니다. /agents — 하위 에이전트를 정의하고 관리합니다. /hooks — 도구 이벤트에 대한 셸 훅입니다.
/review — 풀 리퀘스트를 검토합니다. /doctor — 설치 상태를 진단합니다. /help — 그 밖의 모든 기능입니다.

claude setup-token: 구독 기반 CI용 장기 인증

claude setup-token 브라우저에서 한 번 로그인한 뒤 Claude Pro/Max 구독용 장기 OAuth 토큰을 출력합니다. /login을 사용할 수 없는 헤드리스 환경을 위한 기능입니다. CI에서 이 토큰을 CLAUDE_CODE_OAUTH_TOKEN로 내보내면 출력 모드 실행에 구독의 사용 한도가 적용됩니다. 구독 전용 기능이므로 API 키(Anthropic 또는 게이트웨이)를 사용하는 경우에는 이 단계가 필요하지 않습니다. 대신 ANTHROPIC_API_KEY을 설정하세요.

스크립트와 CI용 출력 모드

cat error.log | claude -p "explain the root cause in three lines"

claude -p "write a changelog entry for the staged diff" \
  --allowedTools "Read,Bash(git diff *)" \
  --output-format json

GitHub Action, 편집기 통합, Agent SDK는 출력 모드를 통해 Claude Code를 사용합니다. ANTHROPIC_BASE_URL를 게이트웨이로 설정하면 이러한 실행 비용은 Anthropic 계정 대신 게이트웨이 잔액이나 무제한 요금제에 청구됩니다.

설정 저장 위치

CLAUDE.md 저장소 루트에 있는 파일(그리고 CLAUDE.local.md 에 있는 개인 메모) — 매 세션마다 읽는 프로젝트 메모리입니다.
.claude/settings.json — 프로젝트별 권한, 훅, 환경 변수입니다. ~/.claude/settings.json — 전역 설정입니다.
~/.claude/skills/ 및 .claude/skills/ — 스킬입니다. .claude/agents/ — 하위 에이전트 정의입니다.
환경 변수: ANTHROPIC_BASE_URL, ANTHROPIC_API_KEY / ANTHROPIC_AUTH_TOKEN, 그리고 모델 가이드에서 다루는 등급별 모델 재정의 설정입니다.

먼저 무료로 사용해 보세요

신규 계정에는 $5의 무료 API 크레딧이 제공됩니다 사용할 코드: CLAUDECODE — Sonnet으로 저녁 한나절 Claude Code를 사용하기에 충분합니다. 이후에는 액면가의 7.69231배에 해당하는 크레딧이 제공됩니다.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

코드 CLAUDECODE로 계정 만들기

자주 묻는 질문

대화형 프롬프트 없이 Claude Code를 실행하려면 어떻게 해야 하나요?

출력 모드를 사용하세요: claude -p "프롬프트 내용". 스크립트에서는 --allowedTools 및 --output-format json과 함께 사용하고, stdin으로 파일을 파이프 입력하세요.

/compact는 어떤 기능인가요?

모델에 지금까지의 대화를 요약하도록 요청하고 기록을 그 요약으로 대체합니다. 컨텍스트가 줄어들고 턴당 비용이 낮아지며 세션을 계속 진행할 수 있습니다. 작업 방향이 바뀔 때마다 실행하세요.

Claude Code에서 다른 API 기본 URL을 사용할 수 있나요?

네. ANTHROPIC_BASE_URL를 설정하세요. /status로 세션에서 사용하는 엔드포인트를 확인할 수 있습니다.

게이트웨이에서 Claude Code 실행하기

동일한 모델, 환경 변수 두 개, 액면가의 7.69231배에 해당하는 크레딧 또는 정액 무제한 요금제를 이용하세요. 신규 계정: 코드 CLAUDECODE로 $5의 무료 API 크레딧을 받으세요.

API 키 발급받기 무제한 요금제 보기

AI Prime Tech는 독립 API 게이트웨이이며 Anthropic과 제휴 관계가 없고, Anthropic의 보증이나 후원을 받지 않습니다. “Claude”와 “Claude Code”는 Anthropic의 상표입니다. 여기에 설명된 Claude Code 기능은 작성 당시 Anthropic의 공개 문서를 기준으로 하며 자주 변경됩니다. 이 페이지의 가격과 모델 목록은 이 게이트웨이의 실시간 설정에서 가져옵니다.

Claude Code CLI 문서: 명령어와 플래그

TLDR

실행