자율주행 로봇 SW 엔지니어를 위한 Claude Code 개발 환경 설정. 회사처럼 그룹 단위로 일하는 오케스트라(가상 전문가 부서) + Codex/Gemini CLI 멀티-에이전트 오케스트레이션을 결합했다.
⚠️ 이 저장소에는 비밀·인증·런타임·개인 메모리가 포함되지 않는다(.gitignore참조). 인증(codex login/gemini login)과 개인 메모리는 각 머신에서 별도로 설정한다.
.claude/
├── CLAUDE.md # 6대 워크플로우 원칙(원문 보존) + guidelines/INDEX 자동 로드
├── settings.json # hooks 8종(advisory) + 보호용 deny
├── guidelines/ # persona, orchestra-ops, multi-cli-orchestration, memory/skill-policy
├── skills/ # 오케스트라 4팀 + orchestra-hq + 멀티-CLI 6종
│ ├── orchestra-hq/ # 총괄 조정자(PM/CTO): 라우팅·협업·채용
│ ├── server-orchestra/ # 인프라부 (8 agents)
│ ├── thesis-orchestra/ # 연구부 (7 agents)
│ ├── paper-survey-orchestra/ # 서베이부 (6 agents)
│ ├── recruiting-orchestra/ # 인사부=신규팀 채용 (4 agents)
│ ├── codex-system/ gemini-system/ # 외부 CLI 컨설턴트
│ └── startproject/ tdd/ checkpointing/ design-tracker/
├── hooks/ # 키워드 라우팅·로깅·리뷰 제안(비차단)
├── rules/ agents/ docs/
.codex/ (AGENTS.md, config.toml, skills) # Codex CLI 역할·설정
.gemini/ (GEMINI.md, settings.json, skills) # Gemini CLI 역할·설정
# 1) CLI 설치 (사용자 권한)
npm config set prefix "$HOME/.local"
npm install -g @anthropic-ai/claude-code @openai/codex @google/gemini-cli
# (~/.local/bin 이 PATH에 있어야 함)
# 2) 설정 배치 (이 repo를 클론한 위치에서)
cp -r .claude/* ~/.claude/ # 기존 파일 백업 후 병합 권장
cp -r .codex/* ~/.codex/
cp -r .gemini/* ~/.gemini/
chmod +x ~/.claude/hooks/*.py ~/.claude/skills/checkpointing/checkpoint.py
# 3) 로그인 (대화형, 머신마다)
codex login --device-auth # 또는 OPENAI_API_KEY 사용
echo 'GEMINI_API_KEY=...' >> ~/.gemini/.env # 또는 gemini → /auth- 컨텍스트 보존: 출력 큰 작업은 서브에이전트(Codex/Gemini) 경유, 결과는
docs/에 저장. - 역할 분담: Codex=설계·디버깅, Gemini=리서치·대용량·멀티모달, Claude=오케스트레이션·실행.
- 스택 중립: 빌드/린트/테스트는 프로젝트 스택을 따른다(ROS2/C++ · Python · Node 등).
- 모델명: 설치된 CLI 기본값 사용. 특정 모델은
.codex/config.toml한 줄로 지정.
멀티-CLI 오케스트레이션 구조는 gaebalai/claude-code-orchestrator (MIT)를 기반으로 본 환경에 맞게 적응했다.