Claude Code 고급 기능: 서브에이전트, 자동 승인 & Bash 모드

Claude Code의 고급 기능을 완전히 활용하세요: 병렬 처리용 서브에이전트, 자동 승인 모드, Bash 실행, 슬래시 명령어, 훅. AnyCap으로 코드 너머의 기능까지 확장하는 방법 소개.

by AnyCap

AI 에이전트 로봇들이 중앙 허브 주변에서 병렬로 다양한 작업을 처리하는 모습

Claude Code는 단순한 터미널 챗봇이 아닙니다. 내부적으로는 코딩 보조 도구를 자율적인 개발 에이전트로 탈바꿈시키는 고급 기능들을 갖추고 있습니다. 서브에이전트, 자동 승인 모드, Bash 실행, 프로젝트 수준 설정을 통해 Claude Code는 복잡한 다단계 작업을 계획하고, 실행하고, 검토할 수 있는 도구가 됩니다 — 매 명령마다 직접 감독할 필요 없이.

이 가이드는 숙련된 Claude Code 사용자들이 매일 활용하는 기능들을 다룹니다 — 그리고 AnyCap이 이를 어떻게 더욱 확장하는지도 소개합니다. Claude Code가 처음이신가요? 먼저 설치 가이드와 Claude Code vs Cursor 비교를 확인하세요.

서브에이전트: 병렬 AI 워커

서브에이전트는 Claude Code가 하위 작업을 병렬로 처리하기 위해 생성하는 독립적인 Claude 인스턴스입니다. 한 명의 Claude가 여러 파일 리팩터링을 순차적으로 처리하는 대신, 서브에이전트들이 작업을 나눠서 동시에 처리합니다.

"모든 파일에 걸쳐 인증 모듈을 리팩터링해"라고 요청하면, Claude Code는 서브에이전트를 생성합니다 — 파일 또는 논리 단위당 하나씩 — 동시에 작업합니다:

Main Claude session
├── Subagent 1: Refactor auth.service.ts
├── Subagent 2: Refactor auth.middleware.ts
├── Subagent 3: Refactor auth.types.ts
└── Subagent 4: Update auth tests

각 서브에이전트는 자체 컨텍스트 창을 가지고 할당된 파일을 처리한 뒤, 결과를 메인 세션으로 반환합니다.

설정

{
  "subagents": {
    "maxConcurrent": 4,
    "maxTokensPerSubagent": 100000,
    "autoSpawn": true
  }
}

서브에이전트 + AnyCap

서브에이전트는 코드를 담당하고, AnyCap은 나머지를 담당합니다. 두 가지를 함께 사용하세요:

npx -y skills add anycap-ai/anycap -a claude-code

메인 Claude 세션이 여러 서브에이전트의 코드 리팩터링을 조율하는 동시에, AnyCap을 호출해 이미지 생성, 웹 리서치, 에셋 저장을 병렬로 처리합니다. MCP 설정 상세 내용은 MCP 기능 가이드를 참조하세요.

자동 승인 모드: 신속한 신뢰와 검증

기본적으로 Claude Code는 파일 편집, 셸 명령 실행, 네트워크 요청 전에 확인을 요청합니다. 자동 승인을 사용하면 확인 중단 없이 변경 사항이 적용됩니다:

claude config set permissions.auto-accept-edits true

세밀한 권한 설정

{
  "permissions": {
    "allow": ["read", "write"],
    "autoAccept": ["write"],
    "deny": ["shell:rm -rf *", "shell:git push --force"]
  }
}

테스트 커버리지가 충분한 기능 브랜치에서 자동 승인을 사용하세요. 프로덕션 인프라에서는 사용하지 마세요. 자동 승인이 켜져 있더라도 /undo로 마지막 체크포인트로 되돌릴 수 있습니다.

Bash 모드: 완전한 셸 접근

Claude Code는 임의의 셸 명령을 실행할 수 있습니다 — 샌드박스 서브셋이 아닌 완전한 터미널 접근:

npm install && npm run build
git diff HEAD~5 --stat
docker-compose up -d
python -m pytest tests/ --verbose

안전한 셸 설정

{
  "permissions": {
    "deny": [
      "shell:rm -rf *",
      "shell:git push --force origin main",
      "shell:drop table"
    ]
  }
}

Bash 모드 + AnyCap

AnyCap은 관리형 인프라로 Claude Code의 셸 기능을 확장합니다. 이미지 API를 위한 수동 curl이나 클라우드 업로드 관리 대신, AnyCap이 API 키, 인증, 인프라를 모두 처리합니다:

anycap image generate --prompt "..." -o hero.png
anycap drive upload hero.png

슬래시 명령어: 내장 단축키

명령어 기능
/init 프로젝트 분석으로 CLAUDE.md 생성
/clear 대화 컨텍스트 초기화
/compact 컨텍스트 확보를 위한 대화 기록 압축
/cost 토큰 사용량 및 세션 비용 표시
/doctor 설정 문제 진단
/mcp MCP 서버 연결 관리
/undo 마지막 체크포인트로 되돌리기

커스텀 슬래시 명령어

.claude/commands/에 나만의 명령어를 만드세요:

# .claude/commands/review.md
Review the current git diff for security vulnerabilities,
performance issues, missing error handling, and style violations.
Focus on $ARGUMENTS or the entire diff.

이제 /review auth module을 실행하면 auth 모듈 범위로 커스텀 리뷰가 실행됩니다.

훅: 생명주기 시점의 자동화

{
  "hooks": {
    "postToolUse": [
      {
        "matcher": "edit_file|write_file",
        "command": "prettier --write $FILE_PATH"
      }
    ],
    "preToolUse": [
      {
        "matcher": "bash",
        "command": "echo 'Running: $TOOL_INPUT'"
      }
    ]
  }
}

일반적인 패턴: 편집 후 자동 포맷팅, 위험한 명령 차단, 도구 호출 로깅, 세션 시작 시 환경 변수 주입.

모든 기능 활용하기

일반적인 파워 유저 워크플로:

  1. 세션 시작 — 프로젝트 디렉터리에서
  2. 서브에이전트 실행 — 병렬 리팩터링 작업 처리
  3. 자동 승인 — 확인 중단 없이 변경 사항 적용
  4. Bash 모드 — 테스트, 빌드, 배포 실행
  5. 훅 — 변경된 모든 파일 자동 포맷팅
  6. AnyCap — 코드 작업과 동시에 이미지 생성, 웹 리서치, 에셋 저장 처리
cd ~/my-saas-project
claude

> Refactor the payment module to the new Stripe API.
  Generate UI mockups for the checkout flow.
  Search for Stripe's latest pricing.
  Upload all assets to cloud storage when done.

Claude Code는 리팩터링을 처리하고, AnyCap은 이미지, 검색, 저장을 처리합니다. 하나의 세션으로 모든 기능을.

첫날부터 서브에이전트와 자동 승인을 사용할 필요는 없습니다. 기본 Claude Code 세션부터 시작하세요. 확인 프롬프트가 속도를 늦출 때 자동 승인을 추가하세요. 여러 파일 리팩터링을 처리할 때 서브에이전트를 활성화하세요. 코드 이외의 기능이 필요할 때 AnyCap을 설치하세요. 고급 기능은 준비됐을 때 언제든지 사용할 수 있습니다 — 그리고 이 기능들은 Claude Code를 채팅 도구에서 진정한 개발 에이전트로 탈바꿈시킵니다.

관련 문서