코드 리뷰를 VS Code 화면으로 (Day 2)

도로의 이것저것·2026년 7월 24일

AI에이전트

목록 보기

2/15

어제 만든 코드 리뷰 도우미를 오늘은 VS Code안에서 바로 쓸 수 있게 만들었어요. 그 과정에서 겪은 삽질과 추가한 기능, 그리고 저장소를 어떻게 정리했는지까지 오늘 하루를 정리합니다.

오늘 한 일: VS Code 확장 만들기

터미널이 익숙하지 않은 사람도 쓸 수 있게, VS Code확장을 하나 만들었어요. 코드를 선택하고 명령 팔레트(맥:Cmd+Shift+P, 윈도우: Ctrl+Shift+P)를 열어서 "Kodex: 코드 리뷰 실행"을 누르면, 오른쪽에 리뷰 결과가 패널로 뜨는 구조예요. VS Code 자체가 크로스 플랫폼이라 윈도우에서도 똑같이 패널이 열려요

코드를 드래그해서 선택하면 선택한 부분만, 선택 안 하면 파일 전체를 리뷰
API 키는 .env대신 VS Code 설정 화면에 입력

TypeScript + VS Code Plugin API로 만들었고, 내부적으로는 CLI(review.py)랑 똑같은 Gemini 프롬프트를 재사용해서 리뷰 형식이 항상 동일하게 나와요.

오늘의 삽질 : 모델이 하루 아침에 사라졌다..

확장을 만들고 신나게 테스트하는데 이런 에러가 떴어요.

Gemini API 오류 (404):
"This model models/gemini-2.5-flash is no longer available to new users.
Please update your code to use a newer model..."

어제 잘 되던 모델이 하루 만에 신규 사용자에게 막힌거예요..! 구글이 계속 새 Gemini 모델을 내놓으면서 예전 버전을 순차적으로 정리하고 있어서 생긴 문제였어요.

해결 방법은 특정 버전 이름을 하드코딩하지 않는 것이었어요. Gemini API에는 항상 최신 Flash 모델을 자동으로 가리키는 별칭이 있어요.

# Before
MODEL_NAME = "gemini-2.5-flash"

# After
MODEL_NAME = "gemini-flash-latest"

이렇게 바꾸니 앞으로 모델이 또 바뀌어도 코드를 매번 고칠 필요가 없어졌어요. 혹시 같은 에러를 만난 분이 있다면 이 별칭으로 바꿔보시길 추천해요!

기능도 보강했어요

파일 하나가 아니라 여러 파일을 한 번에 리뷰할 수 있게 했어요!(python review.py a.py b.py c.py)
리뷰 결과를 마크다운 파일로 저장하는 --out 옵션을 추가했어요!

저장소를 두 개로 나눴어요

CLI(review.py)랑 VS Code 확장을 처음엔 한 저장소에 넣을까 고민했는데, 결국 나눴어요. 파이썬이랑 TypeScript(Node)는 완전히 다른 생태계라서 한 저장소에 섞으면 node_modules랑 파이썬 가상환경이 뒤엉켜 지저분해지고, 나중에 VS Code 확장을 마켓플레이스에 올리려면 확장 전용 저장소가 관리하기 편하기도 해요.

대신 서로의 README에 링크를 걸어서 "같은 프로젝트의 다른 인터페이스"라는 걸 알 수 있게 해뒀어요.

kodex-code-review-agent — 터미널용 CLI
kodex-vscode-extension — VS Code 확장

CLI 실행법: 윈도우 vs 맥

CLI(review.py)를 처음 받아서 돌려보는 분들을 위해 윈도우 기준도 같이 정리해뒀어요. 저는 맥으로 개발했지만, 명령어 몇 개만 다르면 윈도우에서도 똑같이 돌아가요.

공통 준비물

Python 3.10 이상 설치
Google AI Studio에서 Gemini API 키 발급
저장소 클론

git clone https://github.com/DoyuIm/kodex-code-review-agent
cd kodex-code-review-agent

🪟 윈도우 (PowerShell)

python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt
copy .env.example .env
notepad .env   # GEMINI_API_KEY= 뒤에 키 붙여넣기
python review.py my_script.py

python 명령이 마이크로소프트 스토어 팝업으로 연결되면 py로 대신 시도해보세요. Python 설치할 때 "Add python.exe to PATH" 체크박스를 켜는 게 중요해요.

🍎 맥 (터미널)

python3 -m venv venv
source venv/bin/activate
pip3 install -r requirements.txt
cp .env.example .env
open -e .env   # GEMINI_API_KEY= 뒤에 키 붙여넣기
python3 review.py my_script.py

맥은 기본적으로 python이 아니라 python3, pip이 아니라 pip3인 경우가 많아요. 안 되면 3을 붙여보세요.

	윈도우	맥
가상환경 활성화	venv\Scripts\activate	source venv/bin/activate
패키지 설치	pip install -r requirements.txt	pip3 install -r requirements.txt
.env 열기	notepad .env	open -e .env
실행	python review.py my_script.py	python3 review.py my_script.py