Claude Code 환경 설정 버전 관리 레포. 새 환경에서 동일한 설정을 빠르게 적용할 수 있습니다.
my_claude_code_setting/
├── agents/ # Claude Code 서브에이전트
│ ├── frontend-designer.md # UI/UX + 프론트엔드 전문 에이전트
│ ├── backend.md # 백엔드 API/서버 전문 에이전트
│ └── researcher.md # 기술 리서치 + 문서화 전문 에이전트
├── skills/ # Skills (agents에서 참조)
│ │
│ ├── [Anthropic Official]
│ ├── frontend-design.md # 프로덕션급 UI 설계 가이드
│ ├── web-artifacts-builder.md # React+Vite+Tailwind HTML 아티팩트 빌더
│ ├── canvas-design.md # PNG/PDF 비주얼 디자인
│ ├── webapp-testing.md # Playwright 웹앱 테스트
│ ├── mcp-builder.md # MCP 서버 개발 가이드
│ ├── pdf.md # PDF 처리
│ ├── docx.md # Word 문서 처리
│ ├── xlsx.md # Excel 스프레드시트 처리
│ │
│ ├── [Jeffallan/claude-skills]
│ ├── react-expert.md # React 전문 가이드
│ ├── nextjs-developer.md # Next.js 개발 가이드
│ ├── typescript-pro.md # TypeScript 전문 가이드
│ ├── playwright-expert.md # Playwright E2E 테스트
│ ├── vue-expert.md # Vue 3 전문 가이드
│ ├── javascript-pro.md # JavaScript 전문 가이드
│ ├── fastapi-expert.md # FastAPI 백엔드 가이드
│ ├── nestjs-expert.md # NestJS 백엔드 가이드
│ ├── api-designer.md # API 설계 가이드
│ ├── postgres-pro.md # PostgreSQL 전문 가이드
│ ├── python-pro.md # Python 전문 가이드
│ ├── graphql-architect.md # GraphQL 아키텍처
│ ├── microservices-architect.md # 마이크로서비스 아키텍처
│ ├── secure-code-guardian.md # 보안 코드 리뷰
│ ├── test-master.md # 테스트 전략 가이드
│ ├── spec-miner.md # 스펙 분석 가이드
│ ├── code-documenter.md # 코드 문서화 가이드
│ ├── architecture-designer.md # 아키텍처 설계 가이드
│ ├── the-fool.md # The Fool 탐색/창의 가이드
│ │
│ ├── [feiskyer/claude-code-settings]
│ ├── codex-skill.md # OpenAI Codex/GPT 코드 구현 ✅ 바로 사용
│ ├── deep-research.md # 멀티에이전트 심층 조사 ✅ 바로 사용
│ ├── youtube-transcribe-skill.md # YouTube 자막 추출 ✅ 바로 사용
│ ├── autonomous-skill.md # 장시간 자율 작업 실행 ⚠️ 플러그인 설치 필요
│ ├── kiro-skill.md # 기능 개발 워크플로우 ⚠️ 플러그인 설치 필요
│ ├── nanobanana-skill.md # AI 이미지 생성 (Gemini) ⚠️ 플러그인 설치 필요
│ └── spec-kit-skill.md # 스펙 기반 개발 ⚠️ 플러그인 설치 필요
├── plugins/
│ └── glm-assistant/ # 로컬 MCP 플러그인 (GLM-4.5-Air 무료 모델)
│ ├── server.py # MCP 서버 구현
│ ├── .mcp.json # MCP 서버 설정 (API 키 환경변수 참조)
│ └── requirements.txt # Python 의존성
├── mcp/
│ └── open-design.json # Open Design 로컬 MCP 설정 (OD_DATA_DIR은 $HOME로 일반화)
├── cmux/
│ └── cmux.json # cmux(AI 에이전트 병렬 터미널) JSONC 설정 템플릿
├── tmux/
│ └── tmux.conf # tmux 설정 (Shift+Enter, prefix=C-a, TPM 등)
├── statusline.sh # 상태바 스크립트 (모델/git/컨텍스트/비용 표시)
├── settings.json # Claude Code 전역 설정 (hooks, permissions, plugins)
├── CLAUDE.md # 전역 Claude 지침 (홈 디렉토리에 배치)
├── install.sh # 자동 설치 스크립트
└── .gitignore
git clone https://github.com/workdd/my_claude_code_setting.git
cd my_claude_code_setting
chmod +x install.sh
./install.sh설치 후 Claude Code를 재시작하면 적용됩니다.
# 에이전트 설치
mkdir -p ~/.claude/agents
cp agents/*.md ~/.claude/agents/
# 설정 파일 설치
cp settings.json ~/.claude/settings.json
# 전역 지침 설치 (홈 디렉토리에 배치)
cp CLAUDE.md ~/CLAUDE.md| 에이전트 | Skills (anthropics) | Skills (jeffallan) |
|---|---|---|
frontend-designer |
frontend-design, web-artifacts-builder, canvas-design, webapp-testing |
react-expert, nextjs-developer, typescript-pro, playwright-expert, vue-expert, javascript-pro |
backend |
mcp-builder |
fastapi-expert, nestjs-expert, api-designer, postgres-pro, python-pro, graphql-architect, microservices-architect, secure-code-guardian, test-master |
researcher |
pdf, docx, xlsx |
spec-miner, code-documenter, architecture-designer, the-fool |
Skills 출처:
- anthropics/skills —
skills/디렉토리에 포함 (자동 설치) - Jeffallan/claude-skills —
skills/디렉토리에 포함 (자동 설치) - feiskyer/claude-code-settings — SKILL.md는 포함, 일부 플러그인 별도 설치 필요 (아래 참조)
UI/UX 디자인 및 프론트엔드 개발 전문 에이전트.
- React / Next.js / Vue 3 컴포넌트 설계 및 구현
- Tailwind CSS / CSS Modules 스타일링
- 접근성 (WCAG 2.1 AA), 반응형 레이아웃
- 디자인 시스템 구축, 애니메이션/마이크로인터랙션
- 성능 최적화 (Lazy loading, LCP/CLS 개선)
백엔드 API 설계 및 서버 개발 전문 에이전트.
- REST API / GraphQL 설계 (OpenAPI 3.0)
- Python (FastAPI/Django), Node.js (NestJS/Express), Go
- PostgreSQL, Redis, MongoDB 스키마 설계 및 최적화
- JWT/OAuth 인증, RBAC 권한 관리
- Docker / Kubernetes / CI/CD 인프라
기술 리서치 및 Obsidian 문서화 전문 에이전트.
- 논문 분석 (arXiv, NeurIPS, ICML 등)
- 라이브러리/프레임워크 비교 분석
- ADR (Architecture Decision Record) 작성
- Obsidian 형식 기술 문서 자동 생성
- 기술 트렌드 및 경쟁사 분석
skills/ 디렉토리에 SKILL.md가 포함되어 있지만, 일부 스킬은 헬퍼 스크립트 포함 전체 플러그인 설치가 필요합니다.
| 스킬 | 설명 | 사전 요구사항 |
|---|---|---|
codex-skill |
OpenAI Codex/GPT로 코드 자동 구현 | codex CLI 설치 필요: npm install -g @openai/codex |
deep-research |
멀티에이전트 심층 조사 워크플로우 | Firecrawl/Exa MCP 있으면 더 강력 (없어도 동작) |
youtube-transcribe-skill |
YouTube 자막/트랜스크립트 추출 | yt-dlp (이미 설치됨) |
아래 스킬은 SKILL.md 외에 helper scripts/Python 파일이 있어 전체 기능을 위해 플러그인 설치가 필요합니다.
Claude Code 내에서 실행:
/plugin marketplace add feiskyer/claude-code-settings
그 후 개별 설치:
/plugin install kiro-skill@feiskyer-claude-code-settings
/plugin install autonomous-skill@feiskyer-claude-code-settings
/plugin install spec-kit-skill@feiskyer-claude-code-settings
/plugin install nanobanana-skill@feiskyer-claude-code-settings
| 스킬 | 설명 | 추가 요구사항 |
|---|---|---|
kiro-skill |
요구사항→설계→태스크→구현 워크플로우 | 없음 |
autonomous-skill |
장시간 멀티세션 자율 작업 | 없음 |
spec-kit-skill |
Spec-Kit 헌법 기반 스펙 주도 개발 | specify CLI 설치 필요 |
nanobanana-skill |
Google Gemini API로 이미지 생성/편집 | GOOGLE_API_KEY 환경변수 필요 |
nanobanana-skill 추가 설정:
# Google AI Studio에서 무료 API 키 발급: https://aistudio.google.com
export GOOGLE_API_KEY=your-key-here
pip install google-generativeai pillowClaude Code 세션 간 기억을 유지하는 플러그인. settings.json의 enabledPlugins에 이미 포함. 별도 설치 필요.
# Claude Code 내에서 실행
/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem@thedotmack토큰 절약용 GLM-4.5-Air 무료 모델 연동 플러그인. install.sh 실행 시 자동 설치됨.
수동 설치:
mkdir -p ~/.claude/plugins/local/glm-assistant
cp plugins/glm-assistant/* ~/.claude/plugins/local/glm-assistant/
pip install -r plugins/glm-assistant/requirements.txt
# API 키 설정 (https://openrouter.ai 에서 무료 발급)
export OPENROUTER_API_KEY=sk-or-...제공 도구 (MCP):
ask_glm- 일반 질문 (번역, 요약, 설명)ask_glm_code- 코드 리뷰, 버그 분석ask_glm_quick- 빠른 단답 (2-3문장 이내)
zai-org/glm-4.5-air:free모델을 OpenRouter를 통해 무료로 사용합니다.
Google NotebookLM과 AI 에이전트를 직접 연결하는 MCP 서버. 문서를 NotebookLM에 업로드하면 에이전트가 직접 질의하여 hallucination 없는 답변을 받습니다.
설치:
claude mcp add notebooklm npx notebooklm-mcp@latest최초 인증:
"Log me in to NotebookLM"
Chrome 창에서 Google 계정 로그인 후 자동 인증.
사용 방법:
- notebooklm.google.com에서 노트북 생성 후 문서 업로드
- 공유 링크 복사 (Anyone with link)
- Claude에게 링크 전달:
"이 NotebookLM 참고해서 작업해줘: [link]"
주요 특징:
- Zero-hallucination: NotebookLM이 모르면 거부 (추측 없음)
- Citation-backed: 모든 답변에 출처 포함
- 멀티소스 종합: 50+ 문서 간 정보 연결
- 토큰 절약: 문서를 직접 읽지 않고 NotebookLM에 질의
GitHub: PleasePrompto/notebooklm-mcp
파일을 벤더링하지 않고 설치 방법만 문서화한 항목입니다. 각 도구의 원본 저장소를 단일 진실 원천으로 두어 자동 업데이트를 받습니다.
# 사용량 대시보드 상태줄 (Claude/Codex/Gemini 한도 추적)
/plugin marketplace add uppinote20/claude-dashboard
/plugin install claude-dashboard@claude-dashboard
# Anthropic 공식 마켓플레이스
/plugin marketplace add anthropics/claude-plugins-official
/plugin install frontend-design@claude-plugins-official # 프론트엔드 디자인 가이드
/plugin install superpowers@claude-plugins-official # make-plan/do 등 확장 스킬 번들| 플러그인 | 마켓플레이스 | 역할 |
|---|---|---|
claude-dashboard |
uppinote20/claude-dashboard | 상태줄에 AI CLI 사용량·한도 표시, /check-usage |
frontend-design |
anthropics/claude-plugins-official | 프론트엔드 비주얼 디자인 가이드 |
superpowers |
anthropics/claude-plugins-official | make-plan·do·design-is·pathfinder 등 워크플로우 스킬 |
wrangler, cloudflare, durable-objects, workers-best-practices, agents-sdk, sandbox-sdk, cloudflare-one(+migrations), cloudflare-email-service, web-perf, turnstile-spin — Cloudflare 공식 스킬 저장소를 마켓플레이스로 add 후 필요한 스킬만 install 합니다. Workers/Pages/D1/R2/KV 작업 시 문서를 우선 참조하도록 편향됩니다.
| 도구 | 설치 | 비고 |
|---|---|---|
peon-ping |
curl -fsSL https://raw.githubusercontent.com/mbrock/peon-ping/main/install.sh | bash |
settings.json 훅이 참조 |
last30days |
mvanhorn/last30days-skill (npm skills CLI) | 최근 30일 소셜/웹 리서치. Python 3.12+ 필요 |
agentcat |
AgentCat 커넥터 설치 | ~/.local/bin/agentcat 훅이 참조, 사용량 커넥터 |
AI가 쓴 한글 텍스트의 "AI 티"를 제거하는 윤문 파이프라인. 스킬 3종(humanize, humanize-korean, humanize-redo)과 서브에이전트 12종으로 구성됩니다. 독립 저장소를 clone 후 자체 install.sh로 심볼릭 링크를 생성합니다 (벤더링하지 않음).
git clone https://github.com/epoko77-ai/im-not-ai.git ~/programming/im-not-ai
cd ~/programming/im-not-ai && ./install.sh
# ~/.claude/skills, ~/.claude/agents 로 심볼릭 링크 생성| 구성 | 항목 |
|---|---|
| 스킬 | humanize, humanize-korean, humanize-redo |
| 에이전트 | ai-tell-detector, korean-style-rewriter, naturalness-reviewer, content-fidelity-auditor, korean-ai-tell-taxonomist, humanize-monolith 외 6종 |
로컬 우선(local-first) 디자인 도구 Open Design 앱을 Claude Code에 MCP로 연결합니다. 아티팩트(HTML/JSX/CSS)와 소스 파일을 에이전트가 직접 읽고 수정할 수 있습니다.
설정 원본은 mcp/open-design.json 에 있으며, OD_DATA_DIR 의 $HOME 은 실제 홈 경로로 치환해야 합니다.
등록 (택 1):
# 방법 A — Open Design 앱이 자동 생성 (권장)
open-design mcp install claude
# 방법 B — 저장된 설정으로 수동 등록
claude mcp add-json open-design "$(sed "s#\$HOME#$HOME#g" mcp/open-design.json)"제공 도구(요약): get_artifact, get_file, search_files, list_projects, create_artifact, write_file 등. 사용자가 OD에서 열어둔 프로젝트/파일이 기본 컨텍스트가 됩니다.
⚠️ 이 MCP는 로컬 데스크톱 앱 종속입니다. Open Design 앱이/Applications에 설치돼 있고 데몬이 실행 중이어야 동작합니다. 다른 머신에서는 앱 설치 후 방법 A로 재등록하세요.
참고 — 이 저장소에서 의도적으로 제외한 MCP:
atlassian(Jira/Confluence),bitbucket. 사내 연동으로 보안상 포함하지 않습니다.
Claude Code 이벤트(시작, 완료, 알림)에 게임 사운드 효과를 추가하는 훅.
# peon-ping 설치 (별도 레포)
curl -fsSL https://raw.githubusercontent.com/mbrock/peon-ping/main/install.sh | bashsettings.json의 hooks가 peon-ping을 참조하므로, 사용하지 않으려면 hooks 섹션을 제거하세요.
macOS 메뉴바에서 여러 AI 코딩 어시스턴트의 사용량을 통합 모니터링하는 앱.
지원 서비스:
- Claude Code (Anthropic OAuth API, Keychain 저장)
- OpenAI Codex (로컬 세션 로그)
- Google Gemini (로컬 로그 파일)
- GitHub Copilot (GitHub Copilot API)
- Cursor (Cursor API + 로컬 DB)
- Z.ai (Z.ai quota API)
주요 기능:
- 메뉴바에 서비스별 사용량 바 표시 (사용량 순 정렬)
- 상세 사용량 팝오버 (서비스별 메트릭)
- 데스크톱 알림 (에이전트 이벤트)
- 커스텀 사운드 팩 지원
설치 방법:
# GitHub Releases에서 최신 DMG 다운로드 및 자동 설치
gh release download -R scari/AgentBar -p "*.dmg" -D ~/Downloads
open ~/Downloads/AgentBar.dmg
# AgentBar.app을 Applications 폴더로 드래그또는 자동 설치 (install.sh 사용):
./install.sh --agentbarAPI 키는 macOS Keychain을 통해 안전하게 관리됩니다.
| 설정 | 값 | 설명 |
|---|---|---|
alwaysThinkingEnabled |
true |
확장 사고 항상 활성화 |
effortLevel |
high |
추론 강도 |
theme |
dark |
다크 테마 |
skipDangerousModePermissionPrompt |
true |
위험 작업 확인 프롬프트 생략 |
permissions.defaultMode |
bypassPermissions |
권한 프롬프트 기본 우회 |
permissions.allow |
["Bash(git commit:*)", "Bash(pkill:*)"] |
자동 허용 커맨드 |
env.CLAUDE_CODE_DISABLE_AUTO_MEMORY |
1 |
자동 메모리 주입 비활성화 |
statusLine |
~/.claude/statusline.sh |
하단 상태바 (claude-dashboard 설치 시 전환 가능) |
enabledPlugins |
claude-mem, claude-dashboard, frontend-design, superpowers, glm-assistant | 활성 플러그인 |
⚠️ skipDangerousModePermissionPrompt: true와defaultMode: bypassPermissions는 개인 환경용 공격적 설정입니다. 공유·팀 환경에서는 각각false/default로 변경 권장.
훅은 전 이벤트에
peon-ping사운드와agentcat사용량 커넥터를 연결합니다. 두 도구를 설치하지 않으면 해당 훅은 조용히 무시됩니다(경로만 참조).
tmux/tmux.conf → ~/.tmux.conf 에 설치됩니다 (install.sh 자동 처리).
| 기능 | 설정 |
|---|---|
| 프리픽스 | Ctrl+A (기본 Ctrl+B 대신) |
| Shift+Enter | CSI-u 프로토콜로 Ghostty/xterm 지원 |
| 창 분할 | prefix + | 좌우, prefix + - 상하 |
| 창 이동 | prefix + h/j/k/l (Vim 스타일) |
| 4분할 이동 | prefix + u/i/J/K (고정 위치) |
| 마우스 | 활성화 (set -g mouse on) |
| 히스토리 | 10,000줄 |
| 테마 | base16-tmux breadog |
tmux-plugins/tmux-sensible- 합리적인 기본값mattdavis90/base16-tmux- breadog 테마
# tmux 실행 후 TPM으로 플러그인 설치
tmux
# prefix + I (대문자)cmux는 여러 AI 코딩 에이전트(Claude Code/Codex/Gemini)를 워크스페이스별로 나눠 병렬 실행하는 macOS 터미널 앱입니다. Claude Code 세션과 통합되어 사이드바에서 브랜치·PR·포트·진행 상태를 함께 봅니다.
설정 파일은 JSONC(주석 포함 JSON) 형식이며 cmux/cmux.json → ~/.config/cmux/cmux.json 에 설치됩니다 (install.sh 자동 처리). 저장소에 포함된 파일은 모든 옵션이 주석으로 문서화된 기본 템플릿으로, 원하는 항목의 주석을 해제하면 파일 관리(file-managed) 설정이 됩니다. 주석을 지우면 앱 Settings(GUI)에 저장된 값으로 폴백합니다.
# 앱 설치 (Homebrew 또는 릴리스 DMG)
brew install --cask cmux # 또는 https://github.com/manaflow-ai/cmux 릴리스
# 설정 템플릿 배치 (install.sh가 자동 처리)
mkdir -p ~/.config/cmux
cp cmux/cmux.json ~/.config/cmux/cmux.json| 섹션 | 키 | 설명 |
|---|---|---|
automation |
claudeCodeIntegration |
Claude Code 세션 통합 (기본 true) |
automation |
portBase / portRange |
워크스페이스 포트 할당 시작·범위 |
automation |
suppressSubagentNotifications |
서브에이전트 알림 억제 |
terminal |
autoResumeAgentSessions |
재시작 시 에이전트 세션 자동 복원 |
notifications |
hooksMode / hooks |
알림 훅 (append/replace) |
shortcuts.bindings |
(전체) | 키바인딩 재정의 |
앱의 실제 사용 상태(워크스페이스·세션)는
~/Library/Application Support/com.cmuxterm.app에 저장되며 버전관리 대상이 아닙니다. 이 저장소는 재현 가능한 설정 템플릿만 관리합니다.
참고 — 커밋된 템플릿의
automation.socketPassword는 빈 값입니다. 소켓 제어에 비밀번호를 쓰더라도 절대 이 파일에 평문으로 커밋하지 마세요.
API 키는 절대 이 레포에 포함하지 마세요.
# 권장: ~/.api-keys.env 에 보관 후 .zshrc에서 로드
# ~/.api-keys.env
OPENROUTER_API_KEY=sk-or-...
ANTHROPIC_API_KEY=sk-ant-...
# ~/.zshrc
source ~/.api-keys.env이 저장소는 파일을 벤더링하는 대신 설치 방법을 문서화하는 항목이 많습니다. 따라서 업데이트는 ⓐ 저장소 파일 동기화와 ⓑ 외부 도구 각자 업데이트, 두 축으로 나뉩니다.
cd my_claude_code_setting
git pull
./install.sh # settings/agents/skills/plugins/mcp/cmux/tmux 재설치# 마켓플레이스 플러그인 (Claude Code 내에서)
/plugin marketplace update thedotmack # claude-mem
/plugin marketplace update uppinote20/claude-dashboard
/plugin marketplace update anthropics/claude-plugins-official # frontend-design, superpowers
# humanize-korean 툴킷 (별도 저장소)
cd ~/programming/im-not-ai && git pull && ./update.sh # 없으면 ./install.sh
# 독립 도구
# peon-ping : install.sh 재실행
# cmux : brew upgrade --cask cmux (또는 앱 내 자동 업데이트)
# Open Design : 앱 자동 업데이트 후 필요 시 `open-design mcp install claude` 재등록cd my_claude_code_setting
# 실제로 편집한 것만 골라 동기화
cp ~/.claude/agents/{backend,frontend-designer,researcher}.md agents/
cp ~/.claude/settings.json settings.json
cp ~/.config/cmux/cmux.json cmux/cmux.json
# ⚠️ 커밋 전 필수 — 민감정보 스캔
grep -rniE 'okestro|sk-[a-zA-Z0-9]|/Users/[a-z]+|atlassian|bitbucket|jira|confluence' \
--exclude-dir=.git . && echo "누출 검토 필요!" || echo "클린"
# settings.json은 절대경로를 $HOME 으로 치환하고, 사내 훅(weekly-summary 등)을 제거한 뒤 커밋
git add -A
git commit -m "feat: 설정 업데이트"
git push
⚠️ 역반영 시 재발 주의 —~/.claude/settings.json원본에는 사내weekly-summary훅과 절대경로가 다시 들어있습니다. 그대로 덮어쓰지 말고 위 스캔·치환을 거친 뒤 커밋하세요.atlassian·bitbucketMCP,oke-jira-*스킬은 계속 제외 대상입니다.