OpenCode와 OpenRouter를 사용하여 AI 코딩 모델을 무료로 실행하는 방법

안녕하세요 여러분, 다른 사람들이 ChatGPT의 월간 구독료를 계속 지불할 때, 우리는 여기서 AI가 우리를 위해 코드를 작성하게 할 것입니다—무료로 말이죠. 😎 오늘 계획은 OpenCode를 시스템에 설정하고 OpenRouter의 무료 모델을 사용하여 이를 실행하는 것입니다. 조금만 인내심을 갖고 차를 준비해 주세요. ☕

📚 오늘의 메뉴

🧐 OpenCode: 무엇이며 왜 필요한가
💻 OpenCode 설치하기
🔑 OpenRouter로 OpenCode 구성하기
🔌 로컬 시스템에 연결하기
🚀 앱 실행 및 기도하기
🎬 마무리

🧐 1. OpenCode: 무엇이며 왜 필요한가

📖 소개

OpenCode는 터미널에서 작동하는 오픈 소스 AI 코딩 에이전트입니다. 챗봇은 질문에 답하고 복사-붙여넣기는 사용자에게 맡깁니다. 반면, 에이전트는 실제로 프로젝트를 열고, 파일을 읽고, 편집하며, 명령을 실행합니다. 예전에는 여러분이 코드를 복사-붙여넣기했지만, 이제 AI가 직접 노력하고 여러분은 그 공로만 취하는 거죠. 🤝

🎯 OpenCode를 사용해야 하는 이유?

🔓 오픈 소스: 코드를 읽고, 수정할 수 있으며, 아무도 여러분을 가둘 수 없습니다. 투명성의 완전한 양을 누릴 수 있습니다.
🧠 모델 자유도: OpenAI, Anthropic, Google, OpenRouter, 로컬 모델 등 원하는 모든 것을 사용할 수 있습니다. 모두와 친구가 될 수 있어요. 🤗
🌐 OpenRouter 지원: 하나의 계정, 하나의 API 키로 다양한 모델을 마음껏 이용할 수 있는 만찬회 같은 환경이 제공됩니다.
🚫 벤더 종속성 없음 (No vendor lock-in): 한 공급자가 비싸지거나 기분이 변해도, 다른 모델로 전환하여 계속 작업할 수 있습니다. 워크플로우는 그대로 유지될 것입니다.
🕵️ 에이전트 코딩: 단순히 붙여넣은 코드 조각 하나가 아니라, 전체 코드베이스를 읽고, 편집하고, 디버깅하며 작동합니다.
⌨️ 터미널 우선 (Terminal-first): 명령줄을 좋아하는 개발자라면 편안함을 느낄 것입니다. 마우스? 어떤 마우스요? 🐭
🧩 확장성: MCP, 플러그인, 사용자 정의 명령어 및 에이전트를 지원합니다.
🏠 로컬 모델 지원: 노트북의 성능이 허락한다면 자체 기기에서 모델을 실행할 수 있습니다. 🔥
💸 비용 통제: 쉬운 작업에는 저렴하거나 무료 모델을 사용하고, 진지한 작업에는 고급 모델을 아껴 쓸 수 있습니다.
🎛️ 사용자 정의 가능: 에이전트, 모델, 권한 및 프로젝트별 동작 방식 모두 설정할 수 있습니다.

Windows를 사용하고 있다면 두 가지 방법이 있습니다. 하나는 쉽고, 다른 하나는 개발자들이 추천하는 방식입니다. 😏

🅰️ 옵션 1: Windows + npm

📦 Node.js가 없다면 먼저 설치하세요. 이것 없이는 다음 단계에서 오류가 발생할 것입니다.
🔵 PowerShell을 여세요.
다음 명령어를 실행합니다:

   npm install -g opencode-ai

✅ 설치를 확인합니다:

   opencode --version

🎬 시작합니다:

   opencode

버전 번호가 보이면 성공입니다. 빨간색 오류가 보인다면 Node.js가 설치되었는지, 그리고 그 후에 새로운 PowerShell 창을 열었는지 확인하세요. 🔄

🅱️ 옵션 2: Windows + WSL ⭐

OpenCode 팀은 Windows에서 가장 원활한 경험을 위해 WSL (Windows Subsystem for Linux) 사용을 권장합니다. 기본적으로 리눅스가 더 좋은 환경이라는 뜻이며, 솔직히 말해서 그렇습니다. 🐧

WSL 내부에서 다음 명령어를 실행하세요:

curl -fsSL https://opencode.ai/install | bash

그런 다음 동일한 방식으로 확인하고 시작합니다:

opencode --version
opencode

💡 어떤 것을 선택해야 할까요? 바로 사용하고 싶다면 npm을 사용하세요. 어쨌든 하루 대부분의 시간을 터미널에서 보낸다면, WSL이 장기적으로 더 나은 환경입니다.

🔑 3. OpenRouter로 OpenCode 설정하기

🌐 OpenRouter란 무엇인가요?

OpenRouter를 AI 모델들의 Swiggy라고 생각해보세요. 🛵 모든 식당(제공자)을 개별적으로 방문할 필요가 없습니다. 하나의 앱과 하나의 계정으로 주문하면, 여러 주방에서 배달해 옵니다. 심지어 그 요리들 중 일부는 무료입니다.

🆕 OpenRouter 계정 생성하기

OpenRouter 가입 페이지로 이동하여 등록하세요.

✨ 보너스 팁: 사람들은 가입 시 tempmail.app을 사용하지만, 대부분의 임시 메일 서비스는 거부됩니다. 일반 이메일이 더 안전하며 나중에 계정을 잃어버리지 않을 것입니다. 😅

🏠 대시보드(Dashboard)를 열고 키(Keys)로 이동합니다.
➕ 'API 키 생성(Create API Key)'을 클릭합니다.
🏷️ OpenCode와 같이 의미 있는 이름을 지정합니다.
📋 키를 즉시 복사합니다. OpenRouter는 이 키를 한 번만 보여주므로, 분실하면 새로 만들어야 합니다. (Bhool gaye toh bhugto. 😬)

🔌 4. 로컬 시스템에 OpenCode 구성하기

이 단계가 완료되면 기기에서 무료 티어 모델을 바로 실행할 수 있습니다. 🎉

🔗 OpenCode 내부에서 /connect를 입력합니다. 제공자 선택 화면이 나타납니다.
🎯 목록에서 OpenRouter를 선택합니다.
🔐 API 키를 요청하면, 이전에 생성한 키를 붙여넣습니다. 추가 공백이 들어가지 않았는지 확인하세요. 👀
🧠 /models를 입력하고 사용하려는 모델을 선택합니다.

💡 OpenRouter의 모든 무료 모델은 이 링크에서 찾아볼 수 있습니다. 구경하는 것은 공짜입니다. 🛍️

📌 참고: nvidia/nemotron-3-nano-omni-30b-a3b-reasoning:free 또는 openrouter/free와 같이 최소한 하나의 모델을 먼저 추가해야 합니다. 그 후에 OpenCode에 더 많은 모델을 추가하도록 요청할 수 있습니다.

🎁 운 좋은 선택: openrouter/free는 사용자의 요청이 필요로 하는 바를 기반으로 자동으로 사용 가능한 무료 모델을 선택합니다. 결정하는 어려움은 끝입니다. 🙌

🧱 최종 설정

┌─────────────────┐
│       You       │
└────────┬────────┘
...

🚨 경고: OpenRouter는 25개 이상의 무료 모델을 나열하지만,

잠시만요. 모델이 생각 중이니 리프트 버튼처럼 엔터 키를 연타하지 마세요. 🛗
파일 생성 권한을 요청하면 '예'라고 답하세요. 사기가 아닙니다. 🙏

✅ 작동하나요?

무바라크 호! 🎊 이제 더 많은 모델을 추가하고 비교해 보세요. 어떤 것은 빠르고 단순하며, 다른 것은 느리고 사려 깊습니다. 마치 친구들처럼요. 😄

❌ 작동하지 않나요?

당황하지 마세요. 😤 전문가처럼 문제 해결을 해보세요:

🔍 openrouter를 인식하지 못함 → 단축키 또는 PATH가 누락되었거나 PowerShell을 다시 시작해야 함
🔑 인증 오류 → 잘못되었거나 만료된 API 키이므로 다시 붙여넣으세요
🐢 모델 응답 없음 → 무료 모델은 과부하될 수 있으니 다른 것을 시도해 보세요
📉 요청 갑자기 실패 → 일일 무료 한도를 초과했을 수 있으니 내일 다시 오세요

🎬 마무리하며

이제 구독이 필요 없이, 무료 모델로 구동되는 AI 코딩 에이전트를 터미널에 갖게 되었습니다. 🥳 프리미엄 모델만큼 날카롭나요? 아닙니다. 비용은 ₹0인가요? 네. 그러니 그냥 작업을 진행하세요. 😎

위에서 본 내용이 마음에 드셨기를 바라며, 지식을 얻었다면 '좋아요'를 눌러주세요. 어떤 단계에서 문제가 발생하면 댓글로 남겨주시면 문제 해결을 도와드리고 싶습니다.