2026년 개발 환경 셋업 가이드
개발 환경을 제대로 세팅하면 코딩에만 집중할 수 있습니다. 반대로 말하면, 환경이 엉망이면 코드 한 줄 치기 전에 이미 지칩니다. 제가 시행착오를 거치면서 정착한 도구들과 설정을 공유합니다.
에디터: VS Code
여전히 가장 인기 있는 코드 에디터입니다. 가볍고, 확장 프로그램 생태계가 크고, 무료입니다. 이 세 가지만으로 충분한 이유가 됩니다.
처음 VS Code를 열면 밋밋합니다. 확장 프로그램을 깔아야 진짜 힘이 나옵니다. 제가 항상 가장 먼저 설치하는 것들입니다:
- ESLint — 코드에서 잠재적 에러나 나쁜 패턴을 실시간으로 잡아줍니다. 빨간 밑줄이 뜨면 뭔가 잘못된 것입니다.
- Prettier — 저장할 때마다 코드를 자동으로 정리해줍니다. 들여쓰기, 줄바꿈, 따옴표 스타일까지. 팀 프로젝트에서 "코드 스타일 통일해주세요" 같은 리뷰 코멘트가 사라집니다.
- Tailwind CSS IntelliSense — Tailwind 클래스를 자동 완성해줍니다.
bg-까지 치면 사용 가능한 배경색 목록이 드롭다운으로 나타납니다. - GitLens — 코드 각 줄이 언제, 누가, 왜 수정했는지 보여줍니다. "이 코드 누가 이렇게 바꾼 거야?" 할 때 유용합니다. (범인이 과거의 나인 경우가 대부분이지만.)
추천 설정
VS Code의 settings.json을 직접 편집하면 더 세밀하게 제어할 수 있습니다. Cmd + Shift + P를 누르고 "Open User Settings (JSON)"을 검색하면 됩니다.
{
"editor.formatOnSave": true,
"editor.defaultFormatter": "esbenp.prettier-vscode",
"editor.tabSize": 2,
"editor.bracketPairColorization.enabled": true,
"typescript.preferences.importModuleSpecifier": "non-relative"
}
formatOnSave가 핵심입니다. 파일을 저장할 때마다 Prettier가 자동으로 코드를 정리합니다. 수동으로 포맷팅할 필요가 없어지니까, 코드 작성에만 집중할 수 있습니다. bracketPairColorization은 중첩된 괄호를 색깔별로 구분해주는데, 복잡한 JSX를 읽을 때 큰 도움이 됩니다.
터미널과 쉘
macOS라면 iTerm2 + Oh My Zsh 조합을 추천합니다. 기본 Terminal 앱도 나쁘지 않지만, iTerm2는 화면 분할, 검색, 커스터마이징 측면에서 월등합니다.
Oh My Zsh는 쉘을 예쁘고 편리하게 만들어주는 프레임워크입니다. 설치는 한 줄이면 됩니다:
# Oh My Zsh 설치
sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
설치 후 ~/.zshrc 파일에서 플러그인을 추가합니다:
# 유용한 플러그인
plugins=(git zsh-autosuggestions zsh-syntax-highlighting)
zsh-autosuggestions는 이전에 입력했던 명령어를 회색으로 보여주고, 오른쪽 화살표로 수락할 수 있습니다. 긴 명령어를 반복 입력할 때 시간을 엄청 절약해줍니다. zsh-syntax-highlighting은 명령어가 올바르면 초록색, 틀리면 빨간색으로 표시해줍니다. 엔터를 누르기 전에 오타를 잡을 수 있습니다.
버전 관리: Git
개발자의 필수 도구입니다. Git 없이 코딩하는 건 세이브 없이 게임하는 것과 같습니다.
# SSH 키 생성 (ED25519 권장)
ssh-keygen -t ed25519 -C "your@email.com"
# 기본 설정
git config --global init.defaultBranch main
git config --global pull.rebase true
SSH 키를 왜 쓰냐면, GitHub에 push할 때마다 아이디/비밀번호를 입력하지 않아도 되기 때문입니다. 한 번 설정해두면 영원히 편합니다. 생성한 공개키(~/.ssh/id_ed25519.pub)를 GitHub Settings > SSH Keys에 등록하면 끝입니다.
커밋 메시지는 의미 있게 작성하세요. update나 fix 같은 한 단어짜리 메시지는 3일만 지나도 뭘 고쳤는지 기억이 안 납니다. fix: 로그인 버그 수정처럼 타입과 내용을 함께 적으면 히스토리 추적이 쉬워집니다.
Node.js 버전 관리
프로젝트마다 다른 Node.js 버전이 필요한 경우가 있습니다. A 프로젝트는 Node 18이 필요하고, B 프로젝트는 Node 22를 쓴다면? nvm (Node Version Manager)이 이 문제를 깔끔하게 해결합니다.
# nvm 설치
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
# LTS 버전 설치 및 사용
nvm install --lts
nvm use --lts
# 특정 버전 설치도 가능
nvm install 22
nvm use 22
nvm use 명령어 하나로 Node 버전을 전환할 수 있습니다. 프로젝트 루트에 .nvmrc 파일을 만들어서 버전을 명시해두면, nvm use만 치면 해당 버전으로 자동 전환됩니다. 팀원들이 다른 Node 버전을 쓰면서 "내 로컬에서는 되는데?" 같은 상황을 방지할 수 있습니다.
AI 코딩 도구
2026년에 AI 도구 없이 개발하는 건 가능하지만, 경쟁력 면에서 손해입니다. 처음에는 "AI가 짠 코드를 믿을 수 있나?" 싶었는데, 제대로 활용하면 생산성이 확실히 올라갑니다.
| 도구 | 용도 | 특징 |
|---|---|---|
| Claude Code | CLI 기반 AI 페어 프로그래밍 | 터미널에서 바로 대화, 파일 직접 수정 가능 |
| GitHub Copilot | 인라인 코드 자동 완성 | Tab 한 번으로 코드 수락, 반복 작업에 강함 |
| Cursor | AI 통합 코드 에디터 | VS Code 포크, AI 기능이 에디터에 내장 |
AI 도구를 쓸 때 가장 중요한 원칙이 하나 있습니다. 검증. 생성된 코드를 그대로 복사-붙여넣기하지 마세요. 코드를 읽고, 이해하고, 필요하면 수정하는 과정을 거쳐야 합니다. AI가 틀릴 수 있기 때문이기도 하지만, 이 과정 자체가 학습이기도 합니다.
패키지 매니저
npm이 기본이지만, 더 빠른 대안들이 있습니다. 프로젝트 규모가 커질수록 설치 속도 차이가 체감됩니다.
- pnpm — 패키지를 한 곳에 저장하고 심볼릭 링크로 연결합니다. 디스크 공간을 아끼고, 설치도 빠릅니다. 여러 프로젝트를 동시에 관리하는 개발자에게 특히 유용합니다.
- bun — JavaScript 런타임이자 패키지 매니저입니다. npm, yarn, pnpm보다 설치 속도가 압도적으로 빠릅니다. 아직 생태계가 npm만큼 성숙하지는 않지만, 빠르게 성장 중입니다.
둘 다 npm install 대신 pnpm install 또는 bun install로 바꾸기만 하면 되니까 전환 비용이 거의 없습니다.
자신만의 워크플로우를 만들어야 합니다
좋은 도구를 설치하는 건 시작일 뿐입니다. 중요한 건 그 도구들을 매일 쓰면서 자기만의 루틴으로 만드는 것입니다. 지금 바로 할 수 있는 한 가지를 고르자면 — settings.json에서 formatOnSave를 켜는 것부터 해보세요. 작은 변화가 생각보다 큰 차이를 만듭니다.