Blog

무료 Claude 코드 대체재 구축 방법: gpt-oss-20b 활용

Ashley Goolam

Ashley Goolam

15 August 2025

무료 Claude 코드 대체재 구축 방법: gpt-oss-20b 활용

안녕하세요, 코더 여러분! 무료 로컬 AI 코딩 환경으로 개발 워크플로우를 혁신하고 싶으신가요? 잘 찾아오셨습니다! 오늘은 GPT-OSS, Opencode, Vibe Kanban을 사용하여 강력한 오픈소스 AI 코딩 환경을 구축하는 방법을 자세히 살펴보겠습니다. 이 도구들을 사용하면 비용 부담 없이 더 스마트하게 코딩하고, 작업을 자동화하며, 프로젝트를 관리할 수 있습니다. 이 가이드에서는 GPT-OSS 모델과 Opencode를 설정하여 포트폴리오 웹사이트를 구축하고, Vibe Kanban을 사용하여 이를 관리하고 개선하는 과정을 안내해 드릴 것입니다. 이 가이드를 마치면 로컬에서 AI 기반의 강력한 코딩 환경을 갖게 될 것입니다. 자, GPT-OSS, Opencode, Vibe Kanban과 함께 코딩을 시작해 봅시다!

💡
아름다운 API 문서를 생성하는 훌륭한 API 테스팅 도구를 원하시나요?

개발팀이 최대의 생산성으로 함께 작업할 수 있는 통합 올인원 플랫폼을 원하시나요?

Apidog은 모든 요구 사항을 충족하며, 훨씬 더 저렴한 가격으로 Postman을 대체합니다!
버튼

GPT-OSS, Opencode, Vibe Kanban은 무엇인가요?

시작하기 전에, 저희 AI 코딩 트리오의 주역들을 만나보시죠:

이 도구들은 함께 GPT-OSS가 AI를 구동하고, Opencode가 코딩 작업을 처리하며, Vibe Kanban이 프로젝트를 정리하는 무료 로컬 환경을 만듭니다. 이제 설정해 봅시다!

gpt-oss 모델

1단계: Opencode 설치

먼저, AI 코딩 환경의 핵심인 Opencode를 설치해야 합니다. macOS/Linux에서는 매우 쉽고, Windows용 수동 옵션도 있습니다.

macOS/Linux용

터미널에서 다음 명령 중 하나를 실행하세요:

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

npm i -g opencode-ai@latest  # or bun/pnpm/yarn
brew install sst/tap/opencode  # macOS and Linux
paru -S opencode-bin  # Arch Linux

Windows용

  1. github.com/sst/opencode/releases를 방문하세요 (예: 2025년 8월 기준 v0.3.112).
  2. 최신 opencode.exe 바이너리를 다운로드하세요.
  3. 디렉토리(예: C:\opencode)에 저장하세요.

설치 테스트

Opencode가 작동하는지 확인하세요:

전문가 팁: Windows의 경우, 더 쉽게 접근할 수 있도록 바이너리 폴더를 PATH에 추가하세요.

opencode 에이전트

2단계: Opencode 프로젝트 설정

Opencode와 GPT-OSS를 사용하여 포트폴리오 웹사이트를 구축할 새 프로젝트 폴더를 만들어 봅시다. 사용자 정의 설정으로 구성할 것입니다.

프로젝트 폴더 생성:

mkdir opencode-vibekanban-project
cd opencode-vibekanban-project

AGENTS.md 추가:
AGENTS.md라는 파일을 다음과 같이 생성하세요:

# Tooling rules for Opencode
- Use Opencode tools only: read, write, edit, list, glob, grep, webfetch, bash, task, todowrite, todoread.
- Do NOT call non-existent tools like Repo_browser.*.
- Prefer `edit` for modifying existing files; use `read` to inspect before editing.

이는 Opencode의 AI 에이전트가 올바른 도구를 사용하도록 규칙을 정의합니다.

opencode.json 추가:
GPT-OSS (20B 모델)를 구성하기 위해 opencode.json을 생성하세요:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ollama": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ollama (local)",
      "options": {
        "baseURL": "http://localhost:11434/v1"
      },
      "models": {
        "gpt-oss:20b": { "name": "gpt-oss 20B (local)" }
      }
    }
  },
  "model": "ollama/gpt-oss:20b",
  "agent": {
    "build": {
      "description": "Default coding mode with only Opencode tools.",
      "tools": {
        "read": true,
        "write": true,
        "edit": true,
        "bash": true,
        "grep": true,
        "glob": true,
        "list": true,
        "webfetch": true,
        "patch": true,
        "todoread": true,
        "todowrite": true
      },
      "prompt": "{file:./AGENTS.md}"
    }
  },
  "instructions": ["AGENTS.md"]
}

더 강력한 GPT-OSS 120B를 사용하고 싶으신가요? provider 및 model 섹션을 다음으로 바꾸세요:

"provider": {
  "ollama": {
    "npm": "@ai-sdk/openai-compatible",
    "name": "Ollama (local)",
    "options": {
      "baseURL": "http://localhost:11434/v1"
    },
    "models": {
      "gpt-oss:120b": { "name": "gpt-oss 120B (local)" }
    }
  }
},
"model": "ollama/gpt-oss:120b"

참고: AGENTS.md와 opencode.json을 opencode-vibekanban-project에 저장하세요. 이 파일들은 Opencode에게 GPT-OSS를 사용하고 특정 도구 규칙을 따르도록 지시합니다.

3단계: Ollama로 GPT-OSS 설치 및 실행

GPT-OSS는 LLM 관리를 위한 경량 도구인 Ollama를 통해 로컬에서 실행됩니다. 적절한 사양의 머신(20B 모델의 경우 16GB+ RAM, 120B 모델의 경우 64GB+ RAM)이 필요합니다.

  1. Ollama 설치:

2. GPT-OSS 모델 풀(Pull):

ollama pull gpt-oss:20b

ollama pull gpt-oss:120b
ollama의 gpt-oss 모델

3. 모델 실행:

ollama run gpt-oss:20b

또는

ollama run gpt-oss:120b

전문가 팁: Opencode를 시작하기 전에 Ollama가 실행 중인지 확인하세요. 그렇지 않으면 연결 오류가 발생할 수 있습니다.

4단계: 프로젝트용 Opencode 실행

이제 프로젝트 폴더에서 Opencode를 실행해 봅시다:

  1. 프로젝트로 이동:
cd opencode-vibekanban-project

2. Opencode 실행:

opencode .

<path-to-opencode>/opencode.exe .

3. 설정 확인:

gpt-oss 모델로 opencode 구성

5단계: Opencode로 포트폴리오 웹사이트 만들기

Opencode와 GPT-OSS를 사용하여 John Doe라는 개발자를 위한 간단한 포트폴리오 랜딩 페이지를 React와 Vite로 구축해 봅시다.

프롬프트 입력:

Create a simple portfolio landing page for a developer called John Doe in React with Vite.

웹사이트 실행:

npm install
npm run dev
간단한 포트폴리오 웹사이트

GitHub에 푸시:

git init
git add .
git commit -m "Initial portfolio website"
git remote add origin https://github.com/your-username/john-doe-portfolio.git
git push -u origin main

전문가 팁: 필요한 경우 Opencode의 `webfetch` 도구를 사용하여 기존 포트폴리오 사이트에서 영감을 얻으세요.

6단계: 프로젝트 관리를 위해 Vibe Kanban 설정

이제 Vibe Kanban을 통합하여 AI 에이전트로 포트폴리오 프로젝트를 관리하고 개선해 봅시다.

Vibe Kanban 설치:

npx vibe-kanban

Vibe Kanban 구성:

vibe kanban을 github와 연결

새 프로젝트 생성:

새 프로젝트 생성

7단계: Vibe Kanban으로 작업 추가

Vibe Kanban을 사용하여 연락처 양식과 같은 새 기능을 추가하여 포트폴리오를 개선해 봅시다.

작업 생성:

작업 생성

에이전트 선택:

opencode를 에이전트로 선택

검토 및 승인:

git add .
git commit -m "Added contact form"
git push

전문가 팁: Vibe Kanban을 사용하여 여러 작업(예: "다크 모드 추가", "이미지 최적화")을 대기열에 추가하고 Opencode가 순차적으로 처리하도록 하세요.

일반적인 문제 해결

이 스택이 뛰어난 이유

GPT-OSS, Opencode, Vibe Kanban 조합은 개발자의 꿈입니다:

사용자들은 이 설정을 좋아합니다: "GPT-OSS와 함께하는 Opencode는 몇 분 만에 제 사이트를 구축했고, Vibe Kanban은 그것을 체계적으로 관리해 주었습니다!" 직접 사용해보고 그 이유를 확인하세요.

결론

이제 GPT-OSS, Opencode, Vibe Kanban을 사용하여 무료 로컬 AI 코딩 환경을 구축했습니다! 포트폴리오 사이트 구축부터 AI 에이전트를 사용한 작업 관리까지, 더 스마트하게 코딩할 준비가 되었습니다. 새로운 기능을 실험하고, 저장소에 기여하며, 댓글로 프로젝트를 공유하세요. AI 코딩 혁명을 계속 이어 나갑시다!

💡
아름다운 API 문서를 생성하는 훌륭한 API 테스팅 도구를 원하시나요?

개발팀이 최대의 생산성으로 함께 작업할 수 있는 통합 올인원 플랫폼을 원하시나요?

Apidog은 모든 요구 사항을 충족하며, 훨씬 더 저렴한 가격으로 Postman을 대체합니다!
버튼

Apidog에서 API 설계-첫 번째 연습

API를 더 쉽게 구축하고 사용하는 방법을 발견하세요

무료 회원가입다운로드