Claude Code 팁 – 숨은 CLI 명령으로 세션·백그라운드·권한 관리하기

세션을 잃지 않기
백그라운드 에이전트
스크립트용 print mode
비용과 권한 제한
MCP와 진단
관련 문서
참고 자료

Claude Code는 단순 대화형 코딩 CLI가 아니라 세션 재개, 백그라운드 에이전트, 스크립트 출력, 권한 모드, MCP 인증, 진단 명령을 갖춘 작업 런타임에 가깝다. claude --help의 옵션을 익히면 매번 프로젝트를 다시 설명하거나 터미널을 붙잡고 기다리는 시간을 줄일 수 있다.

세션을 잃지 않기

명령	용도
`claude -c`	현재 폴더의 최근 세션 이어받기
`claude -n "auth-refactor"`	새 세션에 이름 붙이기
`claude -r "auth-refactor"`	이름 또는 ID로 세션 재개
`claude --fork-session`	기존 세션을 보존하고 분기 세션 시작
`claude --from-pr 123`	특정 PR과 연결된 세션 필터링

긴 리팩터링이나 며칠에 걸친 버그 추적은 세션 이름을 붙이는 것만으로 재설명 비용이 크게 줄어든다. 위험한 실험을 할 때는 fork 세션으로 원래 대화를 남겨두는 편이 좋다.

백그라운드 에이전트

--bg는 작업을 백그라운드 세션으로 보내고 터미널을 즉시 돌려준다.

claude --bg "investigate why payments.test.js is flaky"
claude agents
claude attach <id>
claude logs <id>
claude stop <id>
claude respawn --all

테스트 실패 조사, TODO 감사, 보안 점검처럼 오래 걸리지만 사용자가 계속 지켜볼 필요가 없는 작업에 맞다. 자동화에서는 claude --bg --exec 'pytest -x tests/'처럼 셸 명령을 백그라운드 작업으로 넘길 수도 있다.

스크립트용 print mode

claude -p는 질문을 실행하고 답만 출력한 뒤 종료한다. CI, shell pipeline, 로그 요약에 쓰기 좋다.

claude -p "what does auth.js actually do"
cat error.log | claude -p "summarise these errors by root cause"
cat changes.diff | claude -p "review this diff for security issues"
claude -p "list all API routes" --output-format json

자주 호출하는 스크립트에서는 --bare로 hooks, skills, plugins, MCP 자동 발견을 건너뛰어 시작 시간을 줄일 수 있다.

비용과 권한 제한

옵션	용도
`--effort low\|medium\|high\|ultracode`	작업 난이도에 맞춰 추론 깊이 조절
`--max-budget-usd 2.00`	자동화 작업의 지출 상한 설정
`--max-turns 5`	에이전트 루프 횟수 제한
`--permission-mode plan`	파일 변경 없이 계획만 세우기
`--permission-mode acceptEdits`	편집 제안을 자동 수락
`--tools "Bash,Edit,Read"`	사용 가능한 도구 제한
`--allowedTools "Bash(git log *)"`	특정 호출 자동 허용
`--disallowedTools "Bash(rm *)"`	위험 명령 차단

자동화에서는 비용 제한과 turn 제한을 함께 두는 것이 좋다. 권한 모드는 편의 기능이 아니라 실패 반경을 정하는 운영 정책으로 봐야 한다.

MCP와 진단

Claude Code는 터미널에서 MCP 서버 상태와 인증을 다룰 수 있다.

claude mcp list
claude mcp login sentry
claude mcp login sentry --no-browser
claude mcp add-from-claude-desktop
claude doctor
claude --safe-mode
claude daemon status
claude update

SSH 환경에서는 --no-browser가 유용하다. 문제가 생기면 claude doctor로 인증·설정 파일·설치 상태를 먼저 확인하고, 커스터마이징이 의심되면 --safe-mode로 hooks와 skills를 배제해 재현한다.

참고 자료

Claude Code CLI Commands I Wish I Had Known Sooner — Analytics Vidhya (2026-07-30)

Like?

AI Sparkup