Ch5. 모드 활용

OpenCode의 모드는 작업 성격에 맞게 행동을 제한하는 장치입니다. 현재는 에이전트 기반 설정이 권장되며, Tab 키로 프라이머리 에이전트 간 전환합니다.

Build vs Plan

Plan → Build 2단계 워크플로우

대규모 작업에 효과적인 패턴입니다.

에이전트 기반 모드 확장

커스텀 에이전트로 더 세분화된 모드를 구성할 수 있습니다.

{
  "agent": {
    "security-audit": {
      "description": "보안 감사 모드",
      "mode": "primary",
      "tools": {
        "write": false,
        "edit": false,
        "bash": false
      },
      "prompt": "보안 취약점을 분석합니다. 코드를 수정하지 않고 보고서만 작성합니다."
    }
  }
}

이렇게 하면 Tab 키로 Build → Plan → Security Audit 세 모드를 순환할 수 있습니다.

고급 팁

• Plan → Build 2단계: 먼저 계획을 만들고 승인 후 구현
• 모드별 모델 분리: Plan은 추론이 강한 고성능 모델, Build는 비용 효율 모델
• 승인 전략: Plan 모드에서는 승인 흐름을 줄이고, Build에서 엄격하게
• 커스텀 모드 추가: mode: "primary"로 설정하면 Tab 순환 대상에 포함

참고 문서

• 모드 개요: https://opencode.ai/docs/modes
• 에이전트: https://opencode.ai/docs/agents