🚀

AI Coding Assistant
Dev Environment

생산성을 극대화하는 AI기반 개발 도구 셋업 가이드

설치 로드맵

다음 6가지 도구는 현대적인 AI 및 웹 개발을 위한 필수적인 기술 스택입니다.

VSCode

통합 개발 환경 (IDE)

Python

AI 핵심 언어

uv

초고속 패키지 관리

Node.js

JS 런타임

Gemini CLI

터미널 AI 비서

Pandoc

문서 변환 도구

Visual Studio Code

단순한 텍스트 에디터를 넘어선, 전 세계 개발자의 표준 IDE입니다. Microsoft의 강력한 지원과 수만 개의 확장 프로그램(Extensions) 생태계가 결합되어, Python, JavaScript 등 어떤 언어든 쾌적하게 개발할 수 있습니다. AI Copilot과의 연동성도 가장 뛰어납니다.

Key Features

IntelliSense: 스마트한 코드 자동 완성 및 문법 오류 실시간 감지
Integrated Git: 별도 프로그램 없이 변경 사항 추적 및 커밋 가능
Debugging: 변수 상태를 실시간으로 확인하며 오류 수정

Windows 설치 팁

설치 옵션 중 "Install for all users"를 선택하세요. 권한 문제없이 시스템 전체에서 사용할 수 있으며, 향후 업데이트 시에도 관리가 용이합니다.

VSCode 다운로드

활용 예시: 프로젝트 열기

TERMINAL

                                # 현재 폴더를 VSCode로 엽니다
                                $ code .
                            

VERIFY INSTALLATION

$ code --version

Python

AI 및 데이터 과학 분야에 널리 쓰입니다. TensorFlow, PyTorch와 같은 딥러닝 프레임워크부터 데이터 분석, 웹 서버 구축까지 가능합니다. 인터프리터 언어로 코드를 한 줄씩 실행하며 결과를 즉시 확인할 수 있어 생산성이 높습니다.

필수 설정 (Critical Config)

설치 화면 하단 "Add Python to PATH" 체크박스 선택 필수
최신 안정 버전인 3.10 ~ 버전 사용 권장

Windows 사용자 필수 설정

설치 프로그램 실행 시 "Customize installation"을 클릭하고, Advanced Options 단계에서 "Install for all users" 항목을 반드시 체크하세요.

이유: 이 옵션을 선택해야 Python이 C:\Program Files\ 등 공용 경로에 설치되어, 사용자 권한 문제나 가상환경 경로 꼬임 현상을 근본적으로 방지할 수 있습니다.

macOS 사용자 필수

설치 후 /Applications/Python 3.x/ 폴더의 Install Certificates.command 파일을 실행하세요. (SSL 인증서 미설치 시 pip 사용 불가)

Python 다운로드

활용 예시: 버전 확인 및 실행

TERMINAL

                                # 버전 확인
                                $ python --version
                                
                                # 간단한 출력 테스트
                                $ python -c "print('Hello AI')"

uv (Astral)

Rust 언어로 작성된 혁신적인 Python 패키지 관리자입니다. 기존의 pip보다 최대 10~100배 빠른 속도를 자랑합니다. 복잡한 의존성 해결(Dependency Resolution) 과정을 순식간에 처리하며, 프로젝트별 가상환경(venv) 관리를 획기적으로 단순화합니다.

Why uv?

Global Cache: 한 번 다운로드한 패키지는 캐시되어 디스크 공간 절약
All-in-One: pip, pip-tools, virtualenv 기능을 하나의 도구로 통합
Compatibility: 기존 requirements.txt 및 pyproject.toml 완벽 지원

설치 명령어 (Windows PowerShell)

POWERSHELL

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

설치 명령어 (macOS / Linux)

TERMINAL

curl -LsSf https://astral.sh/uv/install.sh | sh

활용 예시: 패키지 초고속 설치

USAGE

                                # 가상환경 생성 및 활성화 필요 없음 (자동 처리)
                                $ uv pip install numpy pandas
                            

Node.js

Chrome V8 엔진 기반의 JavaScript 런타임입니다. AI 개발자가 왜 필요할까요? 바로 최신 AI 도구(Gemini CLI 등)와 프론트엔드 인터페이스가 대부분 Node.js 생태계(npm) 위에서 동작하기 때문입니다. 서버 사이드 개발부터 도구 실행까지 폭넓게 사용됩니다.

Key Points

LTS (Long Term Support) 버전 설치 권장 (안정성 최우선)
설치 시 npm (Node Package Manager)이 자동으로 함께 설치됨

설치 후 재부팅

환경 변수 적용을 위해 설치 완료 후 열려있는 모든 터미널(CMD, VSCode 터미널 등)을 닫았다가 다시 실행해야 합니다.

Node.js (LTS) 다운로드

활용 예시: JS 실행 및 패키지 관리

TERMINAL

                                # 버전 확인
                                $ node -v
                                
                                # 패키지 매니저 버전 확인
                                $ npm -v

Gemini CLI

Google의 최첨단 생성형 AI 'Gemini'를 터미널 환경으로 가져옵니다. 브라우저를 켜지 않고도 코드에 대한 질문, 에러 로그 분석, 문서 요약, 커밋 메시지 생성 등을 명령줄에서 즉시 수행할 수 있어 개발 몰입도(Flow)를 유지하는 데 큰 도움이 됩니다.

개발 생산성 혁신

Workflow Integration: 터미널 파이프라인(|)을 통해 다른 명령어와 연동 가능
Direct Code Gen: 원하는 기능을 말하면 코드를 생성해 줍니다.

설치 명령어 (Node.js 필요)

TERMINAL

                                # -g 옵션은 전역(Global) 설치를 의미합니다
                                $ npm install -g @google/gemini-cli
                            

GitHub 저장소

활용 예시: AI에게 질문하기

USAGE

                                # 터미널에서 바로 질문
                                $ gemini "Python으로 피보나치 수열 짜줘"
                            

Pandoc

"문서 변환계의 스위스 아미 나이프"입니다. AI가 생성한 Markdown(.md) 형식의 문서를 깔끔한 Word(.docx), PDF, HTML 보고서로 즉시 변환해 줍니다. 수식, 표, 인용구 등 복잡한 서식도 완벽하게 유지하며 변환하는 강력한 기능을 제공합니다.

주요 활용

개발 문서(README.md)를 고객용 매뉴얼(Word/PDF)로 변환
Jupyter Notebook을 HTML 리포트로 변환

Pandoc 설치 가이드

활용 예시: 문서 변환

TERMINAL

                                # 마크다운을 워드 문서로 변환
                                $ pandoc input.md -o output.docx
                            

VERIFY

$ pandoc --version

System Verification

모든 설치가 완료되었습니다. 터미널(PowerShell 또는 CMD)을 열고 아래 명령어를 순서대로 입력하여 모든 도구가 정상적으로 인식되는지 확인하세요.

Visual Studio Code code --version

Python python --version

uv Package Manager uv --version

Node.js node -v

Gemini CLI gemini --version

Pandoc pandoc --version

AI Coding AssistantDev Environment

설치 로드맵

VSCode

Python

uv

Node.js

Gemini CLI

Pandoc

Visual Studio Code

Python

uv (Astral)

Node.js

Gemini CLI

Pandoc

System Verification

AI Coding Assistant
Dev Environment