터미널 없이, VS Code 안에서 바로 코드 리뷰와 블로그 학습 Q&A를 받을 수 있는 확장이에요. CLI 버전인 kodex-code-review-agent와 같은 Gemini API·같은 로직을 쓰지만, 결과를 예쁜 화면(웹뷰 패널)으로 보여줘요. 터미널이 편하면 CLI를, 화면으로 보고 싶으면 이 확장을 쓰면 돼요.
실행해보기 (개발 모드)
VS Code 확장은 아직 마켓플레이스에 배포하지 않았기 때문에, "개발 모드"로 직접 실행해서 테스트해요.
이 폴더(kodex-vscode-extension)를 VS Code로 엽니다.
터미널에서 의존성 설치:
npm install
npm run compile
VS Code 상단 메뉴에서 Run > Start Debugging (또는 F5)을 누릅니다.
→ "Extension Development Host"라는 새 VS Code 창이 뜹니다. 이 창에서만 확장이 동작해요.
새로 뜬 창에서 Cmd + , (설정) 열고 "kodex"로 검색 → Gemini Api Key에 발급받은 키 입력.
아무 코드 파일을 열고 (또는 리뷰받고 싶은 부분만 드래그해서 선택하고) Cmd + Shift + P → "Kodex: 코드 리뷰 실행" 선택.
→ 단축키 Cmd + Alt + R로도 바로 실행돼요.
embeddings.json 위치가 다르면 설정(kodex.embeddingsPath)에서 경로를 바꿀 수 있어요. 질문과 가장 비슷한 글의 유사도가 너무 낮으면(기본 0.5 미만) Gemini를 호출하지 않고 "블로그에 아직 그 내용은 없어요"라고 바로 답해요 — 기준은 설정(kodex.minConfidence)에서 조정할 수 있어요.
오늘 API 사용량 보기
Cmd + Shift + P → "Kodex: 오늘 API 사용량 보기" — 워크스페이스 루트의 usage.json(CLI의 usage.py와 같은 파일)을 읽어서 오늘 몇 번 호출했는지 알림으로 보여줘요.
동작 방식
코드 리뷰: 코드를 드래그해서 선택했으면 선택한 부분만, 선택 안 했으면 파일 전체를 리뷰 대상으로 보내요. kodex-code-review-agent의 review.py와 동일한 프롬프트를 사용해서 항상 "📊 코드 품질 점수 / 🐛 발견된 버그 / 💡 개선 제안 / ✅ 잘한 점" 형식으로 답해요.
블로그 Q&A: 질문을 Gemini 임베딩 API로 벡터화하고, embeddings.json에 저장된 글 조각들과 코사인 유사도를 비교해서 가장 관련 있는 내용을 찾아요. 그 내용을 근거로 Gemini가 답하고, 어떤 글에서 가져왔는지 출처도 같이 보여줘요. kodex-code-review-agent의 ask.py와 같은 구조예요.
사용량 기록: Gemini API를 호출할 때마다(생성/임베딩 각각) 워크스페이스의 usage.json에 오늘 날짜로 카운트를 남겨요. CLI와 같은 워크스페이스에서 쓰면 사용량이 자동으로 합산돼요.
API 키는 VS Code 설정(kodex.geminiApiKey)에 저장돼요. 커밋되는 코드에는 키가 들어가지 않아요.
