컨텐츠로 건너뛰기
쇼케이스 생태계 소스 코드 문서

설정

설정

독단적인 기본값이 제공되며, 원한다면 조정할 수 있습니다.

설정 파일 위치

수준경로우선순위
프로젝트.opencode/oh-my-openagent.json[c]최고
사용자~/.config/opencode/oh-my-openagent.json[c]낮음

호환성 레이어는 oh-my-openagent.json[c]와 기존 oh-my-opencode.json[c] 파일 이름을 모두 인식합니다. 기존 설치에서는 여전히 기존 기본 이름을 일반적으로 사용합니다.

JSONC가 지원됩니다 — 주석과 후행 콤마가 작동합니다.

에이전트 설정

모든 에이전트에 대해 모델, 온도, 프롬프트, 권한을 재정의합니다:

{
  "agents": {
    "sisyphus": {
      "model": "claude-opus-4-6",
      "temperature": 0.7
    },
    "hephaestus": {
      "model": "gpt-5.4"
    },
    "prometheus": {
      "model": "claude-opus-4-6",
      "temperature": 0.6
    }
  }
}

에이전트별 옵션:

  • model — 사용할 LLM
  • temperature — 샘플링 온도
  • prompt_append — 에이전트의 시스템 프롬프트에 추가되는 지침
  • system_prompt_override — 전체 시스템 프롬프트 교체
  • max_tokens — 최대 응답 길이
  • file:// 프롬프트 — 파일에서 프롬프트 텍스트 로드

카테고리 매핑

Sisyphus는 카테고리별로 위임합니다. 특정 모델에 매핑되는 커스텀 카테고리를 정의할 수 있습니다:

{
  "categories": {
    "visual-engineering": { "model": "claude-opus-4-6" },
    "deep": { "model": "gpt-5.4" },
    "quick": { "model": "kimi-k2.5" },
    "ultrabrain": { "model": "gpt-5.4", "reasoning_effort": "xhigh" },
    "business-logic": { "model": "claude-opus-4-6" },
    "custom": { "model": "glm-5" }
  }
}

내장 카테고리: visual-engineering, deep, quick, ultrabrain. 필요한 커스텀 카테고리를 추가하세요.

모델 폴백

안정성을 위해 폴백 모델을 구성합니다:

{
  "fallback_models": {
    "default": ["claude-opus-4-6", "kimi-k2.5"],
    "hephaestus": [
      "gpt-5.4",
      { "model": "claude-opus-4-6", "reasoning_effort": "high" }
    ]
  }
}

동일한 배열에서 일반 모델 문자열과 폴백별 객체를 혼합할 수 있습니다. 시스템은 성공할 때까지 각 폴백을 순서대로 시도합니다.

내장 스킬

내장 스킬을 구성합니다:

스킬설명기본값
playwright브라우저 자동화활성화
git-master원자적 커밋, 리베이스 수술활성화
frontend-ui-ux디자인 우선 UI활성화

스킬 비활성화:

{
  "skills": {
    "playwright": { "enabled": false }
  }
}

커스텀 스킬 추가:

  • 프로젝트 수준: .opencode/skills/*/SKILL.md
  • 사용자 수준: ~/.config/opencode/skills/*/SKILL.md

훅

25개 이상의 내장 훅, 모두 구성 가능합니다. 특정 훅 비활성화:

{
  "disabled_hooks": [
    "comment-checker",
    "auto-format"
  ]
}

훅은 다양한 수명 주기 지점에서 실행됩니다:

  • Pre-task: 에이전트 실행 전
  • Post-task: 에이전트 완료 후
  • On-error: 오류 발생 시
  • On-agent-switch: 에이전트 전환 시

내장 MCP 설정

세 가지 MCP가 기본적으로 항상 활성화되어 있습니다:

MCP용도구성 가능
websearch (Exa)웹 검색API 키, 검색 깊이
context7공식 문서 조회활성화/비활성화
grep_app (Grep.app)GitHub 코드 검색활성화/비활성화

커스텀 MCP 서버는 표준 OpenCode MCP 구성 형식으로 추가할 수 있습니다.

백그라운드 작업 동시성

병렬로 실행되는 에이전트 수를 제어합니다:

{
  "background_tasks": {
    "max_concurrent": 5,
    "per_provider": {
      "anthropic": 3,
      "openai": 5,
      "google": 2
    }
  }
}

API 속도 제한 및 구독 등급에 따라 조정하세요.

LSP 설정

{
  "lsp": {
    "enabled": true,
    "servers": {
      "typescript": {
        "command": "typescript-language-server",
        "args": ["--stdio"]
      }
    }
  }
}

실험적 기능

{
  "experimental": {
    "aggressive_truncation": true,
    "auto_resume": true
  }
}
  • aggressive_truncation — 한계 내에 유지하기 위해 컨텍스트를 더 적극적으로 잘라냅니다
  • auto_resume — 오류 및 컨텍스트 윈도우 한계에서 자동으로 재개합니다

완전한 설정 예시

{
  // 에이전트 모델
  "agents": {
    "sisyphus": {
      "model": "claude-opus-4-6",
      "temperature": 0.7
    },
    "hephaestus": {
      "model": "gpt-5.4"
    }
  },

  // 카테고리 라우팅
  "categories": {
    "visual-engineering": { "model": "claude-opus-4-6" },
    "deep": { "model": "gpt-5.4" },
    "quick": { "model": "kimi-k2.5" },
    "ultrabrain": { "model": "gpt-5.4", "reasoning_effort": "xhigh" }
  },

  // 폴백 모델
  "fallback_models": {
    "default": ["claude-opus-4-6", "kimi-k2.5"]
  },

  // 스킬
  "skills": {
    "playwright": { "enabled": true },
    "git-master": { "enabled": true },
    "frontend-ui-ux": { "enabled": true }
  },

  // 훅
  "disabled_hooks": [],

  // 백그라운드 작업
  "background_tasks": {
    "max_concurrent": 5,
    "per_provider": {
      "anthropic": 3,
      "openai": 5
    }
  },

  // LSP
  "lsp": {
    "enabled": true
  },

  // 실험적
  "experimental": {
    "aggressive_truncation": true,
    "auto_resume": true
  }
}

유효성 검사

doctor를 실행하여 설정을 검증하세요:

bunx oh-my-opencode doctor

플러그인 등록, 설정 구문, 모델 가용성, 환경 설정을 확인합니다.

다음 단계