나는 최근 파이썬 개발 환경을 완전히 갈아엎었다. 기존의 무거운 가상환경 관리 도구와 느릿한 린터들이 주는 피로감이 임계점에 도달했기 때문이다. 특히 AI가 코드를 짜주는 시대에 개발자가 도구의 설정과 속도 때문에 흐름을 놓치는 것은 너무나 큰 손실이라는 생각이 들었다.
속도의 혁명 uv와 Rust 기반의 생태계
가장 먼저 손을 댄 것은 패키지 관리자였다. 오랫동안 pip와 poetry, 혹은 conda 사이에서 고민해 왔지만 결국 정착한 곳은 uv였다. Rust로 작성된 이 도구는 단순히 ‘빠르다’는 말로는 부족할 정도로 압도적인 성능을 보여준다. 가상환경 생성부터 패키지 설치까지 걸리는 시간이 거의 실시간에 가깝게 느껴질 정도다.
특히 uv는 기존의 복잡한 의존성 해결 과정을 단순화하면서도 가볍게 동작한다. 과거에는 새로운 프로젝트를 시작할 때마다 가상환경을 만들고 패키지를 설치하며 커피 한 잔을 마실 여유가 있었지만, 이제는 엔터를 치는 순간 이미 설치가 완료되어 있다. 이는 단순한 시간 단축을 넘어, 실험적인 라이브러리를 빠르게 테스트하고 버리는 ‘빠른 반복’의 사이클을 가능하게 한다.
# uv 설치 및 프로젝트 초기화
curl -LsSf https://astral.sh/uv/install.sh | sh
uv init my-ai-project
cd my-ai-project
uv add requests pandas # 초고속 패키지 설치코드 퀄리티의 자동화 Ruff로 통합하기
린터와 포매터의 설정에 쏟는 시간 또한 낭비였다. Black, flake8, isort를 각각 설치하고 서로 충돌하지 않게 설정 파일을 맞추는 작업은 고역이었다. 하지만 Ruff를 도입하면서 이 모든 과정이 하나로 통합되었다. Ruff 역시 Rust로 작성되어 기존 도구들보다 수십 배에서 수백 배까지 빠르며, 단일 설정 파일로 모든 코드 스타일을 제어할 수 있다.
나는 VSCode의 settings.json에 Ruff를 기본 포매터로 지정하고 formatOnSave 옵션을 켰다. 이제 코드를 저장하는 순간, 잘못된 임포트 순서가 바로잡히고 사용하지 않는 변수들이 정리된다. AI가 생성한 코드는 종종 스타일이 일관되지 않거나 불필요한 중복이 포함되는데, Ruff는 이를 즉각적으로 교정하여 인간이 검토해야 할 피로도를 획기적으로 낮춰준다.
# .ruff.toml 설정 예시
line-length = 120
indent-width = 4
[lint]
select = ["E4", "E7", "E9", "F"]
ignore = []
[format]
quote-style = "double"
indent-style = "space"AI 에이전트의 결합 Claude Code와 Copilot
이제 도구의 속도가 확보되었으니, 그 위에 AI 에이전트를 얹을 차례다. Claude Code와 GitHub Copilot의 조합은 개발 경험을 ‘타이핑’에서 ‘오케스트레이션’으로 바꾼다. 특히 MCP(Model Context Protocol)를 통해 AI가 로컬 파일 시스템이나 외부 API와 직접 상호작용하게 되면, 단순한 코드 완성을 넘어 프로젝트 전체의 맥락을 이해한 리팩토링이 가능해진다.
실제로 프로젝트 루트에 CLAUDE.md 파일을 생성하여 프로젝트 개요, 코딩 컨벤션, 아키텍처 룰을 명시해 두었다. 이렇게 하면 Claude가 내 프로젝트의 특성을 미리 학습한 상태에서 제안을 주기 때문에, “우리 프로젝트 스타일대로 수정해 줘”라는 모호한 요청에도 정확한 결과물을 내놓는다. Copilot이 실시간으로 다음 줄을 예측한다면, Claude Code는 전체적인 설계 방향을 잡고 복잡한 버그를 추적하는 전략가 역할을 수행한다.
실전 구축 순서와 트러블슈팅
이 스택을 내 로컬 환경에 구축하는 과정은 생각보다 간단하지만, 몇 가지 주의점이 있다. 다음은 내가 추천하는 최적의 설정 순서다.
- uv 설치: 셸 스크립트를 통해 uv를 설치하고
uv venv로 깨끗한 가상환경을 구축한다. - Ruff 설정:
pip install ruff(또는uv add ruff) 후pyproject.toml이나.ruff.toml파일을 생성하여 팀 혹은 개인의 스타일 가이드를 정의한다. - IDE 연동: VSCode 확장 프로그램에서 Ruff와 Pylance를 설치하고, 저장 시 자동 수정(source.fixAll) 옵션을 활성화한다.
- AI 컨텍스트 설정: 프로젝트 루트에
CLAUDE.md를 작성하여 AI 에이전트에게 가이드라인을 제공한다.
설정 과정에서 가끔 "Command not found: uv" 에러가 발생하는 경우가 있는데, 이는 설치 후 셸의 경로(PATH)가 갱신되지 않았기 때문이다. source ~/.zshrc 또는 source ~/.bashrc를 실행하거나 터미널을 완전히 재시작하면 해결된다. 또한, Ruff의 린트 규칙이 너무 엄격해 AI가 짠 코드가 계속 빨간 줄로 도배된다면, .ruff.toml의 ignore 리스트에 해당 규칙 코드를 추가하여 적절한 타협점을 찾는 것이 정신 건강에 이롭다.
AI 네이티브 개발자로 살아남기
결국 2026년의 개발 스택은 ‘얼마나 빨리 실행하고, 얼마나 정확하게 교정하며, 얼마나 효율적으로 AI와 협업하는가’로 귀결된다. uv와 Ruff가 물리적인 시간을 줄여주었다면, Claude Code와 Copilot은 인지적인 부하를 줄여주었다. 이제 개발자의 핵심 역량은 문법을 외우는 것이 아니라, AI에게 어떤 맥락을 제공하고 어떤 결과물을 선택할 것인지 결정하는 디렉팅 능력이 될 것이다.
나는 이번 환경 구축을 통해 도구에 뺏기던 시간을 다시 설계와 로직 고민에 투자할 수 있게 되었다. 여러분의 스택에서는 어떤 도구가 가장 큰 병목이었으며, AI가 그 빈틈을 어떻게 메워주고 있는가? 혹은 여전히 AI가 건드리지 못하는, 오직 인간만이 할 수 있는 영역은 어디라고 생각하는지 궁금하다.