참조 문서

claude

Claude Code 대화형 세션을 시작합니다.

구문

claude [options]

옵션

claude config

Claude Code 설정을 관리합니다.

하위 명령

• claude config get <key> - 설정 값 조회
• claude config set <key> <value> - 설정 값 변경
• claude config list - 모든 설정 표시
• claude config reset - 기본값으로 초기화

설정 가능한 키

model              # 기본 모델
api-key            # API 키
timeout            # 요청 타임아웃 (ms)
max-context        # 최대 컨텍스트 크기
log-level          # 로그 레벨 (debug, info, warn, error)
rate-limit-delay   # 요청 간 지연 시간 (ms)

claude usage

사용량 통계를 조회합니다.

옵션

• --current - 현재 세션 사용량
• --today - 오늘 사용량
• --report <period> - 특정 기간 보고서 (daily, weekly, monthly)
• --format <type> - 출력 형식 (text, json, csv)

Read

파일 내용을 읽습니다.

권한 필요

--allowedTools Read

사용 예시

> package.json 파일을 읽어줘
> src/index.js의 내용을 보여줘

Write

파일을 생성하거나 수정합니다.

권한 필요

--allowedTools Write

보안 고려사항

• 기존 파일 덮어쓰기 시 경고
• 민감한 파일 패턴 자동 차단
• 사용자 확인 옵션 제공

Bash

시스템 명령을 실행합니다.

권한 필요

--allowedTools Bash

패턴 기반 제한

# 특정 명령만 허용
--allowedTools "Bash(npm test:*)" "Bash(git:*)"

# 위험한 명령 차단
--disallowedTools "Bash(rm:*)" "Bash(sudo:*)"

Grep

파일 내용을 검색합니다.

권한 필요

--allowedTools Grep

지원 패턴

• 정규 표현식
• 대소문자 구분/무시
• 파일 패턴 필터링

WebSearch

웹에서 정보를 검색합니다.

권한 필요

--allowedTools WebSearch

제한사항

• 미국 지역에서만 사용 가능
• 일일 검색 횟수 제한

ClaudeCode 클래스

생성자

new ClaudeCode(options: ClaudeCodeOptions)

ClaudeCodeOptions

interface ClaudeCodeOptions {
  apiKey: string;
  workingDirectory?: string;
  model?: 'claude-3-opus' | 'claude-3-sonnet' | 'claude-3-haiku';
  maxRetries?: number;
  timeout?: number;
  proxy?: string;
  debug?: boolean;
}

메서드

// 단일 요청 실행
execute(request: ExecuteRequest): Promise<ExecuteResult>

// 스트리밍 응답
stream(request: StreamRequest): Promise<Stream>

// 세션 생성
createSession(): Session

// 도구 등록
registerTool(tool: CustomTool): void

// 이벤트 리스너
on(event: string, handler: Function): void
off(event: string, handler: Function): void