AI 에이전틱 코딩 & OpenCode 완전 정복 가이드

1. 에이전틱 코딩이란 무엇인가

최근 개발 방식이 빠르게 바뀌고 있다. 기존에는 개발자가 직접 한 줄 한 줄 코드를 작성했다면, 요즘은 AI 에이전트에게 원하는 기능을 설명하고 코드를 만들어달라고 요청하는 방식이 자리를 잡아가고 있다. 이걸 에이전틱 코딩(Agentic Coding) 이라고 부른다.

쉽게 말하면 내가 기획자이자 감독 역할을 하고, AI가 실제 개발을 담당하는 구조다. 최근에는 이 방식을 바이브 코딩(Vibe Coding) 이라고도 부르는데, AI와 대화하듯 흐름을 타면서 개발해 나가는 느낌에서 붙여진 이름이다.

작업은 주로 CLI(명령줄 인터페이스) 환경에서 이루어진다. 터미널에 명령어를 입력하면서 AI와 협력해 나가는 방식이 기본이다.



2.기존 AI 코딩 도구의 비용 문제

솔직하게 말하자면, 현재 시장에 나와 있는 유명한 AI 코딩 도구들은 가격이 만만치 않다. 월 100달러에서 200달러 수준의 구독료가 필요한 서비스들이 적지 않고, 이는 한화로 약 13만 원에서 26만 원에 해당한다.

취미로 개발을 배우거나 개인 프로젝트를 진행하는 입장에서는 부담이 되는 금액이다. 자연스럽게 비슷한 기능을 무료나 저렴하게 쓸 수 있는 대안을 찾게 되는데, 그 흐름 속에서 주목받고 있는 것이 오픈소스 기반의 도구들이다.



3. OpenCode란 무엇인가

OpenCode는 오픈소스 기반의 에이전트 코딩 도구다. 유료 도구들과 비슷한 방식으로 AI가 코드를 생성하고 개발 작업을 도와주는 환경을 제공한다.

주요 특징을 정리하면 다음과 같다.

오픈소스 프로젝트이기 때문에 코드 구조를 직접 확인하거나 수정할 수 있다.

다양한 AI 모델을 선택해서 사용할 수 있다.

일부 모델은 별도 비용 없이 테스트해볼 수 있어 입문자에게 접근성이 높다.

터미널 기반 인터페이스로 작동한다.

최근 해외 개발자 커뮤니티에서 관심이 높아지고 있는 도구 중 하나다.





4. 윈도우 환경 준비 - WSL 설치

OpenCode는 리눅스 환경을 기반으로 동작하기 때문에, 윈도우 사용자라면 먼저 WSL(Windows Subsystem for Linux) 을 설치해야 한다. WSL은 윈도우 안에서 리눅스를 실행할 수 있게 해주는 기능이다.

설치 순서는 아래와 같다.

1단계. 메인보드 가상화 기능 활성화 PC를 재시작한 뒤 BIOS 또는 UEFI 설정 화면으로 진입한다. Intel CPU라면 VT-x, AMD CPU라면 AMD-V 항목을 찾아서 활성화한다.

2단계. 윈도우 기능 설정에서 두 항목 켜기 시작 메뉴에서 "Windows 기능 켜기/끄기"를 검색해 실행한다. 목록에서 "가상 머신 플랫폼"과 "Linux용 Windows 하위 시스템" 두 항목에 체크한다.

3단계. 컴퓨터 재부팅

4단계. 명령 프롬프트에서 우분투 설치

명령 프롬프트를 관리자 권한으로 실행한 뒤 아래 명령어를 입력한다.

5. Node.js 설치 및 OpenCode 셋업

WSL 설치가 끝났으면 이제 본격적인 개발 환경을 구성할 차례다.

1단계. Node.js 설치

우분투 터미널을 열고 아래 명령어를 순서대로 입력한다.

bash

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - sudo apt-get install -y nodejs

2026년 기준으로는 nvm(Node Version Manager)을 활용하는 방식이 더 권장되는 편이다. 버전 관리가 편리하고 충돌 문제를 줄일 수 있기 때문이다.

2단계. 작업 폴더 생성

bash

mkdir my-project && cd my-project

3단계. OpenCode 설치

npm install -g opencode-ai

4단계. OpenCode 실행

opencode

실행하면 터미널 기반 UI가 나타나고, 사용할 AI 모델을 선택하는 화면이 뜬다. 모델을 고른 뒤 바로 작업을 시작하면 된다.



6. Plan 모드와 Build 모드

OpenCode에는 두 가지 핵심 모드가 있다. 이 두 가지를 이해하고 흐름에 맞게 활용하는 것이 작업 효율을 높이는 핵심이다.

Plan 모드 - 설계 단계

무엇을 만들지 정하기 전에 사용하는 모드다. AI가 프로젝트 전체 구조를 제안하고, 필요한 기술 스택을 추천하며, 기능 목록과 개발 순서를 설계해 준다. 본격적인 코딩 전에 설계도를 그리는 단계라고 이해하면 된다.

Build 모드 - 코드 생성 단계

실제 코드를 만드는 모드다. 원하는 기능을 설명하면 AI가 코드 파일을 직접 생성해 준다. 테스트 후 오류가 발견되면 수정을 요청하고, 기능 추가가 필요하면 이어서 요청하는 방식으로 반복 진행하면 된다.

작업 순서는 Plan 모드로 설계를 먼저 잡은 뒤, Build 모드에서 실제 구현으로 넘어가는 흐름이 가장 효율적이다.

7.실전 예시 - 영어 퀴즈 앱 만들기

실제로 어떻게 쓰는지 구체적인 예시를 보면 이해가 빠르다. 영상에서는 영어 학습 퀴즈 웹 앱을 만드는 과정을 시연한다.

진행 흐름은 아래와 같다.

1단계. AI에게 요청 "영어 단어 퀴즈 앱 만들어줘. 문제를 내고 정답을 맞히는 기능을 포함해서."

2단계. AI가 생성해주는 결과물 HTML 기반의 기본 구조, 문제 풀이 기능 코드, 기본 UI 레이아웃이 생성된다.

3단계. 테스트 후 수정 요청 오류가 있거나 부족한 기능이 있으면 AI에게 바로 수정을 요청한다. "이 부분 오류 수정해줘", "타이머 기능도 넣어줘" 같은 방식으로 이어서 요청하면 된다.

4단계. 기능 확장 반복 이 과정을 반복하면서 앱이 점점 완성되어 간다. 작업 도중 다른 AI 모델로 교체해서 이어서 진행하는 것도 가능하다.

AI 개발자에게 실시간으로 업무를 지시하는 느낌이라고 보면 된다.



8. 사용 전 꼭 확인해야 할 주의사항

외부 서비스 계정이나 API 키를 OpenCode에 연결할 때는 반드시 해당 서비스의 이용약관을 먼저 확인해야 한다.

일부 플랫폼은 특정 환경에서의 사용을 제한하거나 금지하는 경우가 있다. 약관을 확인하지 않고 연결했다가 계정이 정지되거나 차단되는 상황이 생길 수 있으니, 사용 전에 조건을 꼼꼼히 읽는 습관을 들이는 것이 좋다.