설치 가이드
Foundation(개발 키트) 설치 및 초기 설정 방 법입니다.
🚧 준비 중
배포 방식이 아직 확정되지 않았습니다. 정식 출시 시 업데이트됩니다.
개요
Foundation은 기존 프로젝트에 추가하거나, 새 프로젝트에서 시작할 수 있습니다.
배포 방식 (예정)
배포 방식은 다음 중 하나로 결정될 예정입니다:
| 방식 | 설명 |
|---|---|
| 직접 다운로드 | codebase.how에서 라이선스 구매 후 다운로드 |
| 초대 링크 | 구매자에게 개별 초대 링크 발송 |
정식 출시 시 이 페이지가 업데이트됩니다.
핵심 구성 요소
1. Claude Code 설정 (.claude/)
AI 협업 자동화 시스템입니다.
.claude/
├── agents/ # Subagent 정의
├── commands/ # 슬래시 명령어
├── hooks/ # 자동 실행 스크립트
├── skills/ # 재사용 템플릿
├── config/ # 설정 파일
└── custom/ # 프로젝트별 커스텀
설정 확인:
# Claude Code 버전 확인
claude --version
# 설정 파일 확인
cat .claude/config/default.json
2. 인프라 도구 (ops/, Makefile)
Makefile 기반 명령어 시스템입니다.
# 명령어 목록 확인
make help
# 프로젝트 목록 확인
make list
3. 문서 체계
CLAUDE.md와 README.md 기반 문서화입니다.
| 파일 | 역할 |
|---|---|
CLAUDE.md | AI 지침 (Claude Code가 읽음) |
README.md | 사람을 위한 문서 |
초기 설정
1. 환경 변수 설정
# 루트 .env 파일 생성
cp .env.example .env
필수 변수:
PLATFORM_NAME=msk # 플랫폼 이름 (소문자 권장)
PLATFORM_ADMIN_EMAIL=admin@example.com # 관리자 이메일
# 제품 사이트 / 문의
PORTAL_WEB_URL=https://codebase.how
PORTAL_STORE_URL=https://store.codebase.how
PRODUCT_SUPPORT_EMAIL=support@codebase.how
# 설치된 플랫폼 공용 도메인
PLATFORM_BASE_DOMAIN=codebase.how
PLATFORM_DOCS_URL=https://docs.codebase.how
PLATFORM_DASHBOARD_URL=https://dashboard.codebase.how
PLATFORM_DEVTOOLS_URL=https://devtools.codebase.how
고객사 설치형에서는 위 PLATFORM_* 값을 고객사 도메인으로 바꾸면 됩니다.
2. Claude Code 설정 확인
# 환경 확인 명령어
/c:check-env
3. Docker 설정 (선택)
# Docker Compose 확인
docker compose version
# 아키텍처 확인 (ARM64/AMD64)
uname -m
검증
설치가 완료되면 다음을 확인하세요:
# 1. Makefile 동작 확인
make help
# 2. Claude Code 동작 확인
claude "hello"
# 3. 환경 상태 확인
/c:check-env
운영 환경 권장: Dev Tools 구축
Foundation 설치 후, 운영 효율성을 위해 Dev Tools 5종을 함께 구축하길 권장합니다.
| 도구 | 역할 | 권장도 |
|---|---|---|
| 🏠 Dev Tools Hub | 모든 도구의 단일 진입점 | ⭐⭐⭐ |
| 🤖 AI Core Dashboard | Claude/LLM 사용량·비용 추적 | ⭐⭐⭐ |
| 🐘 pgAdmin | PostgreSQL 통합 관리 | ⭐⭐ |
| 🔴 RedisInsight | Redis 캐시/세션/큐 시각화 | ⭐⭐ |
| 📊 Monitoring (Grafana LGTM) | 로그·메트릭·알림 통합 | ⭐⭐⭐ |
# Dev Tools 한 번에 시작
make up NAME=_devtools/hub
make up NAME=_devtools/dashboard
make up NAME=_devtools/pgadmin
make up NAME=_devtools/redisinsight
make up NAME=_devtools/monitoring
전체 구성 가이드: Dev Tools 개요
다음 단계
- 시스템 요구사항 - 필요 환경 상세
- 플랫폼 공용 도메인 - 2-서브도메인 체계
- Dev Tools 개요 - 5종 통합 도구
- AI 워크플로우 - AI 협업 시스템 활용
- Makefile 명령어 - 명 령어 레퍼런스