설치 및 설정

Claude Code 자동화 시스템의 설치 및 설정 방법을 안내합니다.

사전 요구사항

• Claude Code CLI: Anthropic의 공식 CLI 도구
• jq: JSON 처리 도구 (hooks에서 사용)
• Git: 버전 관리
• Bash: 셸 스크립트 실행

선택 사항 (Multi-LLM용)

• OpenCode CLI: OpenCode 더블체크용
• Gemini API Key: Gemini 연동용
• Kilo CLI: Kilo 연동용

초기 설정

1. 프로젝트에 .claude 폴더 확인

multi-saas-kit 프로젝트에는 이미 .claude 폴더가 포함되어 있습니다.

ls -la .claude/

2. 로컬 설정 파일 생성

cp .claude/settings.json .claude/settings.local.json

settings.local.json은 로컬 개발 환경에서만 사용되며 Git에서 제외됩니다.

3. 환경 변수 설정 (선택)

Multi-LLM 연동 시 필요한 환경 변수:

# ~/.bashrc 또는 ~/.zshrc에 추가
export GEMINI_API_KEY="your-api-key"
export OPENCODE_PATH="/path/to/opencode"

환경별 설정

config/default.json

기본 설정 파일입니다. 모든 환경에서 사용됩니다.

{
  "multi_llm": {
    "enabled": true,
    "providers": ["opencode", "gemini", "kilo"],
    "timeout": 30,
    "fallback_enabled": true
  },
  "port_checker": {
    "enabled": true,
    "allocation_file": "workspace/PORTS.md"
  },
  "summary": {
    "incremental": {
      "enabled": true,
      "cooldown_seconds": 60
    },
    "compact": {
      "enabled": true,
      "max_bytes": 10000
    }
  }
}

config/ci.json

CI/CD 환경용 설정입니다. 일부 기능을 비활성화합니다.

{
  "multi_llm": {
    "enabled": false
  },
  "port_checker": {
    "enabled": true
  }
}

config/local.json (선택)

개인 로컬 환경용 설정입니다. .gitignore에 포함됩니다.

Multi-LLM 연동 설정

OpenCode 설정

{
  "multi_llm": {
    "providers": ["opencode"],
    "opencode": {
      "path": "/usr/local/bin/opencode",
      "timeout": 30
    }
  }
}

Gemini 설정

{
  "multi_llm": {
    "providers": ["gemini"],
    "gemini": {
      "api_key_env": "GEMINI_API_KEY",
      "model": "gemini-pro",
      "timeout": 30
    }
  }
}

Hooks 활성화 확인

.claude/settings.json에서 Hooks가 활성화되어 있는지 확인합니다.

{
  "hooks": {
    "UserPromptSubmit": [
      {
        "command": "bash .claude/hooks/user-prompt-submit.sh \"$PROMPT\"",
        "timeout": 30000
      }
    ],
    "PostToolUse": [
      {
        "command": "bash .claude/hooks/post-tool-use.sh ...",
        "timeout": 10000
      }
    ]
  }
}

설치 확인

Claude Code를 실행하고 /check-env 명령어로 환경을 확인합니다.

claude

# Claude Code 내에서
/check-env

정상적으로 설정되었다면 다음과 같은 결과가 표시됩니다:

✅ Git: 정상 (feature/xxx 브랜치)
✅ .env: 존재
✅ Docker: 실행 중
✅ Multi-LLM: OpenCode 연결됨

다음 단계

• 서브에이전트 - Agent 사용법
• 슬래시 명령어 - Command 목록
• Multi-LLM 시스템 - 더블체크 설정