공식 설치 & 사용 가이드

Claude Code CLI
가이드

설치부터 플러그인, 토큰 최적화까지 — Windows 기준

🪟 Windows ⬡ Claude Code ✦ oh-my-claudecode ⚡ RTK
01

설치 전 확인

🔑
Claude Pro 이상 구독이 필요합니다

Claude Code는 무료 플랜에서는 사용할 수 없습니다.
Claude Pro, Max, Team, Enterprise 또는 Anthropic Console 계정이 필요합니다.

구독 확인하기 → claude.com/pricing

📋  추가 요구사항 — Windows 10 이상, Git for Windows 설치 필요

02

Claude Code 설치

PowerShell

powershell
irm https://claude.ai/install.ps1 | iex

CMD

batch
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
powershell
winget install Anthropic.ClaudeCode
⚠️
Deprecated npm을 통한 설치 방식은 더 이상 권장되지 않습니다. Native Install 방식을 사용하는 것을 강력히 권장합니다.
bash
npm install -g @anthropic-ai/claude-code

설치 확인

bash
claude --version
claude doctor

첫 실행

bash
cd your-project
claude
ℹ️

첫 실행 시 브라우저가 자동으로 열리며 Claude 계정으로 로그인해야 합니다. 로그인 후 터미널로 돌아오면 Claude Code가 시작됩니다.

03

슬래시 명령어

Claude Code 세션 내에서 /로 시작하는 명령어를 사용하여 설정을 변경하거나 다양한 기능을 활성화할 수 있습니다.

명령어 설명
/help사용 가능한 모든 명령어 표시
/config설정 변경 (인터랙티브). Auto-compact 등 자동화 설정도 여기서 관리
/compact대화 내용을 압축하여 컨텍스트 확보. 압축 시 이전 맥락이 요약되므로 세부 내용이 일부 손실될 수 있음에 주의
/allowed-tools도구 권한 관리
/hooksHook 설정 관리
/mcpMCP 서버 관리
/agents서브에이전트 관리
/clear대화 초기화 (컨텍스트 리셋)
/model모델 및 성능 설정 변경
/usage현재 세션 토큰 사용량 확인
/plugin플러그인 관리 화면 (설치, 업데이트, 제거)

플러그인 관리

Claude Code에서 /plugin을 입력하면 플러그인 관리 화면이 열립니다. 상단 탭으로 이동하며 모든 작업을 UI에서 처리할 수 있습니다.

기능
Plugins 설치된 플러그인 목록 확인
Discover 새로운 플러그인 탐색
Installed 설치된 플러그인 관리 (제거 등)
Marketplaces 마켓플레이스 관리 (추가/업데이트/제거)
Errors 플러그인 오류 확인

플러그인 업데이트 방법:

  1. /plugin 입력하여 관리 화면 열기
  2. 상단에서 Marketplaces 탭 선택
  3. 업데이트할 플러그인의 마켓플레이스 선택
  4. Update marketplace 선택
  5. Claude Code 재시작

플러그인 설치 흐름:

  1. 마켓플레이스 추가: /plugin marketplace add [저장소]
  2. /pluginMarketplaces 탭 → 플러그인 선택 → 설치
  3. Claude Code 재시작
  4. 초기 설정 실행 (플러그인에 따라 다름)

Context Window란?

Claude가 한 번의 대화에서 기억할 수 있는 텍스트의 최대 용량. 대화가 길어지면 컨텍스트가 가득 차서 이전 내용을 잊게 됩니다.

  • /compact 명령으로 현재까지의 대화를 압축하여 공간을 확보할 수 있습니다
  • 단, 압축 시 세부적인 맥락이나 코드 디테일이 일부 손실될 수 있으므로, 중요한 작업 중에는 주의가 필요합니다
  • /config에서 Auto-compact를 활성화하면, 컨텍스트가 일정 수준 이상 차면 자동으로 압축됩니다
  • Auto-compact가 동작하면 Claude가 자동으로 대화를 요약하여 공간을 확보하지만, 이전에 논의한 세부사항을 참고해야 할 경우 다시 알려줘야 할 수 있습니다
💡

복잡한 작업 중 컨텍스트가 부족해지면 /compact 후 핵심 맥락을 다시 알려주는 것이 가장 안전하다

/model 상세 설명

/model — 모델 및 Effort 설정

/model 명령으로 사용 중인 모델을 변경하거나, effort(추론 강도)를 설정할 수 있습니다.

설정설명
모델 선택Opus, Sonnet, Haiku 등 원하는 모델로 전환
auto (기본)Claude가 작업 복잡도에 따라 자동 판단
low빠른 응답, 간단한 작업에서 토큰 절약
high깊은 추론, 복잡한 디버깅 및 아키텍처 설계에 적합
💡

Effort를 낮추면 간단한 작업에서 응답 속도가 빨라지고 토큰을 절약할 수 있습니다. 복잡한 디버깅이나 아키텍처 설계 시에는 high로 설정하면 더 정확한 결과를 얻을 수 있습니다.

04

키보드 단축키 & 모드 전환

단축키기능
Shift+Tab 모드 전환 — 바이패스 모드 / 플랜 모드 / 기본 모드 순환
Alt+V 이미지(스크린샷) 붙여넣기 — 캡처한 화면을 Claude에게 바로 전달

모드 전환 (Shift+Tab)

Claude Code 세션 중 Shift+Tab을 누르면 실행 모드가 순환됩니다.

모드동작
기본 모드 모든 작업에 사용자 승인 필요
바이패스 모드 (Auto-accept) 파일 수정, 명령 실행을 자동 승인
플랜 모드 코드 수정 없이 계획만 수립 (실행 전 리뷰용)

이미지 붙여넣기 (Alt+V)

스크린샷이나 이미지를 클립보드에 복사한 후 Alt+V로 Claude에게 바로 전달할 수 있습니다. 에러 화면, UI 스크린샷, 디자인 시안 등을 보여주며 질문할 때 유용합니다.

05

Thinking 모드 설정

⌨️
Alt+T — 토글 단축키

Alt+T로 Thinking 모드를 켜고 끌 수 있습니다

On/Off 차이점

모드설명
Thinking Off빠른 응답, 간단한 작업에 적합. 토큰 소비 적음
Thinking On응답 전 '생각하는 과정'을 거침. 복잡한 문제에 더 정확하지만 토큰을 2–3배 더 소비
💡

간단한 수정은 Off, 복잡한 버그 추적이나 설계는 Thinking On 권장

06

oh-my-claudecode 플러그인

가장 인기 있는 플러그인

oh-my-claudecode (OMC)

oh-my-claudecode(OMC)는 전 세계 Claude Code 사용자들이 가장 많이 사용하는 플러그인으로, 19개 전문 에이전트28개 스킬을 제공하는 멀티 에이전트 오케스트레이션 시스템입니다. Claude Code를 설치했다면 OMC를 기본으로 같이 설치하고 시작하는 것을 강력히 권장합니다.

설치 단계

1
플러그인 마켓플레이스 등록
claude code
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
2
플러그인 설치
claude code
/plugin install oh-my-claudecode
3
Claude Code 재시작
⚠️
반드시 재시작 필요

플러그인 설치 후 반드시 Claude Code를 완전히 종료하고 다시 시작해야 합니다. 재시작하지 않으면 플러그인이 로드되지 않습니다.

4
초기 설정
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에 빠르게 도달할 수 있으므로, 복잡한 대규모 작업에만 선택적으로 사용하는 것을 권장합니다.

claude code
team: 프론트엔드 리팩토링하면서 동시에 API 테스트도 작성해줘

→ 여러 에이전트가 동시에 작업을 분담하여 병렬로 처리합니다.

주요 실행 모드

autopilot

아이디어에서 동작하는 코드까지 자율 실행

ralph

아키텍트 검증 포함 지속 루프

ulw (ultrawork)

최대 병렬 실행

plan

인터뷰 기반 전략 계획

deep-interview

소크라테스식 요구사항 명확화

team

조율된 에이전트 팀

19개 에이전트 (3 도메인)

빌드 / 분석

Explore Analyst Planner Architect Debugger Executor Code-Simplifier

리뷰 / 품질

Security-Reviewer Code-Reviewer Critic

도메인 전문가

Document-Specialist Test-Engineer Designer Writer QA-Tester Scientist Git-Master Tracer

실전 사용법 — 자연어로 말하면 알아서 동작합니다

OMC의 가장 큰 장점은 별도의 명령어를 외울 필요가 없다는 것입니다. 평소처럼 자연어로 요청하면, OMC가 자동으로 적절한 에이전트와 스킬을 선택하여 실행합니다. 아래는 실제로 자주 사용하는 프롬프트 예시입니다.

claude code
이 프로젝트 코드베이스를 분석해줘

→ Explore 에이전트가 자동으로 프로젝트 구조를 스캔하고, 주요 파일과 아키텍처를 파악하여 보고합니다.

claude code
이 코드 리뷰해줘

→ Code-Reviewer 에이전트가 코드 품질, 버그 가능성, 개선점을 분석합니다.

claude code
이 버그 원인을 찾아줘

→ Debugger 에이전트가 스택 트레이스를 분석하고 근본 원인을 추적합니다.

claude code
보안 취약점 검사해줘

→ Security-Reviewer 에이전트가 OWASP Top 10 기준으로 코드를 점검합니다.

claude code
테스트 코드 작성해줘

→ Test-Engineer 에이전트가 테스트 전략을 수립하고 테스트 코드를 생성합니다.

claude code
autopilot: 로그인 기능을 만들어줘

→ autopilot 모드가 활성화되어, 설계부터 구현, 테스트까지 자율적으로 진행합니다. 여러 에이전트가 순차적으로 협업합니다.

claude code
plan: 결제 시스템 리팩토링 계획을 세워줘

→ Planner + Architect 에이전트가 인터뷰 기반으로 요구사항을 파악하고 단계별 실행 계획을 수립합니다.

claude code
이 프로젝트의 README를 작성해줘

→ Writer 에이전트가 프로젝트 구조를 파악한 뒤 문서를 자동 생성합니다.

핵심 포인트

OMC를 설치한 뒤에는 평소와 똑같이 Claude Code를 사용하면 됩니다. 복잡한 작업일수록 OMC의 멀티 에이전트가 자동으로 협업하여 더 나은 결과를 만들어냅니다. 특별한 명령어를 외울 필요 없이, 하고 싶은 일을 자연어로 말하면 됩니다.

07

HUD 설정

OMC HUD는 터미널 하단에 실시간 상태 바를 표시하여 컨텍스트 사용량, 에이전트 상태, 작업 진행도를 한눈에 확인할 수 있습니다.

설정

claude code
/oh-my-claudecode:hud setup
ℹ️

설정 후 Claude Code 재시작 필요

프리셋 변경

claude code
/oh-my-claudecode:hud minimal    # 최소 표시
/oh-my-claudecode:hud focused    # 기본값 (권장)
/oh-my-claudecode:hud full       # 전체 표시

프리셋 미리보기

minimal [OMC] · ralph · ultrawork · todos:2/5
focused ★ repo:name · branch:main · ctx:67% · agents:2 · todos:2/5
full focused + 에이전트별 상세 트리 표시

HUD 표시 요소

요소설명
[OMC]OMC 모드 식별자
repo:name리포지토리 이름
branch:namegit 브랜치
ctx:67%컨텍스트 사용률 — 초록(정상) → 노랑(70%+) → 빨강(85%+)
agents:2활성 서브에이전트 수
todos:2/5TODO 진행률

문제 해결

claude code
/oh-my-claudecode:omc-doctor
08

RTK — 토큰 절약

RTK (Rust Token Killer)

RTK는 Claude Code의 CLI 출력을 압축하여 평균 60~90%의 토큰을 절약하는 도구입니다. git, npm, tsc, vitest 등의 출력을 자동으로 필터링하여 핵심 정보만 전달합니다.

압축 전략 (4가지)

실패 전용

테스트 실패, 에러만 추출. 성공 출력 제거

중복 제거

반복되는 로그 라인을 카운트로 압축

파일별 그룹

에러/경고를 파일별로 그룹화해 가독성 향상

구조 추출

JSON 구조 요약, 핵심 메트릭만 표시

카테고리별 절감율

카테고리주요 명령어절감율
테스트vitest, playwright, cargo test90–99%
빌드next build, tsc, lint, prettier70–87%
Gitstatus, log, diff, add, commit59–80%
GitHub CLIgh pr, gh run, gh issue26–87%
패키지 매니저pnpm, npm, npx70–90%
파일 & 검색ls, grep, find, read60–75%
인프라docker, kubectl85%
네트워크curl, wget65–70%

설치

bash
curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh

Claude Code 연동

bash
rtk init -g
ℹ️

이 명령 하나로 Claude Code와 자동으로 연동됩니다. 설정 후 재시작이 필요합니다.

절감 현황 확인

bash
rtk gain
rtk gain --graph
rtk discover

Claude Code를 활용하면 Figma 디자인을 코드로 변환하거나, Pencil 앱에서 직접 AI 기반 UI 설계를 할 수 있습니다.

Figma + MCP 연동

Figma MCP를 연동하면 Figma에서 설계한 화면을 Claude Code가 직접 읽어서 코드로 변환할 수 있습니다.

Step 1: MCP 서버 추가

bash
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개를 배치해줘
프롬프트
로그인 페이지를 모던한 스타일로 디자인해줘
10

터미널 Alias 및 실행 모드

Alias 설정

터미널에서 짧은 명령으로 Claude Code를 실행할 수 있도록 alias를 설정합니다. Claude Code에게 다음과 같이 요청하면 자동으로 설정됩니다.

프롬프트
터미널에 다음 alias를 만들어줘:
cc: claude (기본 실행)
ccd: claude --dangerously-skip-permissions (바이패스 모드)
ccr: claude --resume --dangerously-skip-permissions (이전 세션 재개 + 바이패스)

또는 직접 ~/.bashrc / ~/.zshrc에 추가할 수 있습니다.

bash
alias cc='claude'
alias ccd='claude --dangerously-skip-permissions'
alias ccr='claude --resume --dangerously-skip-permissions'

사용 예시

bash
cd your-project
cc    # 기본 모드
ccd   # 바이패스 모드
ccr   # 이전 세션 이어서 + 바이패스

모드 비교

항목기본 모드 (cc)바이패스 모드 (ccd)
파일 읽기/쓰기매번 확인자동 허용
셸 명령 실행매번 확인자동 허용
작업 속도느림빠름
안전성최대권한 설정으로 보호
🛡️
바이패스 모드 안전 설정

바이패스 모드에서도 권한 설정을 통해 위험한 작업을 차단할 수 있습니다. 아래 JSON을 복사한 뒤 Claude Code에게 다음과 같이 요청하면 자동으로 설정됩니다:

프롬프트
settings.json에 다음 permissions 설정을 적용해줘:
(위 JSON 붙여넣기)
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 읽기

보호 범위

✓ 시스템 파괴 방지 ✓ Git 안전 ✓ DB 보호 ✓ 삭제 확인 ✓ 환경변수 보호
🔒
상세 보호 내용

시스템 파괴 방지 — rm -rf /, format, shutdown 차단
Git 안전 — push --force, reset --hard 차단
DB 보호 — DROP DATABASE, TRUNCATE 차단
삭제 확인 — rm은 항상 사용자에게 물어봄
환경변수 보호 — .env 읽기 시 확인

11

터미널 프로그램 추천 (WezTerm)

WezTerm 같은 모던 터미널 앱을 사용하면 Claude Code 작업 환경을 더 쾌적하게 만들 수 있습니다. 터미널 커스터마이징도 Claude에게 자연어로 요청하면 됩니다.

프롬프트
WezTerm 터미널 배경색을 어두운 네이비로 바꿔줘
프롬프트
WezTerm 터미널 폰트를 JetBrains Mono로 변경하고 크기를 14px로 설정해줘
프롬프트
WezTerm 터미널에서 현재 탭 이름을 프로젝트명으로 바꿔줘
프롬프트
WezTerm 터미널 테마를 커스텀으로 만들어줘. 배경은 #1a1b26, 텍스트는 #c0caf5 으로
💡
개발 환경 전체를 Claude로 커스터마이징

터미널 설정뿐 아니라, VS Code 테마, Git 설정, Shell 프로필 등 개발 환경 전반을 Claude에게 자연어로 요청하여 커스터마이징할 수 있습니다. 설정 파일 위치를 몰라도 Claude가 알아서 찾아서 수정해줍니다.

12

사업부 플러그인 (선택 사항)

ℹ️

아래 플러그인은 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를 사용해 주세요.

설치

slash command
/plugin marketplace add sqi-energy/sqisoft-sef-2026-plugin
/plugin install sef-2026@sqisoft-sef-2026

초기 설정

slash command
/sef-setup

개발 사이클

스킬설명
sef-devPRD → 설계 → 구현 → 리뷰 → PR 전체 6 Phase 오케스트레이터
sef-commit브랜치 타입 기반 한국어 커밋 + 민감파일 감지
sef-pull-request커밋 히스토리 분석 PR 자동 생성

코드 생성 및 분석

스킬설명
sef-backend-builder공공(MyBatis)/민간(JPA) 백엔드 boilerplate 즉시 생성
sef-frontend-builderNuxt 4 + shadcn-vue 컴포넌트 생성
sef-context도메인 컨텍스트 관리 (스캔/Q&A/문서 기반)
sef-lens코드에서 비즈니스 정책 탐지 → 영향도 보고서
sef-verifySEF-2026 패턴 검증 + reference 문서 동기화

인프라 및 기타

스킬설명
sef-db-schema-queryPostgreSQL/MySQL/Oracle 스키마 단계적 탐색
sef-research웹 검색 + 문서 분석 리서치
sef-humanizerAI 글쓰기 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을 생성합니다.

참고 문서 다운로드

공통프레임워크 플러그인의 상세 사용 가이드와 프롬프트 예시집입니다.

oh-my-gx — 개발 자동화

GitHub ↗ 공식 페이지 ↗

PRD 작성부터 설계, 구현, 리뷰, PR 생성까지 전체 개발 사이클을 에이전트 팀이 자동으로 처리하는 개발 자동화 플러그인입니다.

Max 구독자 추천

oh-my-gx는 SEF-2026(공통프레임워크)의 범용 버전입니다. 특정 언어나 프레임워크에 종속되지 않아 어떤 프로젝트에서든 사용할 수 있습니다. dev 파이프라인에서 각 에이전트가 독립적으로 파일을 분석하므로 토큰 소모가 크지만, 그만큼 더 정교한 결과를 도출합니다. Claude Max 구독자에게 추천합니다.

설치

slash command
/plugin marketplace add bs-koo/oh-my-gx
/plugin install oh-my-gx@oh-my-gx

재시작 후 초기 설정

slash command
/oh-my-gx:setup

주요 스킬

스킬설명
gx-devPRD → 설계 → 구현 → 리뷰 → PR 전체 사이클
gx-context기획서/코드에서 도메인 컨텍스트 생성
gx-lens코드에서 비즈니스 정책 탐지 및 영향도 분석
gx-research웹 검색 + 문서 분석 리서치
gx-commit브랜치 타입 기반 한국어 커밋
gx-pull-request커밋 히스토리 분석 PR 자동 생성
gx-humanizerAI 글쓰기 패턴 감지 및 교정

프롬프트 예시

프롬프트
/gx-dev 대시보드 기능 개발해줘

→ 전체 개발 사이클이 자동으로 진행됩니다.

프롬프트
기획서 보고 context 만들어줘

→ 기획 문서에서 도메인 컨텍스트를 자동 추출합니다.

gx-pm — 프로젝트 산출물 관리

GitHub ↗

공공/SI 프로젝트의 산출물을 자동으로 생성하고 관리하는 PM 전용 플러그인입니다. 요구사항정의서부터 테스트계획서, 감리대응까지 산출물명만 말하면 자동 생성됩니다.

설치

slash command
/plugin marketplace add bs-koo/gx-pm
/plugin install gx-pm@gx-pm

초기 설정

slash command
/프로젝트설정

주요 스킬

스킬설명
/요구사항정의서RFP/과업지시서에서 요구사항 추출 및 분류
/화면목록표요구사항 기반 화면 식별 및 ID 부여
/프로그램정의서화면목록 기반 프로그램 목록 및 소스파일 매핑
/테이블정의서DDL → 테이블정의서 변환 또는 ERD 설계
/단위테스트계획서화면 유형별 검사기준 자동 매핑
/통합테스트시나리오E2E 업무 흐름 시나리오 자동 작성
/추적매트릭스요구사항↔화면↔프로그램↔테스트 양방향 추적
/감리대응감리 지적사항 분석 및 대응 문서 생성
/테스트결과서단위/통합/인수 테스트 결과서 생성

프롬프트 예시

프롬프트
/요구사항정의서

→ RFP에서 요구사항을 자동으로 추출하여 정의서를 생성합니다.

프롬프트
/추적매트릭스

→ 요구사항부터 테스트까지 전체 ID 체인을 추적하고 누락을 탐지합니다.