Claude Code CLI: 필수 명령 및 구성
클로드 코드(Claude Code)는 단순한 AI 비서가 아닙니다. 향상된 터미널 통합하는 개발자의 일상적인 작업 흐름에서. 명령줄에서 파일을 관리하고 실행할 수 있습니다. 빌드, 테스트 실행, 코드 분석, 복잡한 작업 조정 등 모든 과정을 거쳐 프로젝트의 맥락을 이해하는 대화형 인터페이스입니다.
이 시리즈의 열두 번째 기사에서 우리는 명령줄 인터페이스 클로드 코드: 플랫폼별 설치방법, 키보드 단축키 작업 속도를 높이는 슬래시 명령, 에이전트 제어를 위한 명령, 계층 구조 4단계 구성, 보안 및 모드 권한 템플릿 CI/CD 자동화를 위한 헤드리스.
무엇을 배울 것인가
- macOS, Linux, Windows 및 WSL에 Claude Code 설치
- 작업 속도를 높이는 마스터 키보드 단축키
- 사용 가능한 모든 슬래시 명령을 사용하십시오.
- 4단계 구성 계층 이해
- 다양한 보안 시나리오에 대한 권한 템플릿 구성
- CI/CD 파이프라인을 위해 헤드리스 모드에서 Claude Code 실행
- 일반적인 설치 및 구성 문제 해결
- 일상 업무에 맞게 CLI 경험 최적화
전체 시리즈 개요
| # | Articolo | 집중하다 |
|---|---|---|
| 1 | 기술 파트너로서의 클로드 | 설정 및 첫 번째 단계 |
| 2 | 프로젝트 컨텍스트 및 설정 | CLAUDE.md 및 구성 |
| 3 | 개념 및 요구사항 | MVP 및 사용자 페르소나 |
| 4 | 백엔드 및 프런트엔드 아키텍처 | 스프링 부트와 Angular |
| 5 | 코드의 구조 | 조직 및 협약 |
| 6 | 고급 엔지니어링 프롬프트 | 고급 기술 |
| 7 | 테스트 및 품질 | 전략 및 테스트 생성 |
| 8 | 전문 문서 | 읽어보기, API, ADR |
| 9 | 배포 및 DevOps | 도커, CI/CD, 모니터링 |
| 10 | 진화와 유지 | 리팩토링 및 확장성 |
| 11 | 실제 프로젝트 통합 | 클로드 코드 제작 중 |
| 12 | 클로드 코드 CLI(현재 위치) | 명령 및 구성 |
| 13 | 에이전트 기술 | 모듈식 기능 |
| 14 | 전문 하위 에이전트 | 특정 역할을 맡은 상담원 |
| 15 | 후크 및 자동화 | 이벤트 중심 워크플로 |
| 16 | 랄프 위검 방법 | 테스트 중심 개발 |
| 17 | BMAD 방법 | 체계적인 프로젝트 관리 |
| 18 | 다중 에이전트 오케스트레이션 | 에이전트 파이프라인 |
| 19 | 협업 작업 | 팀 및 페어 프로그래밍 AI |
| 20 | 보안 및 모범 사례 | 강화 및 규정 준수 |
| 21 | 모니터링 및 관찰 가능성 | 측정항목 및 디버깅 |
1. 클로드코드 설치
Claude Code는 다양한 플랫폼과 설치 방법을 지원합니다. 방법의 선택
운영 체제와 개인 취향에 따라 다릅니다. 모든 방법이 동일하게 설치됩니다.
바이너리 claude 이는 시스템 PATH에 추가됩니다.
전제 조건
설치를 진행하기 전에 다음 요구 사항이 충족되는지 확인하십시오. 시스템에서:
시스템 요구사항
| 요구 사항 | 최소 버전 | 메모 |
|---|---|---|
| Node.js | 18.0+ | JavaScript 런타임에 필수 |
| npm | 9.0+ | Node.js에 포함됨 |
| 힘내 | 2.30+ | 저장소 작업용 |
| 운영 체제 | macOS 12+, Ubuntu 20.04+, Windows 10+(WSL2) | 기본 Linux 및 macOS 지원, Windows용 WSL |
| 인류학적 계정 | Pro, Max 또는 Team 플랜 | API 인증에 필요 |
방법 1: npm을 통한 설치(권장)
가장 보편적인 방법은 npm을 통한 전역 설치입니다. 그것은 그들 모두에서 작동합니다 Node.js를 사용할 수 있는 플랫폼이며 간단한 업데이트를 보장합니다.
# Installazione globale
npm install -g @anthropic-ai/claude-code
# Verifica installazione
claude --version
# Primo avvio e autenticazione
claude
# Aggiornamento alla versione più recente
npm update -g @anthropic-ai/claude-code방법 2: 컬을 통한 설치(macOS 및 Linux)
npm을 사용하지 않으려는 경우 직접 설치 스크립트를 사용할 수 있습니다. 미리 컴파일된 바이너리를 다운로드합니다. 이 방법은 특히 유용합니다. Node.js가 사전 설치되지 않은 환경에서.
# macOS e Linux
curl -fsSL https://cli.anthropic.com/install.sh | sh
# Verifica che il binario sia nel PATH
which claude
# Output atteso: /usr/local/bin/claude
# Prima esecuzione
claude방법 3: Homebrew를 통한 설치(macOS)
Homebrew를 패키지 관리자로 사용하는 macOS 사용자는 설치할 수 있습니다. 공식 탭을 통해 클로드 코드. 이 방법은 Claude Code를 보완합니다. 중앙 집중식 Homebrew 패키지 관리.
# Aggiungere il tap ufficiale Anthropic
brew tap anthropics/claude-code
# Installazione
brew install claude-code
# Aggiornamento
brew upgrade claude-code
# Verifica versione
claude --version방법 4: Windows에 설치(PowerShell + WSL)
Windows에서 Claude Code를 실행하려면 WSL2(Linux용 Windows 하위 시스템)가 필요합니다. 올바르게. PowerShell에서 직접 설치 가능 Windows 또는 WSL 터미널 내에서.
# Passo 1: Installare WSL2 (se non già installato)
wsl --install
# Passo 2: Aprire il terminale WSL (Ubuntu)
wsl
# Passo 3: Installare Node.js nel WSL
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
# Passo 4: Installare Claude Code
npm install -g @anthropic-ai/claude-code
# Passo 5: Verificare
claude --version
# Alternativa: Installazione diretta da PowerShell
# (Richiede Node.js installato su Windows)
npm install -g @anthropic-ai/claude-codeWindows 호환성에 관한 참고 사항
Windows의 Claude Code는 많은 개발 도구가 있기 때문에 WSL2에서 가장 잘 작동합니다. (Git, 컴파일러, 빌드 도구)은 Linux에서 기본적으로 지원됩니다. 당신이 일한다면 Unix와 유사한 도구가 필요한 프로젝트의 경우 WSL2를 적극 권장합니다. 기본 PowerShell 환경은 지원되지만 제한이 있을 수 있습니다. 일부 시스템 명령으로.
입증
설치 후 첫 번째 부팅 claude 인증 흐름을 시작합니다.
Claude Code는 두 가지 주요 인증 방법을 지원합니다.
인증 방법
| 방법 | 사용 | 구성 |
|---|---|---|
| 인류 콘솔 | 개인 Pro/Max 계정 | 처음 시작할 때 자동 브라우저 로그인 |
| API 키 | 계정팀, 엔터프라이즈, CI/CD | 환경변수 ANTHROPIC_API_KEY |
| AWS 기반암 | AWS 인프라의 엔터프라이즈 | AWS 자격 증명 구성 |
| 구글 버텍스 AI | GCP 인프라의 엔터프라이즈 | Google Cloud 사용자 인증 정보 구성 |
# Metodo 1: Variabile d'ambiente (sessione corrente)
export ANTHROPIC_API_KEY="sk-ant-api03-xxxxx"
# Metodo 2: File .env nella root del progetto
echo 'ANTHROPIC_API_KEY=sk-ant-api03-xxxxx' >> .env
# Metodo 3: Configurazione permanente in .bashrc o .zshrc
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-xxxxx"' >> ~/.zshrc
source ~/.zshrc
# Verifica autenticazione
claude --print-auth-status2. 키보드 단축키
클로드코드를 효율적으로 사용하기 위해서는 키보드 단축키가 필수적입니다. 이를 알면 작동 모드 간을 빠르게 전환하고 상황을 관리할 수 있습니다. 작업 리듬을 방해하지 않고 실행 흐름을 제어할 수 있습니다.
전체 바로가기 표
| 지름길 | 행동 | 자세한 설명 |
|---|---|---|
! |
배쉬 모드 | 직접 Bash 모드를 활성화합니다. 유형 ! 다음 명령
Claude가 프롬프트로 해석하지 않고 터미널에서 실행합니다.
예: !npm test 테스트를 직접 수행합니다. |
@ |
파일/폴더 언급 | 현재 컨텍스트에 추가하려면 파일이나 폴더를 언급하세요.
Tab을 사용한 자동 완성을 지원합니다. 예: @src/app/services/
컨텍스트에 따라 전체 폴더를 로드합니다. |
Esc |
방해하다 | 클로드의 현재 작업을 중지합니다. 세대를 이룰 때 유용함 잘못된 방향으로 가고 있거나 시간이 너무 오래 걸립니다. |
Esc + Esc |
되감기 메뉴 | Escape를 두 번 누르면 다음을 수행할 수 있는 되감기 메뉴가 열립니다. 대화의 이전 상태로 돌아가서 취소 클로드의 마지막 행동. |
Ctrl+R |
전체 출력 | 다음을 포함하여 마지막으로 실행된 명령의 전체 출력을 표시합니다. 간결함을 위해 잘린 부분. |
Shift+Tab |
자동 수락(YOLO 모드) | 거래에 대한 자동 수락 모드 활성화 후속. Claude는 메시지를 표시하지 않고 작업을 수행합니다. 프로덕션 환경에서는 주의하여 사용하십시오. |
Shift+Tab+Tab |
계획 모드 | 계획 모드를 활성화합니다. 클로드는 작업을 분석하고, 구조화된 계획을 작성하고 승인을 위해 제시합니다. 어떤 작업을 수행하기 전에. |
Ctrl+C |
입력 취소 | 없이 현재 입력에 입력된 텍스트를 지웁니다. 클로드 코드의 세션을 중단하세요. |
Ctrl+D |
출구 | 저장하여 현재 Claude Code 세션을 닫습니다. 대화의 역사. |
Tab |
자동완성 | 파일 이름, 폴더 및 슬래시 명령 자동 완성 입력 프롬프트에서. |
YOLO 모드: 사용 및 주의사항
YOLO(You Only Live Once) 모드가 활성화되었습니다. Shift+Tab 그것은 도구이다
강력하지만 위험합니다. 활성화되면 Claude는 다음을 포함한 모든 작업을 수행합니다.
파일 수정, 명령 실행 및 패키지 설치 - 없음
사용자에게 확인을 요청합니다.
YOLO 모드를 사용해야 하는 경우
- 신속한 프로토타이핑: 전용 브랜치에서 아이디어를 탐색할 때
- 자동 리팩토링: 이미 계획을 검증하고 빠른 실행을 원하는 경우
- 상용구 생성: 클로드가 비슷한 파일을 많이 만들어야 할 때
- 샌드박스 환경: Docker 컨테이너 또는 일회용 VM에서 작업하는 경우
YOLO 모드를 사용하지 않는 경우
- 생산: 메인/마스터 브랜치 또는 프로덕션 환경에서는 절대 사용하지 않음
- 파괴적인 작업: 작업에 파일 삭제가 포함될 수 있는 경우
- 시스템 명령: Claude가 sudo로 명령을 실행할 수 있었던 경우
- 민감한 데이터: 컨텍스트에 자격 증명이나 민감한 데이터가 포함된 경우
계획 모드: 구조화된 계획
계획 모드(Shift+Tab+Tab)는 YOLO 모드와 반대입니다. 그는 클로드에게 강요한다.
어떤 조치를 취하기 전에 상세한 계획을 세우는 것입니다. 계획에는 다음이 포함됩니다.
- 요청된 작업 분석 및 관련 파일 식별
- 수행할 작업의 순서가 지정된 순서
- 운영 간의 잠재적 위험 및 종속성
- 편집할 예상 파일 수
- 실행 전 명시적으로 승인 요청
# Attivare Plan Mode con Shift+Tab+Tab, poi scrivere il prompt:
> Aggiungi validazione email al form di registrazione
# Claude risponde con un piano:
# Piano di Esecuzione:
# 1. Leggere src/app/auth/register.component.ts
# 2. Leggere src/app/auth/register.component.html
# 3. Aggiungere validatore email al FormGroup
# 4. Aggiungere messaggio di errore nel template
# 5. Aggiungere test per la validazione email
# 6. Aggiornare il service di validazione
#
# File coinvolti: 4
# Operazioni: 6
#
# Procedere? [y/n]3. 슬래시 명령
슬래시 명령은 Claude Code의 동작을 제어하는 특수 명령입니다.
문자 앞에 프롬프트에 직접 입력됩니다. /. 모든 명령
세션, 컨텍스트 및 구성을 관리하는 특정 기능이 있습니다.
완전한 슬래시 명령 표
| 명령 | 설명 | 사용예 |
|---|---|---|
/add-dir |
현재 작업 컨텍스트에 디렉터리를 추가합니다. | /add-dir ../shared-libs 공유 라이브러리를 포함하려면 |
/agents |
디렉터리에서 사용 가능한 하위 에이전트를 표시하고 관리합니다. .claude/agents/ |
/agents 구성된 모든 하위 에이전트를 나열하려면 |
/clear |
현재 대화 기록을 지우고 컨텍스트를 확보합니다. | /clear 작업을 완료한 후 깨끗하게 시작하기 |
/config |
Claude Code 구성 파일을 열고 편집합니다. | /config 설정을 보고 변경하려면 |
/help |
사용 가능한 명령의 전체 가이드를 표시합니다. | /help 빠른 참조를 위해 |
/mcp |
구성된 MCP(Model Context Protocol) 서버를 관리합니다. | /mcp 연결된 서버의 상태를 보려면 |
/model |
현재 세션에서 사용되는 AI 모델 변경 | /model claude-sonnet-4-20250514 소네트로 전환하려면 |
/permissions |
Claude Code에 부여된 권한 보기 및 편집 | /permissions 클로드가 할 수 있는 일을 검토하기 위해 |
/rewind |
대화의 이전 상태로 돌아가기 | /rewind 최근 작업을 취소하려면 |
/status |
현재 세션 상태, 컨텍스트 및 토큰 사용량을 표시합니다. | /status 얼마나 많은 토큰이 사용되었는지 확인하려면 |
슬래시 명령의 고급 사용
슬래시 명령을 논리적 순서로 결합하여 관리할 수 있습니다. 복잡한 작업 세션. 다음은 몇 가지 고급 사용 패턴입니다.
# Pattern 1: Reset del contesto per un nuovo task
/clear
/add-dir ./src/features/new-feature
Implementa il componente UserProfile seguendo i pattern esistenti
# Pattern 2: Verifica stato prima di operazioni critiche
/status
/permissions
Esegui il refactoring del modulo di pagamento
# Pattern 3: Cambio modello per task specifici
/model claude-sonnet-4-20250514 # Per task rapidi e frequenti
Genera i test boilerplate per tutti i service
/model claude-opus-4-20250514 # Per task complessi
Analizza l'architettura e proponi miglioramenti
# Pattern 4: Debug di connessioni MCP
/mcp
# Verifica che i server necessari siano connessi
# prima di eseguire task che li richiedono사용자 정의 슬래시 명령
내장 명령 외에도 Claude Code는 다음 생성을 지원합니다. 사용자 정의 명령
디렉토리의 Markdown 파일을 통해 .claude/commands/. 각 파일 .md
세션에서 호출할 수 있는 슬래시 명령이 됩니다.
# Code Review Completa
Esegui una code review approfondita dei file modificati.
## Checklist
1. Verifica la correttezza logica del codice
2. Controlla naming conventions e coerenza
3. Identifica potenziali bug o edge case
4. Verifica la gestione degli errori
5. Controlla la copertura dei test
6. Valuta la performance e la scalabilità
## Output
Produci un report strutturato con:
- **Severita**: Critical / Major / Minor / Suggestion
- **File e riga**: Riferimento preciso
- **Problema**: Descrizione chiara
- **Soluzione**: Fix proposto con codice# Verifica Pre-Deploy
Prima di procedere con il deploy, controlla:
1. Esegui `npm run build` e verifica che non ci siano errori
2. Esegui `npm test` e verifica che tutti i test passino
3. Controlla che non ci siano console.log rimasti nel codice
4. Verifica che le variabili d'ambiente siano configurate
5. Controlla che il file .env.production sia aggiornato
6. Verifica la versione nel package.json
Riporta lo stato di ogni punto con un checkmark.
일단 생성되면 사용자 정의 명령이 다음과 같이 호출됩니다. /review o
/deploy-check Claude Code 프롬프트에서 직접.
4. 구성 계층
Claude Code는 구성 시스템을 사용합니다. 네 가지 계층적 수준, 여기서 각 레이어는 하위 레이어의 설정을 재정의할 수 있습니다. 이 아키텍처를 통해 정책부터 세분화된 구성까지 가능 개별 개발자의 개인 취향에 따라 기업이 결정됩니다.
구성 계층 구조(최고에서 최저)
| 수준 | 파일 경로 | 빗자루 | 우선 사항 |
|---|---|---|---|
| 기업 | /etc/claude-code/managed-settings.json |
조직 전체 | 최대(덮어쓸 수 없음) |
| 로컬 프로젝트 | .claude/settings.local.json |
프로젝트의 단일 개발자 | 높은 |
| 공유 프로젝트 | .claude/settings.json |
프로젝트의 모든 개발자 | 평균 |
| 글로벌 사용자 | ~/.claude/settings.json |
모든 사용자 프로젝트 | 기초적인 |
레벨 1: 기업(가장 높은 우선순위)
엔터프라이즈 구성은 시스템 관리자가 관리하며 다음 위치에 있습니다.
안으로 /etc/claude-code/managed-settings.json. 정의된 설정
이 수준에서 덮어쓸 수 없습니다 다른 수준에서.
이는 기업 보안 정책을 시행하는 데 이상적인 메커니즘입니다.
{
"permissions": {
"deny": [
"Bash(rm -rf /*)",
"Bash(sudo *)",
"Bash(chmod 777 *)",
"Write(~/.ssh/*)",
"Write(~/.aws/*)"
]
},
"security": {
"max_file_size_bytes": 10485760,
"blocked_domains": ["*.internal.company.com"],
"require_approval_for_network": true
},
"model": {
"default": "claude-sonnet-4-20250514",
"allowed": ["claude-sonnet-4-20250514", "claude-opus-4-20250514"]
}
}수준 2: 로컬 프로젝트(settings.local.json)
파일 .claude/settings.local.json 이는 개별 개발자에게만 해당됩니다.
프로젝트의 맥락에서. 이 파일 헌신해서는 안 된다
저장소에(다음에 추가해야 함) .gitignore) 개인 취향이 포함되어 있기 때문입니다.
{
"permissions": {
"allow": [
"Bash(npm run test:watch)",
"Bash(npm run dev)",
"Bash(docker compose up -d)"
]
},
"preferences": {
"model": "claude-opus-4-20250514",
"theme": "dark",
"auto_approve_reads": true
}
}수준 3: 공유 프로젝트(settings.json)
파일 .claude/settings.json 저장소 및 공유에 커밋됩니다.
전체 팀과 함께 프로젝트 구성. 규칙과 권한이 있는 곳입니다.
모든 개발자가 따라야 하는 사항입니다.
{
"permissions": {
"allow": [
"Bash(npm run *)",
"Bash(mvn *)",
"Bash(gradle *)",
"Bash(git status)",
"Bash(git diff *)",
"Bash(git log *)",
"Read(*)",
"Write(src/**/*)"
],
"deny": [
"Bash(git push --force *)",
"Bash(git reset --hard *)",
"Bash(rm -rf *)",
"Write(.env*)",
"Write(**/credentials*)",
"Write(**/secrets*)"
]
},
"context": {
"include_patterns": ["src/**/*.ts", "src/**/*.html", "src/**/*.css"],
"exclude_patterns": ["node_modules/**", "dist/**", ".angular/**"]
}
}레벨 4: 전역 사용자
파일 ~/.claude/settings.json 사용자의 홈 디렉토리에는
모든 프로젝트에 적용되는 전역 기본 설정입니다. 와 수준이네
우선순위가 가장 낮으며 모든 프로젝트 구성에 의해 재정의됩니다.
{
"permissions": {
"allow": [
"Bash(ls *)",
"Bash(cat *)",
"Bash(which *)",
"Bash(node --version)",
"Read(*)"
]
},
"preferences": {
"model": "claude-sonnet-4-20250514",
"auto_approve_reads": true,
"verbose_output": false,
"language": "it"
}
}갈등 해결
동일한 설정이 여러 수준에서 정의된 경우 우선 순위 수준은
더 큰 것이 우선합니다. 목록의 경우(예: allow e deny),
목소리 deny 더 높은 수준의 목소리가 항상 목소리보다 우세합니다.
allow 더 낮은 수준의. 이를 통해 정책이
회사의 보안 조치는 우회될 수 없습니다.
5. 보안 권한 템플릿
권한은 Claude Code가 메시지를 표시하지 않고 수행할 수 있는 작업을 제어합니다. 권한을 올바르게 구성하면 생산성과 보안의 균형이 유지됩니다. 여기 두 개가 있습니다 일반적인 시나리오에 즉시 사용할 수 있는 템플릿입니다.
템플릿 1: 기본 보안(표준 개발)
이 템플릿은 다음에 이상적입니다. 매일의 발전 원하는 곳 어디에서나 프로젝트에 Claude는 일반적인 개발 명령에 대한 자율성을 갖고 있지만 보호 기능이 있습니다. 민감한 파일 및 파괴적인 작업에 대해
{
"permissions": {
"allow": [
"Bash(npm run *)",
"Bash(npm test *)",
"Bash(npm install *)",
"Bash(npx *)",
"Bash(git status)",
"Bash(git diff *)",
"Bash(git log *)",
"Bash(git branch *)",
"Bash(git checkout *)",
"Bash(git add *)",
"Bash(git commit *)",
"Bash(tsc *)",
"Bash(ng *)",
"Bash(mvn *)",
"Bash(gradle *)",
"Bash(python -m pytest *)",
"Bash(docker compose *)",
"Bash(curl *)",
"Read(*)",
"Write(src/**/*)",
"Write(tests/**/*)",
"Write(docs/**/*)"
],
"deny": [
"Write(.env*)",
"Write(**/*.pem)",
"Write(**/*.key)",
"Write(**/credentials*)",
"Write(**/secrets*)",
"Write(~/.ssh/*)",
"Write(~/.aws/*)",
"Bash(rm -rf *)",
"Bash(sudo *)",
"Bash(chmod 777 *)",
"Bash(git push --force *)",
"Bash(git reset --hard *)"
]
}
}템플릿 2: 엄격한 보안(중요한 환경)
이 템플릿에는 다음이 필요합니다. 명시적인 승인 모든 작업에 대해 네트워크에 대한 모든 액세스를 작성하고 거부합니다. 데이터 환경에 이상적입니다. 민감하고 엄격한 규정 준수 또는 생산 중인 프로젝트.
{
"permissions": {
"allow": [
"Read(src/**/*)",
"Read(tests/**/*)",
"Read(docs/**/*)",
"Bash(git status)",
"Bash(git diff *)",
"Bash(git log *)"
],
"deny": [
"Write(*)",
"Bash(npm install *)",
"Bash(npx *)",
"Bash(curl *)",
"Bash(wget *)",
"Bash(ssh *)",
"Bash(scp *)",
"Bash(nc *)",
"Bash(git push *)",
"Bash(git commit *)",
"Bash(docker *)",
"Bash(sudo *)",
"Bash(rm *)",
"Bash(mv *)",
"Bash(cp *)"
]
},
"security": {
"require_approval_for_all_writes": true,
"require_approval_for_network": true,
"audit_log": true,
"max_file_modifications_per_session": 10
}
}템플릿 간 비교
| 나는 기다린다 | 기본 보안 | 엄격한 보안 |
|---|---|---|
| 파일 읽기 | 모든 파일에 대해 자동 | src/tests/docs에서만 자동 |
| 파일 쓰기 | src, test, docs에서 자동 | 각 파일에 대한 승인이 필요합니다. |
| 빌드 명령 | 자동(npm, mvn, gradle) | 거부됨 - 읽기 전용 |
| 힘내 명령 | 읽기 + 커밋/체크아웃 | 읽기 전용(상태, 차이점, 로그) |
| 네트워크 접속 | 컬 허용, ssh/scp 없음 | 완전히 거부됨 |
| 민감한 파일 | 잠김(.env, .pem, .key) | 잠김(모든 파일이 기록되고 있음) |
| 이상적인 사용 | 일일 개발 | 감사, 규정 준수, 생산 |
6. 헤드리스 모드
헤드리스 모드를 사용하면 Claude Code를 다음과 같은 방식으로 실행할 수 있습니다. 비대화형, CI/CD 파이프라인, 자동화 스크립트 및 배치 프로세스에 통합하는 데 이상적입니다. 이 모드에서 Claude는 프롬프트를 수신하여 실행하고 결과를 반환합니다. 구조화된 JSON 형식입니다.
기본 구문
# Sintassi base
claude --print "Analizza il codice in src/ e riporta i problemi" --output-format json
# Con limite di iterazioni
claude --print "Esegui i test e correggi i fallimenti" \
--output-format json \
--max-iterations 10
# Con modello specifico
claude --print "Genera la documentazione API" \
--output-format json \
--model claude-sonnet-4-20250514
# Con permessi espliciti
claude --print "Formatta tutti i file TypeScript" \
--output-format json \
--allowedTools "Bash(npx prettier --write src/**/*.ts)" \
--allowedTools "Read(*)"헤드리스 모드 기본 플래그
헤드리스 모드 플래그
| 플래그 | 설명 | 기본값 |
|---|---|---|
--print |
자동 모드로 실행하라는 메시지 | 의무사항 |
--output-format |
출력 형식(json, text, stream-json) |
text |
--max-iterations |
최대 반복 횟수(공구 사용 주기) | 제한 없는 |
--model |
사용할 AI 모델 | 구성에서 |
--allowedTools |
실행이 허용된 도구(반복 가능) | 구성에서 |
--verbose |
디버그 로그가 포함된 자세한 출력 | false |
GitHub Actions와 통합
헤드리스 모드 및 CI/CD 파이프라인과의 통합의 강력한 사용 사례입니다. 다음은 Claude Code를 사용하는 전체 GitHub Actions 워크플로 예시입니다. 각 Pull Request에 대한 자동 코드 검토.
name: Claude Code Review
on:
pull_request:
types: [opened, synchronize]
jobs:
review:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0
- uses: actions/setup-node@v4
with:
node-version: '20'
- name: Install Claude Code
run: npm install -g @anthropic-ai/claude-code
- name: Run Code Review
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
run: |
DIFF=$(git diff origin/main...HEAD)
claude --print "Analizza il seguente diff e fornisci una code review:
$DIFF
Formato output:
- Severity: Critical/Major/Minor
- File e riga
- Problema
- Soluzione proposta" \
--output-format json \
--max-iterations 5 > review.json
- name: Post Review Comment
uses: actions/github-script@v7
with:
script: |
const fs = require('fs');
const review = JSON.parse(fs.readFileSync('review.json', 'utf8'));
await github.rest.issues.createComment({
owner: context.repo.owner,
repo: context.repo.repo,
issue_number: context.issue.number,
body: review.result
});로컬 자동화 스크립트
#!/bin/bash
# Script per fix automatico di lint errors
echo "=== Claude Code Auto-Fix ==="
echo "Analizzando errori di lint..."
# Esegui lint e cattura errori
LINT_OUTPUT=$(npm run lint 2>&1 || true)
if [ -z "$LINT_OUTPUT" ]; then
echo "Nessun errore trovato!"
exit 0
fi
echo "Trovati errori. Avvio Claude Code per la correzione..."
claude --print "Correggi i seguenti errori di lint:
$LINT_OUTPUT
Regole:
- Correggi solo gli errori segnalati
- Non modificare la logica del codice
- Mantieni lo stile esistente" \
--output-format json \
--max-iterations 15 \
--allowedTools "Read(src/**/*)" \
--allowedTools "Write(src/**/*)" \
--allowedTools "Bash(npm run lint)"
echo "Fix completato. Verifica finale..."
npm run lint7. 일반적인 오류 및 문제 해결
올바르게 구성하더라도 사용 중에 오류가 발생할 수 있습니다. 클로드 코드로. 가장 일반적인 문제와 해결 방법은 다음과 같습니다.
일반적인 문제 및 해결 방법
| 문제 | 원인 | 해결책 |
|---|---|---|
| 명령을 찾을 수 없습니다: clude | PATH에 없는 바이너리 | 확인하다 npm list -g PATH에 전역 npm 경로를 추가합니다. |
| 인증 실패 | API 키가 유효하지 않거나 만료되었습니다. | 재방송 claude 로그인 흐름을 확인하거나 변수를 확인하세요. ANTHROPIC_API_KEY |
| 허가가 거부되었습니다 | 구성에 의해 차단된 작업 | 확인하다 /permissions 설정에 필요한 규칙을 추가하세요. |
| 컨텍스트가 너무 큼 | 컨텍스트에 파일이 너무 많습니다. | 사용 /clear 다음을 사용하여 필요한 파일만 다시 로드합니다. @ |
| 비율 제한을 초과했습니다. | 짧은 시간에 너무 많은 요청이 발생함 | 몇 분 정도 기다려 요금제 업그레이드를 고려해 보세요. |
| ENOENT .claude/settings.json | 구성 파일이 누락되었습니다. | 디렉터리 만들기 .claude/ 그리고 파일 settings.json 내용이 있는 {} |
| 모델을 사용할 수 없음 | 계획에 포함되지 않은 모델 | 사용 /model 현재 계획에서 사용 가능한 템플릿으로 전환하려면 |
| WSL 네트워크 오류 | WSL에 DNS가 구성되지 않았습니다. | 구성 /etc/resolv.conf 네임서버 포함 8.8.8.8 WSL에서 |
고급 디버깅
# Verificare la versione installata
claude --version
# Verificare lo stato dell'autenticazione
claude --print-auth-status
# Avviare in modalità debug verbose
claude --verbose
# Verificare la configurazione attiva
claude --print "Mostra la configurazione attiva" --output-format json
# Reset completo della configurazione
rm -rf ~/.claude/settings.json
claude # Ricrea la configurazione di default
# Verifica connettivita API
curl -s https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2024-01-01" \
-H "content-type: application/json" \
-d '{"model":"claude-sonnet-4-20250514","max_tokens":10,"messages":[{"role":"user","content":"test"}]}'8. CLI를 사용한 일일 워크플로우
Claude Code CLI의 진정한 힘은 워크플로우에 통합될 때 나타납니다. 매일 개발. 다음은 다음을 사용하는 개발자의 일반적인 하루입니다. 클로드 코드는 끊임없는 업무 동반자입니다.
아침 루틴
# 1. Entrare nella directory del progetto
cd ~/projects/my-app
# 2. Avviare Claude Code
claude
# 3. Verificare lo stato del repository
> !git status
> !git log --oneline -5
# 4. Caricare il contesto del task corrente
> @src/features/user-profile/
> Sto lavorando sulla feature user-profile.
> Cosa è stato fatto finora e cosa resta da implementare?
# 5. Attivare Plan Mode per il primo task
> [Shift+Tab+Tab] Implementa la validazione del form di profilo개발 흐름
# Implementazione feature
> Implementa il componente EditProfile con form reattivo
> Usa i validatori Angular per email, telefono e nome
> Segui i pattern esistenti in src/features/auth/
# Test
> Genera unit test per EditProfileComponent
> Copri i casi: form valido, email invalida, submit e cancel
# Code review
> /review # Usa il custom command creato in precedenza
# Commit
> !git add -A
> !git commit -m "feat(user-profile): add edit profile form with validation"
# Passare al task successivo
> /clear
> @src/features/notifications/
> Implementa il sistema di notifiche push생산성 패턴
일상적인 사용을 위한 모범 사례
- 미국
/clear다른 작업 사이: 맥락을 깨끗하게 유지하고 답변을 정확하게 유지합니다. - 다음을 사용하여 특정 파일을 언급하세요.
@: 상황에 맞는 소음을 줄이고 품질을 향상시킵니다. - 복잡한 작업을 위한 계획 모드: 다중 파일 작업 시 예상치 못한 상황 방지
- 상용구용 YOLO 모드: 반복적인 파일 생성 속도 향상
- 반복 작업을 위한 사용자 정의 명령: 검토, 배포 확인, 테스트 표준화
- 배쉬 모드(
!) 바로가기: 클로드에게 밖에 나갈 필요는 없어git status - 되감기(
Esc+Esc) 필요할 때: 방향이 틀리면 주저하지 말고 되돌아가세요 - 확인하다
/status주기적으로: 제한을 피하기 위해 토큰 사용량을 모니터링하세요.
9. 고급 구성
기본 템플릿 외에도 Claude Code는 고급 구성 옵션을 제공합니다. 단일 저장소, 분산 팀, 다중 프로젝트 환경과 같은 특정 시나리오에 적합합니다.
모노레포 구성
여러 패키지가 포함된 단일 저장소에서는 구성이 컨텍스트를 처리해야 합니다. 공통 규칙을 유지하면서 각 하위 프로젝트마다 다릅니다.
{
"permissions": {
"allow": [
"Read(*)",
"Write(packages/*/src/**/*)",
"Write(packages/*/tests/**/*)",
"Bash(npm run -w packages/* *)",
"Bash(npx turbo run *)",
"Bash(git *)"
],
"deny": [
"Write(packages/*/node_modules/**)",
"Write(packages/*/.env*)",
"Bash(rm -rf *)",
"Bash(sudo *)"
]
},
"context": {
"include_patterns": [
"packages/*/src/**/*.ts",
"packages/*/package.json",
"turbo.json",
"package.json"
],
"exclude_patterns": [
"**/node_modules/**",
"**/dist/**",
"**/.turbo/**"
]
}
}구성을 위한 환경 변수
지원되는 환경 변수
| 변하기 쉬운 | 설명 | Esempio |
|---|---|---|
ANTHROPIC_API_KEY |
인증용 API 키 | sk-ant-api03-xxxxx |
CLAUDE_CODE_MODEL |
기본 템플릿 | claude-sonnet-4-20250514 |
CLAUDE_CODE_MAX_TOKENS |
응답당 토큰 한도 | 16384 |
CLAUDE_CODE_CONFIG_DIR |
사용자 정의 구성 디렉터리 | /custom/path/.claude |
CLAUDE_CODE_VERBOSE |
자세한 출력 활성화 | true |
결론
Claude Code CLI는 단순한 AI 모델 래퍼 그 이상입니다. 그것은 대화형 개발 환경 통합하는 완전한 터미널에서 코드와 상호 작용하는 방식을 변화시킵니다. 조합 키보드 단축키, 슬래시 명령, 계층적 구성 및 헤드리스 모드 모든 워크플로 및 보안 수준에 적응하는 유연한 생태계를 만듭니다.
핵심 사항
- 유연한 설치: npm, 컬, Homebrew 또는 WSL - 환경에 가장 적합한 방법을 선택하세요.
- 필수 단축키:
!배쉬의 경우,@파일로,Esc+Esc되감기하다,Shift+Tab욜로를 위한 - 제어용 슬래시 명령:
/clear,/model,/status,/permissions세션을 관리하기 위해 - 4단계 계층구조: 기업 > 로컬 프로젝트 > 공유 프로젝트 > 글로벌 사용자
- 권한 템플릿: 개발을 위한 기본 보안, 프로덕션을 위한 엄격한 보안
- 헤드리스 모드: 구조화된 JSON 출력을 통한 CI/CD 자동화
- 사용자 정의 명령: 팀 작업 흐름을 표준화하기 위해 나만의 슬래시 명령 만들기
에서 다음 기사 우리는 에이전트 기술: 용량 전문 기술로 Claude Code의 기능을 확장하는 모듈식 문서, 데이터 분석, 웹 개발 등을 위한 것입니다. 만드는 방법을 알아 보겠습니다. 맞춤형 기술을 제공하고 이를 일상 업무 흐름에 통합합니다.