사용기 - 윈도우에서 AI 코딩 사용하기

코딩 AI는 단순한 자동완성이 아니라 개발 작업 자체를 수행하는 에이전트이다. AI Agent 기반 개발에서 개발자의 역할이 코더 → 아키텍트로 변화하게 된다.

WSL 환경 설치하기 

윈도우에서 "PowerShell" 을  검색창에 입력하면 설치된 경우 PowerShell 터미널을 그렇지 않는 경우는  설치를 위한 Microsoft Store 로 이동한다. 설치를 완료하면 열기 버튼이 활성화 되는데 이를 클릭해도 "PoswerShell" 이 실행된다.

코딩 에이전트(Codex CLI 같은 것)나 레포 자동 빌드/테스트는 윈도우보다 리눅스 환경이 명령 실행/경로/권한 문제가 적어서 안정적이라고 한다. 이런 이유에서 코딩 에어전트 이용을 위해서는 “윈도우에선 WSL2(Windows Subsystem for Linux 2) 권장” 이 자주 언급된다.

 설치 여부는 " wsl -l -v" 명령을 PowerShell 에 입력하여 확인 할수 있다.

wsl --status

wsl -l -v

가장 쉬운 설치 방법은 "PowerShell" 을 관리자 계정으로 실행하고  "wsl --install" 명령으로 설치 할 수 있다.  특정 배포판 설치도 가능한데 설치 가능 배포한 목록은 "wsl --list --online" 명령으로 확인 가능하다. 이때 wsl 이 설치되어 있지 않았다면 자동 설치한다.

명령을 실행해보면 상당한 수의 배폰본은 지원하고 있음을 알 수 있다. 보통은 우분투를 가장 많이 사용한다고 하며 디폴터 설치 배포본 역시 우분투이다.

설치 전에 상태 확인이 필요한데 " wsl --status" 명령으로 확인 할 수 있다. 

WSL1(리눅스 명령을 윈도우가 번역하여 수행), WSL2 (가상화를 통한 리눅스 지원) 에 대한 활성화 작업이 필요하다. 지금 위의 환경에서는 모두 비활성화 상태이다.

활성화는 PowerShell 을 관리자 권한으로 실행하고 아래 명령을 입력하면 된다.

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

또는 시작 메뉴에서 "Windows 기능 켜기/끄기 를 실행하고 아래 기능을 채크 한다음 윈도우를 재시작 한다.

• 가상 머신 플랫폼(Virtual Machine Platform)
• Linux용 Windows 하위 시스템(Windows Subsystem for Linux)

설치는 PowerShell 을 관리자 권한으로 실행하고  "wsl --install" , "wsl --install -d Ubuntu" 명령으로 할 수 있다. 

설치가 완료되면 계정 생성을 진행하게 된다.  계정생성이 완료되면 가장 먼저 시스템을 업데이트 한다.

sudo apt update

sudo apt upgrade -y

WSL 환경에서 개발 도구 설치하기 

다음 단계는 AI Agent 기반 개발 환경을 만들기 위한 개발 툴 체인을 설치하는 것이다.

1) 기본 시스템 도구

항목	설치 목적	설치 명령	확인 명령
curl	API 호출 및 다운로드	sudo apt install -y curl	curl --version
wget	파일 다운로드	sudo apt install -y wget	wget --version
unzip / zip	압축 파일 처리	sudo apt install -y unzip zip
git	소스 코드 버전 관리	sudo apt install -y git	git --version

2) 자바 개발 환경

항목	설치 목적	설치 명령	확인 명령
OpenJDK 17	자바 실행 환경	sudo apt install -y openjdk-17-jdk	java -version
Gradle	Java 빌드 도구	sudo apt install -y gradle	gradle -v

3) AI 코딩 Agent

항목	설치 목적	설치 명령	확인 명령
Codex CLI	AI 코드 생성 및 수정	npm install -g @openai/codex	codex --help
Aider	AI 코드 수정 도구	pip install aider-chat	aider --help

DE(VS Code)에서 Codex Agent를 설치한다면 WSL에 Codex CLI를 반드시 설치할 필요는 없지만 CLI 가 할 수 있는 작업이 더 많기 때문에 보통은 같이 사용한다. (npm 이 디폴트로 설치되어 있지 않아 sudo apt intall -y npm 명령으로 설치가 필요하다.)

추가로 Ubuntu 22.04 이후부터는 직접 시스템에서 사용하는 Python 을 변경하지 못하게 막고 있어 pipx 사용이 가장 안전한 방법이다. 

sudo apt update
sudo apt install -y pipx python3-venv

pipx ensurepath

터미널을 다시 실행하고 aider 을 설치한다. 

pipx install aider-chat

다음으로 자신의 환경에 필요한 빌드 도구를 설치한다.  Visual Studio Code는  https://code.visualstudio.com/ 에서 다운로드하여 설치 할 수 있다.

IED 도구 vscode 을 사용 중이라면 WSL 확장을 아래 명령으로 설치하고  PowerShell 에서 프로젝트 로 이동하고 code . 을 입력하여 VS 코드 리눅스 환경에서 실행할 수 있다.   

code --install-extension ms-vscode-remote.remote-wsl

VSCode 에서 Extenctions (Ctrl+Shift+X) 를 크릭하여 wsl 을 검색하여 설치할 수 도 있다.

VSCode 기반의 AI 코딩을 위해서 아래의 확장들은 거의 필수이다. (AI Agent 만 선택)

① Remote - WSL
② GitLens  , SVN (vscode-svn extension)
③ OpenAI Codex (선택)
④ GitHub Copilot (선택)
⑤ Docker

⑥ 기타 : Gradle for Java 

AI 코딩 시작하기

먼저 레파지토리에서 프로젝트를 가져온다. WSL 환경에 소스를 가져와야 하기 때문에 workspace 폴더를 생성하고 여기에서 다음 명령으로 소스를 가져온다. 

1. GitLab 프로젝트 페이지 → Clone 버튼에서 URL을 복사
2. git clone <HTTPS_URL>

이제 VS 코드를 실행하고 Ctrl + Shift + P 을 입력하여 명령 팔레트를 열고 WSL 을 입력하여 명령 목록에서 클릭하여 WSL환경에 연결한다.  

이제 폴더를 열면 된다. 보통은 "Do you trust the authors of this workspace?" 메시지가 나오는데 신뢰한다고 답을 하면 된다.

이제 좌측 아이콘에서 Codex 클릭하고 로그인 / 인증키 입력 한다. CLI와 IDE 확장은 동일한 로그인 정보를 공유하도록 설계되어 있어 터미널에서도 CLI 을 사용이 가능하다.

터미널에서 codex 을 실행하고 다음에 아래와 같은 간단한 명령으로 코드를 리뷰하게 할 수 있다.

"review this code focusing on security issues" 

파일 관리를 좀더 윈도우 처럼 하고 싶다면 explorer.exe . 명령으로 탐색기로 리눅스 파일시스템을 확인 할 수 있다.