🔷 08. 설정 가이드

oh-my-opencode.json에서 무엇을 바꾸면 동작이 어떻게 달라지는지, 안전한 기본값 중심으로 설명합니다.

빠르게 실행 (복붙)

cat ~/.config/opencode/oh-my-opencode.json
opencode models
bunx oh-my-opencode doctor --category authentication
bunx oh-my-opencode doctor --verbose

flowchart TD
A[파일 위치] --> B[공급자]
B --> C[에이전트/카테고리]
C --> D[스킬/브라우저/tmux]
D --> E[doctor 검증]

단계별 적용

1) 설정 파일 우선순위 확인

• 설명: 프로젝트(.opencode) > 사용자(~/.config/opencode) 우선순위를 이해합니다.
• 실행 예시: cat ~/.config/opencode/oh-my-opencode.json

2) JSONC로 설정 기록

• 설명: 주석/트레일링 콤마를 활용해 설정 의도와 변경 이유를 남깁니다.
• 실행 예시: opencode models

3) Provider 설정 점검

• 설명: Google Auth/Ollama(stream:false)/OpenCode Zen/Z.ai 등 공급자별 주의점을 적용합니다.
• 실행 예시: bunx oh-my-opencode doctor --category authentication

4) Agent/Category 튜닝

• 설명: 비용과 품질 균형을 위해 agent/category 모델을 분리 설정합니다.
• 실행 예시: bunx oh-my-opencode doctor --verbose

5) Skills/Browser/Tmux/Hooks 확장

• 설명: 스킬 로드, 브라우저 엔진, tmux, 훅 자동화를 단계적으로 켭니다.
• 실행 예시: bunx oh-my-opencode doctor --verbose

6) 변경 후 doctor 검증

• 설명: 설정 변경마다 doctor로 영향 범위를 확인합니다.
• 실행 예시: bunx oh-my-opencode doctor --verbose

부록) 원문 코드 스니펫 (검수용, 초보자는 건너뛰기)

bunx oh-my-opencode install

{
  "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json",
  // Override specific agent models
  "agents": {
    "oracle": { "model": "openai/gpt-5.2" },           // Use GPT for debugging
    "librarian": { "model": "zai-coding-plan/glm-4.7" }, // Cheap model for research
    "explore": { "model": "opencode/gpt-5-nano" }        // Free model for grep
  },
  // Override category models (used by task)
  "categories": {
    "quick": { "model": "opencode/gpt-5-nano" },         // Fast/cheap for trivial tasks
    "visual-engineering": { "model": "google/gemini-3-pro" } // Gemini for UI
  }
}

{
  "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json"
}

{
  "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json",
  /* Agent overrides - customize models for specific tasks */
  "agents": {
    "oracle": {
      "model": "openai/gpt-5.2"  // GPT for strategic reasoning
    },
    "explore": {
      "model": "opencode/gpt-5-nano"  // Free & fast for exploration
    },
  },
}

{
  "agents": {
    "explore": {
      "model": "ollama/qwen3-coder",
      "stream": false
    }
  }
}

   curl -s http://localhost:11434/api/chat \
     -d '{"model": "qwen3-coder", "messages": [{"role": "user", "content": "Hello"}], "stream": false}'

{
  "agents": {
    "explore": {
      "model": "anthropic/claude-haiku-4-5",
      "temperature": 0.5
    },
    "multimodal-looker": {
      "disable": true
    }
  }
}

{
  "agents": {
    "oracle": {
      "thinking": {
        "type": "enabled",
        "budgetTokens": 200000
      }
    }
  }
}

마무리 체크

• 위 “빠르게 실행” 명령을 최소 1개 실행했다.
• 실패 시 “원문 실행 코드 확장”의 관련 코드를 사용해 재검증했다.
• 원본 항목 대조 인덱스에서 빠진 기능이 없는지 확인했다.

---

출처

• 원문(로컬): oh-my-opencode/docs/configurations.md
• 원문(GitHub): https://github.com/code-yeongyu/oh-my-opencode/blob/dev/docs/configurations.md