VibeWise: AI가 코딩하는 동안 설계와 판단을 배우게 하는 플러그인
AI가 코드를 쓰는 동안 사용자가 설계와 판단을 배우도록 돕는 Claude Code·Codex 플러그인이에요. 원하는 기능을 말하면 바로 전부 자동 구현하기보다 접근 방법과 선택의 이유를 묻고, 합의한 범위의 코드를 작성한 뒤 변경 내용을 설명하는 학습형 작업 흐름을 제공해요.
주요 기능
설계에 직접 참여하는 개발 학습
사용자의 접근 방법을 먼저 듣고 개념·트레이드오프·실패 조건을 함께 살펴봅니다. 초급·중급·고급에 따라 설명 깊이를 조절하며, 작은 구조 그림을 통해 관계를 설명하도록 구성되어 있어요. 학습 효과가 입증된 교육 평가 결과를 의미하지는 않습니다.
설계 확인과 실제 구현을 구분
Build는 문제 접근을 논의하고, Design은 설계를 확인하며, Implementation은 구체적인 코드 변경을 승인하는 단계예요. 별도 설계 확인을 생략하고 구현 단계에서 함께 확인할 수도 있어요. 구현 후 변경 이유·검사 결과를 설명하도록 지시해요.
프로젝트별 학습 기록과 재개
프로필·학습 진행·프로젝트 지도를 .vibe-wise/에 저장해요. Claude Code의 시작·압축 후 hook은 해당 기록을 다시 읽도록 안내하고, Codex는 사용자가 learn을 다시 호출해 재개해요. 확인 후 초기화할 때는 기존 노트를 backups/에 보존하는 코드가 있어요.
구조
독립 AI 모델이나 웹서비스가 아니라 Markdown 기반 learn/reset 스킬, 플러그인 manifest와 소규모 Python 보조 코드의 조합이에요. Claude Code의 SessionStart hook은 로컬 프로젝트의 활성 학습 상태를 찾아 읽을 파일을 모델에 안내해요. Codex manifest에는 hook이 비어 있어 같은 자동 복원 경로를 제공하지 않습니다. 두 도구는 동일한 .vibe-wise/ 기록 형식을 사용해요.
누구에게 쓸모 있나요
- AI에게 개발을 맡기면서도 구조·설계 이유를 배우려는 입문자, 주니어 개발자, 새로운 기술을 익히는 개발자에게 적합해요.
- 대표님에게는 Codex·Claude Code가 만든 프로그램을 이해하는 별도 학습 시간에 활용할 수 있어요. 질문과 설계 참여를 중시하므로 중단 없이 자동 개발을 끝내는 작업과는 목적이 달라요.
설치 전 준비
- 확인한 Claude/Codex 플러그인 manifest의 소스 버전은 모두 0.1.44예요. 소스 버전과 실제 설치 채널 배포 버전의 일치는 별도 확인해야 해요.
- 최신 Claude Code 또는 Codex와 Python 3가 필요하다고 공식 README가 안내해요. 추가 Python 패키지는 필요하지 않습니다.
- Claude Code는 문맥 복원·초기화에 Python을 쓰고, Codex는 초기화에만 사용해요. hooks.json은 python3 명령을 호출하므로 특히 Windows에서는 해당 명령의 사용 가능 여부를 확인해야 해요.
- 작업 프로젝트 폴더에서 시작해요. Git 저장소이면 저장소 루트, Git이 없으면 시작 폴더가 학습 노트의 기준이에요. 지원되는 최소 도구 버전과 OS별 전체 호환표는 확인한 문서에 명시되어 있지 않습니다.
- Claude Code 플러그인: learn/reset 및 Python SessionStart hook
- Codex 플러그인: learn/reset, 매 세션 명시적 재개
- 프로젝트 로컬 Markdown 노트 · 별도 서버 불필요
설치 방법
Claude Code: 공식 문서의 디렉터리 설치
README가 안내하는 경로예요. 설치 범위를 선택·확인한 뒤 프로젝트에서 Claude Code를 재시작해요. 이 자료 조사에서는 설치나 디렉터리의 실제 배포 상태를 시험하지 않았어요.
/plugin install vibe-wise@anthropic-plugin-directoryClaude Code: GitHub 경로는 대안 하나만 선택
Anthropic Directory를 사용할 수 없을 때 문서가 제시하는 대안이에요. 두 명령은 차례로 실행하며 디렉터리 설치와 중복 설치할 필요가 없어요. 타사 marketplace의 자동 업데이트는 별도 선택이에요.
/plugin marketplace add nykooi1/vibe-wise
/plugin install vibe-wise@vibe-wiseCodex: marketplace 추가 후 플러그인 설치
공식 저장소의 안내 명령이며 실행하지 않았어요. 현재 설치된 Codex에서 해당 plugin 명령을 지원하는지 확인하고, 완료 후 프로젝트에서 새 세션을 시작해요.
codex plugin marketplace add nykooi1/vibe-wise
codex plugin add vibe-wise@vibe-wise사용 방법
학습 모드 시작
프로젝트에서 호출하고 경험 수준·학습 목표·질문 빈도를 선택해요. 기존 저장소라면 먼저 코드와 작은 시스템 지도를 살펴보는 흐름이에요. 설치만으로 모든 저장소에서 자동 활성화되는 것은 아니에요.
Claude Code: /vibe-wise:learn
Codex: $vibe-wise:learn한국어로 학습 범위를 구체화
예: “이 프로젝트 구조를 한국어로 설명하며 함께 설계하고 싶습니다. 초급 수준으로, 중요한 결정만 질문해 주세요.” 설명·질문 빈도를 조정하거나 이번 단계만 구현, 학습 일시 중단을 요청할 수 있어요. 한국어 학습 품질은 실제 시험하지 않았어요.
Codex에서는 세션마다 재개
새 Codex 세션 또는 학습 문맥을 놓친 상황에서 다시 호출해요. 저장 노트로 재개하며 반복 초기 설정을 피하도록 설계됐어요. README의 일반적인 세션 복원 설명을 Codex 자동 hook 지원으로 해석하면 안 돼요.
$vibe-wise:learn기록 보호와 선택적 초기화
초기화 전 대상 프로젝트를 확인하고 취소/초기화를 선택해요. 코드는 세 학습 파일을 백업한 뒤 새 상태로 바꿉니다. 선호도 변경만 필요하면 초기화 없이 말로 요청해요. .vibe-wise/를 Git에서 제외하려면 사용자가 .gitignore에 추가해야 하며 플러그인은 이를 몰래 수정하지 않는다고 안내해요.
Claude Code: /vibe-wise:reset
Codex: $vibe-wise:reset비용과 API 키
확인한 저장소는 MIT 공개 코드이며 별도 VibeWise 유료 요금은 확인되지 않았어요. Claude Code·Codex 이용에 필요한 구독/API 조건과 사용량은 별도예요. 설명과 문답이 늘면 AI 이용량과 작업 시간이 증가할 수 있으며 무료 또는 무제한 실행을 보장하지 않습니다.
라이선스
루트 LICENSE는 MIT, 저작권 표기는 2026 Noah Kim예요. 사용·수정·배포 및 상업적 활용을 허용하되 저작권·허가 고지를 유지해야 하며 보증은 없어요. 사용하는 AI 서비스와 프로젝트 자체의 권리·약관은 별도예요.
주의사항과 알려진 이슈
- 체크포인트는 AI의 작업 지침이지 OS 권한 차단이나 보안 샌드박스가 아니에요. 실제 도구 권한과 변경 검토·테스트를 대신하지 않습니다.
- README는 별도 계정·백엔드·텔레메트리가 없다고 설명하지만 저장 노트는 AI 문맥에 포함돼요. 코드·학습 기록의 외부 처리는 기존 Claude Code/Codex 데이터 설정에 따르므로 기밀·인증 정보를 노트에 넣지 마세요.
- 프로젝트 노트가 Git에 포함되면 공유될 수 있어요. .gitignore와 실제 추적 상태를 직접 확인해야 해요. 이미 커밋된 파일은 ignore 추가만으로 과거 이력이 사라지지 않습니다.
- 일반 자동 개발보다 설계 질문과 확인 과정이 많습니다. 시간 우선 작업에서는 학습 중단·질문 빈도 축소 등 사용 범위를 명확히 나누는 편이 적합해요.
- AI의 설명과 생성 코드는 틀릴 수 있어요. 이 자료에서는 실제 설치, 한국어 대화, 세션 복원, 초기화, OS별 동작, 교육 효과나 보안을 실행 검증하지 않았어요.
확인 범위
확인 날짜: 2026-10-30
확인 커밋: eefb53df406ab89e31444684ff32c1df205221f8
확인한 범위: 2026-10-30 22:33 KST에 공식 main 커밋, README, MIT LICENSE, Claude/Codex manifest, SessionStart hook, learn 지침·Codex 차이, reset 코드 일부를 정적으로 확인했어요.
확인 한계: 플러그인·Python 스크립트 설치/실행, marketplace 등록, AI 호출, 사용자 프로젝트 수정은 하지 않았어요. 전체 코드 감사·공개 이슈 전수 검토·최소 지원 버전 확인은 아니며 실제 서비스 채널의 설치 성공과 학습 효과를 보장하지 않습니다.