Claude Code Deep Dive - 5(CLI Reference)

claude [플래그] [프롬프트]

# 대화형 세션
claude
 
# 초기 요청과 함께 대화형 세션 시작
claude "explain this project"
 
# 실행 후 종료하는 Headless 모드
claude -p "query"
 
# 파이프 입력
cat logs.txt | claude -p "explain"
 
# 현재 디렉터리의 최근 대화 재개
claude -c
 
# 이름이나 ID로 특정 대화 재개
claude -r "auth-refactor" "Finish this PR"

claude --model opus
claude --effort high
claude --fallback-model sonnet,haiku
claude --advisor opus

CLI 플래그 > 환경변수 > 파일 설정

# Plan 모드
claude --permission-mode plan
 
# 특정 도구와 명령만 허용
claude -p \
  --allowed-tools "Read" "Bash(git log *)" \
  "최근 변경 사항을 분석해줘"
 
# Edit 도구 제거
claude --disallowedTools "Edit"
 
# rm 계열 호출 거부
claude --disallowedTools "Bash(rm *)"
 
# 모든 MCP 도구 제거
claude --disallowedTools "mcp__*"
 
# 사용할 내장 도구 제한
claude --tools "Bash,Edit,Read"

claude --settings ./ci-settings.json
claude --settings '{"model":"haiku"}'
claude --setting-sources user,project
claude --mcp-config ./mcp.json --strict-mcp-config

claude --bare -p --model haiku "이 파일의 복잡도를 분석해줘"
claude --safe-mode -p "문제가 발생하는 작업"

# 직접 인자
claude -p "직접 인자"
 
# 파이프
cat error.log | claude -p "원인 분석"
 
# 명령 치환
claude -p "$(cat prompt.txt)"
 
# 리다이렉트
claude -p "요약해줘" < notes.md
 
# Here Document
claude -p <<'EOF'
여러 줄 지시문
EOF
 
# 기존 세션 이어받기
claude -c -p "이어서 리팩터링해줘"

claude -p "테스트 실패 원인을 찾아 수정해줘" \
  --max-turns 15
 
case $? in
  0) echo "OK" ;;
  *) echo "FAIL"; exit 1 ;;
esac

claude -p "고위험 파일 3개를 찾아줘" \
  --output-format json

OUT=$(claude -p "작업 요청" --output-format json)
 
echo "$OUT" | jq -r '.result'
echo "$OUT" | jq -r '.total_cost_usd'
echo "$OUT" | jq -r '.session_id'

claude -p "이 diff의 위험도를 평가해줘" \
  --json-schema '{
    "type": "object",
    "properties": {
      "risk": {
        "enum": ["low", "medium", "high"]
      },
      "reasons": {
        "type": "array",
        "items": {"type": "string"}
      },
      "block": {
        "type": "boolean"
      }
    },
    "required": ["risk", "block"]
  }'

RISK=$(
  claude -p "git diff의 위험도를 평가해줘" \
    --json-schema "$SCHEMA" |
  jq -r '.risk'
)
 
[ "$RISK" = "high" ] && exit 1

claude -p "의존성 취약점을 분석하고 패치 PR 초안을 작성해줘" \
  --max-turns 20 \
  --max-budget-usd 3.00

run_claude() {
  local attempt=1
 
  while [ "$attempt" -le 3 ]; do
    OUT=$(claude -p "$1" \
      --output-format json \
      --max-turns 15 \
      2>err.log) && {
        echo "$OUT"
        return 0
      }
 
    grep -qiE 'rate|overloaded|529' err.log || break
 
    sleep $((attempt * 20))
    attempt=$((attempt + 1))
  done
 
  return 1
}

~/.claude/projects/

claude -c
claude -r "payments-refactor"
claude -c -p "이어서 리팩터링해줘"

claude --from-pr 123
claude --from-pr https://github.com/org/repo/pull/123

claude \
  --resume auth-refactor \
  --fork-session

SID=$(uuidgen)
 
claude -p \
  --session-id "$SID" \
  "1단계: 프로젝트 스캔"
 
claude -p \
  --resume "$SID" \
  "2단계: 스캔 결과를 바탕으로 수정"

claude -n "payments-refactor"

claude --remote "로그인 버그를 수정해줘"
claude --teleport

/loop 테스트가 전부 통과할 때까지 실패를 고쳐

/goal 전체 테스트 통과 + 린트 0 경고 상태 도달

claude-cli://open?path=~/work/payments&prompt=결제 지연 알람 원인을 조사해

claude --bg "flaky 테스트 원인 조사"
claude logs <session-id>
claude attach <session-id>
claude --bg --exec 'pytest -x'

SHELL=/bin/bash
PATH=/usr/local/bin:/usr/bin:/bin:/home/dev/.local/bin
 
0 7 * * 1-5 cd /home/dev/payments && \
  ./scripts/nightly-deps-audit.sh >> ~/logs/deps.log 2>&1

jobs:
  deps-audit:
    runs-on: ubuntu-latest
    permissions:
      id-token: write
      contents: read
 
    steps:
      - uses: actions/checkout@v4
      - uses: aws-actions/configure-aws-credentials@v4
        with:
          role-to-assume: CLAUDE_ROLE
          aws-region: ap-northeast-2
      - run: curl -fsSL https://claude.ai/install.sh | bash
      - run: |
          CLAUDE_CODE_USE_BEDROCK=1 \
          ./scripts/nightly-deps-audit.sh

git diff "origin/$BASE...HEAD" > pr.diff
 
claude -p "pr.diff를 리뷰하고 차단 여부를 판단해줘" \
  --allowed-tools "Read" "Grep" "Bash(git diff *)" \
  --max-turns 12 \
  --max-budget-usd 1.50 \
  --json-schema "$(cat .ci/review-schema.json)" \
  > review.json
 
jq -e '.block == false' review.json

claude-review:
  stage: test
  image: ubuntu:24.04
 
  rules:
    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
 
  before_script:
    - apt-get update && apt-get install -y curl git jq
    - curl -fsSL https://claude.ai/install.sh | bash
    - export PATH="$HOME/.local/bin:$PATH"
 
  script:
    - ./scripts/mr-review.sh
 
  artifacts:
    paths:
      - review.json
    when: always

grep -E 'ERROR|FATAL' app.log |
  sed -E 's/[0-9a-f-]{36}/<id>/g' |
  sort |
  uniq -c |
  sort -rn |
  head -20 > sigs.txt

SINCE=$(date -d yesterday +%F)
 
{
  git log --since="$SINCE" --oneline
  gh pr list --state all \
    --search "updated:>=$SINCE" \
    --json number,title,state
  gh issue list \
    --search "created:>=$SINCE" \
    --json number,title
} > digest.txt
 
claude -p \
  "digest.txt로 팀 브리핑을 작성해줘" \
  --max-turns 8 \
  --max-budget-usd 0.50 \
  > report.md

변환 -> 관련 테스트 -> 성공 시 커밋 -> 실패 시 원복과 기록

export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=ap-northeast-2

export HTTPS_PROXY=http://proxy.corp.example:8080
export NO_PROXY=localhost,127.0.0.1,.corp.example
export NODE_EXTRA_CA_CERTS=/etc/ssl/certs/corp-root-ca.pem

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector:4317
export OTEL_RESOURCE_ATTRIBUTES=department=platform

env |
  grep -iE 'claude|anthropic|otel|aws_region' |
  sort

claude --debug "api,hooks" -p "작업 요청"
claude --debug "!statsig,!file" -p "작업 요청"
claude --debug-file /tmp/claude-debug.log -p "작업 요청"

claude doctor
claude auth status --text
 
claude auth status || {
  echo "auth missing"
  exit 1
}