claude-sh은(는) 무엇을 하나요?
npm 의존성 없이 bash에서 Claude Code를 실행하고, 실시간 스트리밍, 도구 사용, 권한 관리, 세션 재개를 지원합니다.
개요
shadow400x/claude-sh는 Claude Code의 핵심 기능을 순수 bash 셸 환경에서 사용할 수 있게 해주는 스킬입니다. Node.js나 npm 패키지 설치 없이도 Claude Code의 실시간 스트리밍, 도구 호출, 권한 부여, 세션 복원 기능을 제공합니다.
주요 특징
- npm 불필요: curl과 bash만으로 동작
- 실시간 스트리밍: Claude 응답을 실시간으로 확인
- 도구 지원: Claude Code의 모든 도구 사용 가능
- 권한 관리: 안전한 권한 부여 및 관리
- 세션 재개: 중단된 세션을 이어서 작업 가능
설치 및 사용법
# GitHub 저장소에서 직접 실행 (권장)
curl -sSL https://raw.githubusercontent.com/shadow400x/claude-sh/main/claude.sh | bash
# 또는 로컬에 다운로드 후 실행
curl -o claude.sh https://raw.githubusercontent.com/shadow400x/claude-sh/main/claude.sh
chmod +x claude.sh
./claude.sh
환경 변수
| 변수 | 설명 | 필수 여부 |
|---|---|---|
ANTHROPIC_API_KEY | Anthropic API 키 | 필수 |
CLAUDE_SH_MODEL | 사용할 모델 (기본값: claude-sonnet-4-20250514) | 선택 |
CLAUDE_SH_MAX_TOKENS | 최대 토큰 수 (기본값: 8192) | 선택 |
CLAUDE_SH_SESSION_DIR | 세션 저장 디렉토리 (기본값: ~/.claude-sh/sessions) | 선택 |
도구 사용 예시
claude-sh는 Claude Code에서 지원하는 모든 도구를 사용할 수 있습니다:
- 파일 읽기/쓰기: 프로젝트 파일을 읽고 수정
- 터미널 명령 실행: bash 명령어를 직접 실행
- 코드 검색: 프로젝트 내 코드 검색
- 파일 생성/삭제: 프로젝트 파일 관리
세션 관리
세션은 자동으로 저장되며, --resume 플래그로 이전 세션을 재개할 수 있습니다:
# 새 세션 시작
./claude.sh
# 이전 세션 재개
./claude.sh --resume
# 특정 세션 ID로 재개
./claude.sh --resume <session-id>
권한 관리
claude-sh는 안전한 권한 부여 시스템을 제공합니다:
- 각 명령 실행 전 권한 확인
- 영구 허용/거부 설정 가능
- 세션별 권한 저장
# 권한 없이 실행 (모든 명령 자동 거부)
./claude.sh --no-permissions
# 권한 확인 없이 실행 (모든 명령 자동 허용)
./claude.sh --auto-approve
문제 해결
일반적인 문제
- API 키 오류:
ANTHROPIC_API_KEY환경 변수가 올바르게 설정되었는지 확인하세요. - 네트워크 오류: curl로
https://api.anthropic.com에 접근 가능한지 확인하세요. - 권한 문제: 실행 권한이 있는지 확인하세요 (
chmod +x claude.sh).
지원 및 기여
버그 리포트나 기능 제안은 GitHub 이슈를 이용해 주세요.
라이선스
MIT