OpenCode는 터미널에서 실행되어 프로젝트를 읽고, 파일을 편집하며 명령을 실행하는 오픈소스 코딩 에이전트입니다.

Ollama는 OpenCode가 로컬 및 클라우드 모델을 사용하도록 설정합니다.

시작하기

Ollama로 OpenCode를 실행하려면:

ollama launch opencode

기능

채팅

저장소나 작업에 대해 질문하기

<div class="capability-list-item">
  <div class="capability-list-icon"><Icon icon="terminal" /></div>
  <div>
    <div class="capability-list-heading">명령줄</div>
    <div class="capability-list-copy">작업 디렉터리에서 명령 실행하기</div>
  </div>
</div>

<div class="capability-list-item">
  <div class="capability-list-icon"><Icon icon="code" /></div>
  <div>
    <div class="capability-list-heading">파일 편집</div>
    <div class="capability-list-copy">프로젝트의 파일 읽기 및 편집하기</div>
  </div>
</div>

<div class="capability-list-item">
  <div class="capability-list-icon"><Icon icon="users" /></div>
  <div>
    <div class="capability-list-heading">하위 에이전트</div>
    <div class="capability-list-copy">작업을 분할하여 처리하기</div>
  </div>
</div>

<div class="capability-list-item">
  <div class="capability-list-icon"><Icon icon="file-text" /></div>
  <div>
    <div class="capability-list-heading">웹 가져오기</div>
    <div class="capability-list-copy">웹 페이지 가져와서 요약하기</div>
  </div>
</div>

<div class="capability-list-item">
  <div class="capability-list-icon"><Icon icon="image" /></div>
  <div>
    <div class="capability-list-heading">비전</div>
    <div class="capability-list-copy">이미지 및 스크린샷 전송하기</div>
  </div>
</div>

모델

저장소에 맞는 충분한 컨텍스트 길이를 가진 모델을 선택하세요.

cloud클라우드 모델

다운로드 없이 대규모 모델 사용하기

hard-drive로컬 모델

모델을 선택하고 64k 이상의 컨텍스트 창을 설정하세요

참고

OpenCode는 64k 이상의 컨텍스트 길이가 필요합니다. 자세한 내용은 컨텍스트 길이를 참고하세요.

수동 설정

1. OpenCode 설치

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

npm install -g opencode-ai

2. Ollama를 제공자로 설정하기

opencode.json에 Ollama 제공자를 추가하세요:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ollama": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ollama",
      "options": {
        "baseURL": "http://localhost:11434/v1"
      },
      "models": {
        "qwen3.5": {
          "name": "qwen3.5"
        }
      }
    }
  }
}

3. OpenCode 실행

opencode

대화형 세션을 시작하지 않고 Ollama로 OpenCode를 설정하려면:

ollama launch opencode --config

설정 우선순위

ollama launch opencode는 선택한 Ollama 모델에 대한 인라인 설정으로 OpenCode를 시작합니다. 이 명령은 ~/.config/opencode/opencode.json을 덮어쓰지 않으며, 기존 OpenCode 설정이 그대로 적용됩니다.

opencode.json에만 정의된 모델은 ollama launch 모델 선택기에 표시되지 않습니다.

OpenCode의 설정 우선순위를 참고하세요.