Jiminbox Docs

OpenCode 설치 가이드

7 min read

OpenCode란?

OpenCode는 오픈소스 AI 코딩 에이전트입니다. Claude, GPT, Gemini 등 다양한 AI 모델을 연결해 코드 작성, 리뷰, 디버깅 등 개발 업무를 자동으으로 수행할 수 있게 해줍니다.

ChatGPT를 써본 적 있다면? OpenCode도 기본적으로 챗봇과 같습니다. 텍스트로 질문하면 AI가 답변해 줍니다. 다른 점이 있다면, OpenCode는 내 컴퓨터의 파일을 직접 읽고 수정할 수 있다는 것뿐입니다. 코딩이 아니더라도 일상적인 질문, 번역, 글쓰기, 요약 등은 ChatGPT처럼 그대로 사용할 수 있습니다.

OpenCode는 Desktop(GUI 앱)과 TUI(터미널 기반) 두 가지 환경을 제공합니다.

환경설명
Desktop별도로 다운로드하는 GUI 앱. 마우스 클릭, 드래그앤드롭 등 친숙한 데스크톱 환경에서 사용할 수 있습니다.
TUI터미널에서 opencode 명령어로 실행. 가볍고 어디서든 동작하지만, 키보드 위주의 조작이 필요합니다.

권장

터미널 명령어에 익숙하지 않다면 Desktop 앱을 추천합니다. 설치도 간단하고, 시각적으로 더 직관적입니다. 다운로드: https://opencode.ai/download

API Key 보안 주의

API Key는 비밀번호처럼 중요한 인증 정보입니다. 설정 파일에 입력한 API Key를 다른 사람에게 공유하거나 Git 저장소에 커밋하지 마세요. 유출되었다고 생각되면 기존 키를 폐기하고 새 키를 발급받으세요.

1. OpenCode 설치

Desktop 앱 (권장)

  1. OpenCode 다운로드 페이지에 접속합니다.
  2. 사용 중인 운영체제(macOS 또는 Windows)에 맞는 설치 파일을 다운로드합니다.
  3. 다운로드한 파일을 실행하여 설치를 진행합니다.

터미널 기반 (TUI)

명령 프롬프트에서 직접 opencode 명령어를 실행하고 싶은 경우에만 진행하세요.

  1. **node.js 설치 가이드**를 참고하여 Node.js를 설치합니다.
  2. Windows 키 + R을 누르고 cmd를 입력하여 명령 프롬프트를 실행합니다.
  3. 아래 명령어를 입력하고 엔터를 누릅니다. 
    npm i -g opencode-ai
  4. 설치가 끝나면 cmd 창에 opencode를 입력해봅니다.

2. API 설정

OpenCode를 사용하려면 jiminbox API 키를 설정해야 합니다. 아래 두 가지 방법 중 하나를 선택하세요.

방법 A: 자동 설정 (권장)

oh-my-jiminbox 자동 설정 스크립트를 사용하면, API 키 입력부터 모델 설정까지 한 번에 완료됩니다.

  1. oh-my-jiminbox 저장소에서 oh-my-jiminbox.bat 파일을 다운로드합니다.

2. 더블클릭하여 실행합니다. 3. jiminbox API Key를 입력하면 자동으로 설정 파일이 생성됩니다. 4. OpenCode를 실행하여 /models를 입력해 모델 목록이 보이는지 확인합니다.

oh-my-jiminbox가 수행하는 작업

  • opencode.json 생성 (최신 프로바이더/모델 설정)
  • oh-my-opencode.json 생성 (에이전트/카테고리 모델 매핑)
  • 기존 설정이 있으면 자동 백업 생성

방법 B: 수동 설정

자동 스크립트를 사용하지 않고 직접 설정 파일을 작성하는 방법입니다.

1단계: 설정 파일 생성

  1. 내용 복사: opencode.json 템플릿에서 JSON을 전체 복사합니다.
  2. 폴더 이동: 아래 경로로 이동합니다.
    • 경로: C:\Users\<사용자명>\.config\opencode (윈도우)
    • 경로: <사용자폴더>\.config\opencode (Mac OS, 안보일경우 cmd+shift+’.‘)
  3. 파일 생성:
    • 해당 폴더에 메모장(텍스트 파일)을 새로 만듭니다.
    • 중요: 파일 확장자가 보이도록 설정해야 합니다. 탐색기 상단 메뉴에서 [보기] → [표시] → [파일 확장명]을 체크해주세요.
    • 파일 이름을 opencode.json으로 변경합니다. (.txt가 남지 않도록 주의!)

2단계: API Key 입력

  1. 생성한 opencode.json 파일을 우클릭하여 메모장으로 엽니다.
  2. Ctrl + F를 눌러 apiKey를 검색합니다.
  3. 따옴표 "" 사이에 발급받은 API Key를 붙여넣습니다.
    • 예시: "apiKey": "여기에 발급받은 API Key를 입력하세요"
  4. 입력을 마쳤으면 파일을 저장(Ctrl + S)하고 닫습니다.

3단계: 설정 확인

  1. OpenCode를 실행합니다.
  2. 입력창에 /models를 입력하고 엔터를 칩니다.
  3. 스크롤을 내렸을 때, 아래 사진처럼 jiminbox에서 제공하는 모델 목록이 보이면 설정 성공입니다. 4

선택 사항: Oh My Opencode 확장 기능

초보자는 이 단계를 건너뛰어도 됩니다. OpenCode 기본 사용에 익숙해진 뒤, 추가 기능이 필요할 때 설치하세요.

jiminbox에서 추천하는 OpenCode 플러그인입니다.

설치 방법

  1. opencode를 실행합니다.
  2. 아래 박스 안의 내용을 복사하여 프롬프트 창에 붙여넣고 엔터를 누릅니다.
Install and configure oh-my-opencode by following the instructions here:
https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/docs/guide/installation.md
  1. OpenCode가 질문하는 항목들에 전부 no로 답변하면 설치가 완료됩니다.

그래프 뷰

백링크