Claude Code CLI
가이드
설치부터 플러그인, 토큰 최적화까지 — Windows 기준
설치 전 확인
📋 추가 요구사항 — Windows 10 이상, Git for Windows 설치 필요
Claude Code 설치
PowerShell
irm https://claude.ai/install.ps1 | iex
CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
winget install Anthropic.ClaudeCode
npm install -g @anthropic-ai/claude-code
설치 확인
claude --version
claude doctor
첫 실행
cd your-project
claude
첫 실행 시 브라우저가 자동으로 열리며 Claude 계정으로 로그인해야 합니다. 로그인 후 터미널로 돌아오면 Claude Code가 시작됩니다.
슬래시 명령어
Claude Code 세션 내에서 /로 시작하는 명령어를 사용하여 설정을 변경하거나 다양한 기능을 활성화할 수 있습니다.
| 명령어 | 설명 |
|---|---|
| /help | 사용 가능한 모든 명령어 표시 |
| /config | 설정 변경 (인터랙티브). Auto-compact 등 자동화 설정도 여기서 관리 |
| /compact | 대화 내용을 압축하여 컨텍스트 확보. 압축 시 이전 맥락이 요약되므로 세부 내용이 일부 손실될 수 있음에 주의 |
| /allowed-tools | 도구 권한 관리 |
| /hooks | Hook 설정 관리 |
| /mcp | MCP 서버 관리 |
| /agents | 서브에이전트 관리 |
| /clear | 대화 초기화 (컨텍스트 리셋) |
| /model | 모델 및 성능 설정 변경 |
| /usage | 현재 세션 토큰 사용량 확인 |
| /plugin | 플러그인 관리 화면 (설치, 업데이트, 제거) |
플러그인 관리
Claude Code에서 /plugin을 입력하면 플러그인 관리 화면이 열립니다. 상단 탭으로 이동하며 모든 작업을 UI에서 처리할 수 있습니다.
| 탭 | 기능 |
|---|---|
| Plugins | 설치된 플러그인 목록 확인 |
| Discover | 새로운 플러그인 탐색 |
| Installed | 설치된 플러그인 관리 (제거 등) |
| Marketplaces | 마켓플레이스 관리 (추가/업데이트/제거) |
| Errors | 플러그인 오류 확인 |
플러그인 업데이트 방법:
/plugin입력하여 관리 화면 열기- 상단에서 Marketplaces 탭 선택
- 업데이트할 플러그인의 마켓플레이스 선택
- Update marketplace 선택
- Claude Code 재시작
플러그인 설치 흐름:
- 마켓플레이스 추가:
/plugin marketplace add [저장소] /plugin→ Marketplaces 탭 → 플러그인 선택 → 설치- Claude Code 재시작
- 초기 설정 실행 (플러그인에 따라 다름)
Context Window란?
Claude가 한 번의 대화에서 기억할 수 있는 텍스트의 최대 용량. 대화가 길어지면 컨텍스트가 가득 차서 이전 내용을 잊게 됩니다.
/compact명령으로 현재까지의 대화를 압축하여 공간을 확보할 수 있습니다- 단, 압축 시 세부적인 맥락이나 코드 디테일이 일부 손실될 수 있으므로, 중요한 작업 중에는 주의가 필요합니다
/config에서 Auto-compact를 활성화하면, 컨텍스트가 일정 수준 이상 차면 자동으로 압축됩니다- Auto-compact가 동작하면 Claude가 자동으로 대화를 요약하여 공간을 확보하지만, 이전에 논의한 세부사항을 참고해야 할 경우 다시 알려줘야 할 수 있습니다
복잡한 작업 중 컨텍스트가 부족해지면 /compact 후 핵심 맥락을 다시 알려주는 것이 가장 안전하다
/model — 모델 및 Effort 설정
/model 명령으로 사용 중인 모델을 변경하거나, effort(추론 강도)를 설정할 수 있습니다.
| 설정 | 설명 |
|---|---|
| 모델 선택 | Opus, Sonnet, Haiku 등 원하는 모델로 전환 |
| auto (기본) | Claude가 작업 복잡도에 따라 자동 판단 |
| low | 빠른 응답, 간단한 작업에서 토큰 절약 |
| high | 깊은 추론, 복잡한 디버깅 및 아키텍처 설계에 적합 |
Effort를 낮추면 간단한 작업에서 응답 속도가 빨라지고 토큰을 절약할 수 있습니다. 복잡한 디버깅이나 아키텍처 설계 시에는 high로 설정하면 더 정확한 결과를 얻을 수 있습니다.
키보드 단축키 & 모드 전환
| 단축키 | 기능 |
|---|---|
| Shift+Tab | 모드 전환 — 바이패스 모드 / 플랜 모드 / 기본 모드 순환 |
| Alt+V | 이미지(스크린샷) 붙여넣기 — 캡처한 화면을 Claude에게 바로 전달 |
모드 전환 (Shift+Tab)
Claude Code 세션 중 Shift+Tab을 누르면 실행 모드가 순환됩니다.
| 모드 | 동작 |
|---|---|
| 기본 모드 | 모든 작업에 사용자 승인 필요 |
| 바이패스 모드 (Auto-accept) | 파일 수정, 명령 실행을 자동 승인 |
| 플랜 모드 | 코드 수정 없이 계획만 수립 (실행 전 리뷰용) |
이미지 붙여넣기 (Alt+V)
스크린샷이나 이미지를 클립보드에 복사한 후 Alt+V로 Claude에게 바로 전달할 수 있습니다. 에러 화면, UI 스크린샷, 디자인 시안 등을 보여주며 질문할 때 유용합니다.
Thinking 모드 설정
Alt+T로 Thinking 모드를 켜고 끌 수 있습니다
On/Off 차이점
| 모드 | 설명 |
|---|---|
| Thinking Off | 빠른 응답, 간단한 작업에 적합. 토큰 소비 적음 |
| Thinking On | 응답 전 '생각하는 과정'을 거침. 복잡한 문제에 더 정확하지만 토큰을 2–3배 더 소비 |
간단한 수정은 Off, 복잡한 버그 추적이나 설계는 Thinking On 권장
oh-my-claudecode (OMC)
oh-my-claudecode(OMC)는 전 세계 Claude Code 사용자들이 가장 많이 사용하는 플러그인으로, 19개 전문 에이전트와 28개 스킬을 제공하는 멀티 에이전트 오케스트레이션 시스템입니다. Claude Code를 설치했다면 OMC를 기본으로 같이 설치하고 시작하는 것을 강력히 권장합니다.
설치 단계
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
/plugin install oh-my-claudecode
플러그인 설치 후 반드시 Claude Code를 완전히 종료하고 다시 시작해야 합니다. 재시작하지 않으면 플러그인이 로드되지 않습니다.
/oh-my-claudecode:omc-setup
팀 기능 활성화 (선택사항)
OMC의 팀 기능은 여러 AI 에이전트가 동시에 협업하는 기능입니다. 이 기능을 사용하려면 Claude Code의 실험적 팀 설정을 활성화해야 합니다.
Claude Code에 아래 프롬프트를 입력하면 자동으로 설정됩니다.
settings.json에 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS 환경변수를 1로 설정해줘
설정 후 Claude Code를 재시작하면 팀 기능을 사용할 수 있습니다.
팀 모드란?
팀 모드는 여러 AI 에이전트가 동시에 병렬로 작업하는 기능입니다. 예를 들어 team: 이 프로젝트를 분석하고 테스트도 작성해줘라고 요청하면, Explore 에이전트가 코드를 분석하는 동안 Test-Engineer 에이전트가 테스트를 작성하는 식으로 동시에 진행됩니다.
단일 에이전트가 순차적으로 처리하는 것보다 훨씬 빠르지만, 각 에이전트가 독립적으로 API를 호출하므로 토큰 소모량이 크게 증가합니다.
팀 모드는 여러 에이전트가 동시에 동작하므로, 일반 모드 대비 토큰 소모가 3~5배 이상 증가할 수 있습니다. Claude Max 구독이 아닌 경우 Rate Limit에 빠르게 도달할 수 있으므로, 복잡한 대규모 작업에만 선택적으로 사용하는 것을 권장합니다.
team: 프론트엔드 리팩토링하면서 동시에 API 테스트도 작성해줘
→ 여러 에이전트가 동시에 작업을 분담하여 병렬로 처리합니다.
주요 실행 모드
아이디어에서 동작하는 코드까지 자율 실행
아키텍트 검증 포함 지속 루프
최대 병렬 실행
인터뷰 기반 전략 계획
소크라테스식 요구사항 명확화
조율된 에이전트 팀
19개 에이전트 (3 도메인)
빌드 / 분석
리뷰 / 품질
도메인 전문가
실전 사용법 — 자연어로 말하면 알아서 동작합니다
OMC의 가장 큰 장점은 별도의 명령어를 외울 필요가 없다는 것입니다. 평소처럼 자연어로 요청하면, OMC가 자동으로 적절한 에이전트와 스킬을 선택하여 실행합니다. 아래는 실제로 자주 사용하는 프롬프트 예시입니다.
이 프로젝트 코드베이스를 분석해줘
→ Explore 에이전트가 자동으로 프로젝트 구조를 스캔하고, 주요 파일과 아키텍처를 파악하여 보고합니다.
이 코드 리뷰해줘
→ Code-Reviewer 에이전트가 코드 품질, 버그 가능성, 개선점을 분석합니다.
이 버그 원인을 찾아줘
→ Debugger 에이전트가 스택 트레이스를 분석하고 근본 원인을 추적합니다.
보안 취약점 검사해줘
→ Security-Reviewer 에이전트가 OWASP Top 10 기준으로 코드를 점검합니다.
테스트 코드 작성해줘
→ Test-Engineer 에이전트가 테스트 전략을 수립하고 테스트 코드를 생성합니다.
autopilot: 로그인 기능을 만들어줘
→ autopilot 모드가 활성화되어, 설계부터 구현, 테스트까지 자율적으로 진행합니다. 여러 에이전트가 순차적으로 협업합니다.
plan: 결제 시스템 리팩토링 계획을 세워줘
→ Planner + Architect 에이전트가 인터뷰 기반으로 요구사항을 파악하고 단계별 실행 계획을 수립합니다.
이 프로젝트의 README를 작성해줘
→ Writer 에이전트가 프로젝트 구조를 파악한 뒤 문서를 자동 생성합니다.
OMC를 설치한 뒤에는 평소와 똑같이 Claude Code를 사용하면 됩니다. 복잡한 작업일수록 OMC의 멀티 에이전트가 자동으로 협업하여 더 나은 결과를 만들어냅니다. 특별한 명령어를 외울 필요 없이, 하고 싶은 일을 자연어로 말하면 됩니다.
HUD 설정
OMC HUD는 터미널 하단에 실시간 상태 바를 표시하여 컨텍스트 사용량, 에이전트 상태, 작업 진행도를 한눈에 확인할 수 있습니다.
설정
/oh-my-claudecode:hud setup
설정 후 Claude Code 재시작 필요
프리셋 변경
/oh-my-claudecode:hud minimal # 최소 표시
/oh-my-claudecode:hud focused # 기본값 (권장)
/oh-my-claudecode:hud full # 전체 표시
프리셋 미리보기
HUD 표시 요소
| 요소 | 설명 |
|---|---|
| [OMC] | OMC 모드 식별자 |
| repo:name | 리포지토리 이름 |
| branch:name | git 브랜치 |
| ctx:67% | 컨텍스트 사용률 — 초록(정상) → 노랑(70%+) → 빨강(85%+) |
| agents:2 | 활성 서브에이전트 수 |
| todos:2/5 | TODO 진행률 |
문제 해결
/oh-my-claudecode:omc-doctor
RTK는 Claude Code의 CLI 출력을 압축하여 평균 60~90%의 토큰을 절약하는 도구입니다. git, npm, tsc, vitest 등의 출력을 자동으로 필터링하여 핵심 정보만 전달합니다.
압축 전략 (4가지)
테스트 실패, 에러만 추출. 성공 출력 제거
반복되는 로그 라인을 카운트로 압축
에러/경고를 파일별로 그룹화해 가독성 향상
JSON 구조 요약, 핵심 메트릭만 표시
카테고리별 절감율
| 카테고리 | 주요 명령어 | 절감율 |
|---|---|---|
| 테스트 | vitest, playwright, cargo test | 90–99% |
| 빌드 | next build, tsc, lint, prettier | 70–87% |
| Git | status, log, diff, add, commit | 59–80% |
| GitHub CLI | gh pr, gh run, gh issue | 26–87% |
| 패키지 매니저 | pnpm, npm, npx | 70–90% |
| 파일 & 검색 | ls, grep, find, read | 60–75% |
| 인프라 | docker, kubectl | 85% |
| 네트워크 | curl, wget | 65–70% |
설치
curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh
Claude Code 연동
rtk init -g
이 명령 하나로 Claude Code와 자동으로 연동됩니다. 설정 후 재시작이 필요합니다.
절감 현황 확인
rtk gain
rtk gain --graph
rtk discover
화면 설계 팁
Claude Code를 활용하면 Figma 디자인을 코드로 변환하거나, Pencil 앱에서 직접 AI 기반 UI 설계를 할 수 있습니다.
Figma + MCP 연동
Figma MCP를 연동하면 Figma에서 설계한 화면을 Claude Code가 직접 읽어서 코드로 변환할 수 있습니다.
Step 1: MCP 서버 추가
claude mcp add --transport http figma-remote-mcp https://mcp.figma.com/mcp
Step 2: 인증
명령 실행 후 브라우저가 열리면 Figma 계정으로 로그인하여 접근 권한을 승인합니다. 올바른 Figma 계정으로 로그인되어 있는지 확인하세요.
Step 3: 사용법
Figma에서 원하는 프레임/페이지의 URL을 복사한 뒤, Claude Code 프롬프트에 붙여넣으면 됩니다.
이 Figma 디자인을 React 컴포넌트로 만들어줘 [Figma URL 붙여넣기]
이 화면 설계를 참고해서 Vue 페이지를 구현해줘 [Figma URL 붙여넣기]
Figma URL은 프레임 단위로 공유하면 더 정확한 결과를 얻을 수 있습니다. 전체 파일 URL보다 특정 프레임을 선택한 뒤 'Copy link to selection'으로 복사하세요.
Pencil — AI 네이티브 디자인 도구
Pencil은 AI 네이티브 디자인 도구로, 데스크톱 앱 안에 Claude Code가 내장되어 있습니다. 자연어로 UI를 설계하고 바로 코드로 변환할 수 있습니다.
- 데스크톱 앱 안에 Claude Code가 내장되어 있어 별도 설정 없이 바로 사용 가능합니다.
- 캔버스에서 자연어로 UI를 설계하면 .pen 파일로 저장됩니다.
- MCP를 통해 외부 Claude Code CLI에서도 .pen 파일을 읽고 수정할 수 있습니다.
- 최대 6개 AI 에이전트가 동시에 디자인 방향을 제안합니다.
- 무료로 사용 가능합니다.
설치
Pencil 공식 사이트에서 데스크톱 앱을 다운로드하여 설치합니다. 설치 후 Claude Code 계정으로 로그인하면 바로 사용할 수 있습니다.
대시보드 메인 화면을 설계해줘. 차트 3개와 통계 카드 4개를 배치해줘
로그인 페이지를 모던한 스타일로 디자인해줘
터미널 Alias 및 실행 모드
Alias 설정
터미널에서 짧은 명령으로 Claude Code를 실행할 수 있도록 alias를 설정합니다. Claude Code에게 다음과 같이 요청하면 자동으로 설정됩니다.
터미널에 다음 alias를 만들어줘:
cc: claude (기본 실행)
ccd: claude --dangerously-skip-permissions (바이패스 모드)
ccr: claude --resume --dangerously-skip-permissions (이전 세션 재개 + 바이패스)
또는 직접 ~/.bashrc / ~/.zshrc에 추가할 수 있습니다.
alias cc='claude'
alias ccd='claude --dangerously-skip-permissions'
alias ccr='claude --resume --dangerously-skip-permissions'
사용 예시
cd your-project
cc # 기본 모드
ccd # 바이패스 모드
ccr # 이전 세션 이어서 + 바이패스
모드 비교
| 항목 | 기본 모드 (cc) | 바이패스 모드 (ccd) |
|---|---|---|
| 파일 읽기/쓰기 | 매번 확인 | 자동 허용 |
| 셸 명령 실행 | 매번 확인 | 자동 허용 |
| 작업 속도 | 느림 | 빠름 |
| 안전성 | 최대 | 권한 설정으로 보호 |
바이패스 모드에서도 권한 설정을 통해 위험한 작업을 차단할 수 있습니다. 아래 JSON을 복사한 뒤 Claude Code에게 다음과 같이 요청하면 자동으로 설정됩니다:
settings.json에 다음 permissions 설정을 적용해줘:
(위 JSON 붙여넣기)
{
"permissions": {
"allow": [
"AskUserQuestion",
"BashOutput",
"Edit",
"Glob",
"Grep",
"KillShell",
"MultiEdit",
"NotebookEdit",
"Read",
"Skill",
"Task",
"TaskCreate",
"TaskGet",
"TaskList",
"TaskUpdate",
"TodoWrite",
"WebFetch",
"WebSearch",
"Write",
"mcp__context7__get-library-docs",
"mcp__context7__resolve-library-id",
"mcp__sequential-thinking__*",
"mcp__stitch__*",
"Bash(git status:*)",
"Bash(git log:*)",
"Bash(git diff:*)",
"Bash(git show:*)",
"Bash(git blame:*)",
"Bash(git branch:*)",
"Bash(git remote:*)",
"Bash(git config:*)",
"Bash(git tag:*)",
"Bash(git add:*)",
"Bash(git commit:*)",
"Bash(git push:*)",
"Bash(git pull:*)",
"Bash(git fetch:*)",
"Bash(git checkout:*)",
"Bash(git switch:*)",
"Bash(git stash:*)",
"Bash(git merge:*)",
"Bash(git revert:*)",
"Bash(gh issue:*)",
"Bash(gh pr:*)",
"Bash(gh repo view:*)",
"Bash(ls:*)",
"Bash(cat:*)",
"Bash(less:*)",
"Bash(head:*)",
"Bash(tail:*)",
"Bash(grep:*)",
"Bash(find:*)",
"Bash(tree:*)",
"Bash(pwd:*)",
"Bash(wc:*)",
"Bash(diff:*)",
"Bash(comm:*)",
"Bash(sort:*)",
"Bash(uniq:*)",
"Bash(cut:*)",
"Bash(awk:*)",
"Bash(sed:*)",
"Bash(basename:*)",
"Bash(dirname:*)",
"Bash(realpath:*)",
"Bash(readlink:*)",
"Bash(cp:*)",
"Bash(mv:*)",
"Bash(mkdir:*)",
"Bash(touch:*)",
"Bash(rsync:*)",
"Bash(curl:*)",
"Bash(jq:*)",
"Bash(yq:*)",
"Bash(python:*)",
"Bash(python3:*)",
"Bash(node*)",
"Bash(npm*)",
"Bash(npx*)",
"Bash(bun*)",
"Bash(pnpm*)",
"Bash(yarn*)",
"Bash(uv*)",
"Bash(pip*)",
"Bash(pip3*)",
"Bash(black:*)",
"Bash(ruff:*)",
"Bash(pylint:*)",
"Bash(flake8:*)",
"Bash(mypy:*)",
"Bash(eslint:*)",
"Bash(prettier:*)",
"Bash(pytest:*)",
"Bash(coverage:*)",
"Bash(make:*)",
"Bash(ast-grep:*)",
"Bash(sg:*)",
"Bash(rg:*)",
"Bash(echo:*)",
"Bash(printf:*)",
"Bash(test:*)",
"Bash(true:*)",
"Bash(false:*)",
"Bash(which:*)",
"Bash(type:*)",
"Bash(man:*)",
"Bash(pydoc:*)",
"Bash(lsof:*)",
"Bash(time:*)",
"Bash(xargs:*)",
"Bash(dir:*)",
"Bash(cd:*)",
"Bash(cd /d:*)",
"Bash(findstr:*)",
"Bash(git:*)",
"Bash(cmd /c:*)",
"Bash(powershell:*)"
],
"deny": [
"Bash(rm -rf /:*)",
"Bash(rm -rf /:)",
"Bash(rm -rf ~:*)",
"Bash(rm -rf ~/:)",
"Bash(rm -rf C\\:/:*)",
"Bash(rm -rf C\\:/:)",
"Bash(del /S /Q C\\:/:*)",
"Bash(rmdir /S /Q C\\:/:*)",
"Bash(Remove-Item -Recurse -Force C\\:/:*)",
"Bash(Clear-Disk:*)",
"Bash(Format-Volume:*)",
"Bash(git push --force:*)",
"Bash(git push -f:*)",
"Bash(git push --force-with-lease:*)",
"Bash(git reset --hard:*)",
"Bash(git clean -fd:*)",
"Bash(git clean -fdx:*)",
"Bash(git rebase -i:*)",
"Bash(format:*)",
"Bash(chmod -R 777:*)",
"Bash(chmod 777:*)",
"Bash(dd:*)",
"Bash(mkfs:*)",
"Bash(fdisk:*)",
"Bash(reboot:*)",
"Bash(shutdown:*)",
"Bash(init:*)",
"Bash(systemctl:*)",
"Bash(kill -9:*)",
"Bash(killall:*)",
"Bash(DROP DATABASE:*)",
"Bash(DROP TABLE:*)",
"Bash(TRUNCATE:*)",
"Bash(DELETE FROM:*)"
],
"ask": [
"Bash(rm:*)",
"Bash(sudo:*)",
"Bash(chmod:*)",
"Bash(chown:*)",
"Read(./.env)",
"Read(./.env.*)"
],
"defaultMode": "default"
}
}
권한 3단계
| 레벨 | 동작 | 예시 |
|---|---|---|
| allow | 자동 허용 | git, ls, npm, 파일 읽기/쓰기 등 |
| deny | 완전 차단 | rm -rf /, git push --force, DROP DATABASE 등 |
| ask | 사용자 확인 | rm, sudo, .env 읽기 |
보호 범위
시스템 파괴 방지 — rm -rf /, format, shutdown 차단
Git 안전 — push --force, reset --hard 차단
DB 보호 — DROP DATABASE, TRUNCATE 차단
삭제 확인 — rm은 항상 사용자에게 물어봄
환경변수 보호 — .env 읽기 시 확인
터미널 프로그램 추천 (WezTerm)
WezTerm 같은 모던 터미널 앱을 사용하면 Claude Code 작업 환경을 더 쾌적하게 만들 수 있습니다. 터미널 커스터마이징도 Claude에게 자연어로 요청하면 됩니다.
WezTerm 터미널 배경색을 어두운 네이비로 바꿔줘
WezTerm 터미널 폰트를 JetBrains Mono로 변경하고 크기를 14px로 설정해줘
WezTerm 터미널에서 현재 탭 이름을 프로젝트명으로 바꿔줘
WezTerm 터미널 테마를 커스텀으로 만들어줘. 배경은 #1a1b26, 텍스트는 #c0caf5 으로
터미널 설정뿐 아니라, VS Code 테마, Git 설정, Shell 프로필 등 개발 환경 전반을 Claude에게 자연어로 요청하여 커스터마이징할 수 있습니다. 설정 파일 위치를 몰라도 Claude가 알아서 찾아서 수정해줍니다.
사업부 플러그인 (선택 사항)
아래 플러그인은 GX사업부 내부에서 개발한 플러그인입니다. 사업부 프로젝트에 참여하는 경우 설치를 권장하지만, Claude Code 기본 사용에는 필수가 아닙니다.
SEF-2026 vs oh-my-gx — 어떤 걸 설치해야 하나요?
두 플러그인은 동일한 개발 자동화 목적을 가지지만, 적용 범위와 토큰 소모 방식이 다릅니다.
| 구분 | SEF-2026 (공통프레임워크) | oh-my-gx |
|---|---|---|
| 적용 범위 | 공공 Java/Spring + Nuxt 프로젝트 전용 | 모든 언어, 모든 프레임워크 |
| dev 파이프라인 | 에이전트별 reference 파일을 §번호 기반으로 최소한만 읽어 토큰 절약 | 각 에이전트가 독립적으로 파일을 읽어 더 정교한 결과 도출 |
| 토큰 소모 | 적음 (3계층 reference 로딩으로 87% 절약) | 많음 (정밀 분석을 위해 더 많은 컨텍스트 사용) |
| 추천 구독 | Pro / Max 모두 사용 가능 | Max 구독자 추천 (토큰 소모가 크므로) |
| 주요 대상 | 공공/SI 프로젝트 개발자 | 모든 프로젝트 개발자 |
oh-my-gx는 SEF-2026의 범용 버전으로, 특정 언어나 프레임워크에 종속되지 않습니다. 토큰 소모는 더 크지만 그만큼 각 에이전트가 더 정교하게 분석하여 높은 품질의 결과를 도출합니다.
SEF-2026 — 공통프레임워크
GitHub ↗공공/민간 서비스 개발을 위한 공통프레임워크 플러그인입니다. 자연어 한 마디로 PRD부터 PR까지 에이전트 팀이 자동 처리하며, 공공(eGovFrame+MyBatis)과 민간(JPA+Redis) 환경을 자동 감지하여 적절한 boilerplate를 생성합니다.
이 플러그인은 공공 Java/Spring 프로젝트 및 Nuxt 프론트엔드 프로젝트 전용입니다. 다른 언어나 프레임워크를 사용하는 프로젝트에서는 oh-my-gx를 사용해 주세요.
설치
/plugin marketplace add sqi-energy/sqisoft-sef-2026-plugin
/plugin install sef-2026@sqisoft-sef-2026
초기 설정
/sef-setup
개발 사이클
| 스킬 | 설명 |
|---|---|
| sef-dev | PRD → 설계 → 구현 → 리뷰 → PR 전체 6 Phase 오케스트레이터 |
| sef-commit | 브랜치 타입 기반 한국어 커밋 + 민감파일 감지 |
| sef-pull-request | 커밋 히스토리 분석 PR 자동 생성 |
코드 생성 및 분석
| 스킬 | 설명 |
|---|---|
| sef-backend-builder | 공공(MyBatis)/민간(JPA) 백엔드 boilerplate 즉시 생성 |
| sef-frontend-builder | Nuxt 4 + shadcn-vue 컴포넌트 생성 |
| sef-context | 도메인 컨텍스트 관리 (스캔/Q&A/문서 기반) |
| sef-lens | 코드에서 비즈니스 정책 탐지 → 영향도 보고서 |
| sef-verify | SEF-2026 패턴 검증 + reference 문서 동기화 |
인프라 및 기타
| 스킬 | 설명 |
|---|---|
| sef-db-schema-query | PostgreSQL/MySQL/Oracle 스키마 단계적 탐색 |
| sef-research | 웹 검색 + 문서 분석 리서치 |
| sef-humanizer | AI 글쓰기 40+ 패턴 감지 및 교정 |
3가지 개발 모드
| 모드 | 트리거 | 설명 |
|---|---|---|
| NORMAL | /sef-dev 대시보드 기능 개발해줘 | 전체 6 Phase (PRD→설계→구현→리뷰→PR) |
| HOTFIX | /sef-dev 로그인 버그 긴급 수정해줘 | 경량 PRD → 구현 → PR |
| IMPLEMENT | /sef-dev 구현만 해줘 | 구현 → PR |
프롬프트 예시
/sef-dev 대시보드 기능 개발해줘
→ 6 Phase가 자동 진행되며, 각 단계마다 사용자 승인을 받습니다.
/sef-backend-builder 공지사항 API
→ sector 설정에 따라 공공/민간 boilerplate를 자동 생성합니다.
/sef-dev 로그인 버그 긴급 수정해줘
→ HOTFIX 모드로 경량 PRD 후 바로 구현 → PR을 생성합니다.
공통프레임워크 플러그인의 상세 사용 가이드와 프롬프트 예시집입니다.
PRD 작성부터 설계, 구현, 리뷰, PR 생성까지 전체 개발 사이클을 에이전트 팀이 자동으로 처리하는 개발 자동화 플러그인입니다.
oh-my-gx는 SEF-2026(공통프레임워크)의 범용 버전입니다. 특정 언어나 프레임워크에 종속되지 않아 어떤 프로젝트에서든 사용할 수 있습니다. dev 파이프라인에서 각 에이전트가 독립적으로 파일을 분석하므로 토큰 소모가 크지만, 그만큼 더 정교한 결과를 도출합니다. Claude Max 구독자에게 추천합니다.
설치
/plugin marketplace add bs-koo/oh-my-gx
/plugin install oh-my-gx@oh-my-gx
재시작 후 초기 설정
/oh-my-gx:setup
주요 스킬
| 스킬 | 설명 |
|---|---|
| gx-dev | PRD → 설계 → 구현 → 리뷰 → PR 전체 사이클 |
| gx-context | 기획서/코드에서 도메인 컨텍스트 생성 |
| gx-lens | 코드에서 비즈니스 정책 탐지 및 영향도 분석 |
| gx-research | 웹 검색 + 문서 분석 리서치 |
| gx-commit | 브랜치 타입 기반 한국어 커밋 |
| gx-pull-request | 커밋 히스토리 분석 PR 자동 생성 |
| gx-humanizer | AI 글쓰기 패턴 감지 및 교정 |
프롬프트 예시
/gx-dev 대시보드 기능 개발해줘
→ 전체 개발 사이클이 자동으로 진행됩니다.
기획서 보고 context 만들어줘
→ 기획 문서에서 도메인 컨텍스트를 자동 추출합니다.
gx-pm — 프로젝트 산출물 관리
GitHub ↗공공/SI 프로젝트의 산출물을 자동으로 생성하고 관리하는 PM 전용 플러그인입니다. 요구사항정의서부터 테스트계획서, 감리대응까지 산출물명만 말하면 자동 생성됩니다.
설치
/plugin marketplace add bs-koo/gx-pm
/plugin install gx-pm@gx-pm
초기 설정
/프로젝트설정
주요 스킬
| 스킬 | 설명 |
|---|---|
| /요구사항정의서 | RFP/과업지시서에서 요구사항 추출 및 분류 |
| /화면목록표 | 요구사항 기반 화면 식별 및 ID 부여 |
| /프로그램정의서 | 화면목록 기반 프로그램 목록 및 소스파일 매핑 |
| /테이블정의서 | DDL → 테이블정의서 변환 또는 ERD 설계 |
| /단위테스트계획서 | 화면 유형별 검사기준 자동 매핑 |
| /통합테스트시나리오 | E2E 업무 흐름 시나리오 자동 작성 |
| /추적매트릭스 | 요구사항↔화면↔프로그램↔테스트 양방향 추적 |
| /감리대응 | 감리 지적사항 분석 및 대응 문서 생성 |
| /테스트결과서 | 단위/통합/인수 테스트 결과서 생성 |
프롬프트 예시
/요구사항정의서
→ RFP에서 요구사항을 자동으로 추출하여 정의서를 생성합니다.
/추적매트릭스
→ 요구사항부터 테스트까지 전체 ID 체인을 추적하고 누락을 탐지합니다.