모드
모드는 다양한 워크플로우에 맞게 opencode의 동작을 커스터마이징합니다. 특정 사용 사례에 대해 모델 선택, 온도, 프롬프트, 도구 접근을 설정할 수 있습니다.
내장 모드
Build 모드
표준 개발 작업을 위한 전체 도구 접근이 가능한 기본 모드입니다. 모든 도구가 활성화되어 있습니다.
Plan 모드
계획 및 분석을 위해 설계된 제한된 모드입니다. 다음 도구가 기본적으로 비활성화되어 있습니다:
writeeditpatchbash
세션 중 Tab 키를 사용하여 모드 간 전환합니다.
설정 옵션
| 옵션 | 목적 |
|---|---|
model | 기본 AI 모델 재정의 |
temperature | 응답 무작위성 (0.0-1.0) |
prompt | 파일 참조를 통한 사용자 정의 시스템 지시사항 |
tools | 특정 기능 활성화/비활성화 |
사용 가능한 도구
bash- 쉘 명령어 실행edit- 기존 파일 편집write- 새 파일 생성read- 파일 내용 읽기grep- 파일 내용 검색glob- 패턴으로 파일 찾기list- 디렉토리 내용 나열patch- 패치 적용todowrite- 할 일 목록에 쓰기todoread- 할 일 목록 읽기webfetch- 웹 콘텐츠 가져오기
설정 방법
JSON 설정
opencode.json에 추가:
{
"agent": {
"debug": {
"mode": "primary",
"model": "anthropic/claude-sonnet-4",
"temperature": 0.2,
"tools": {
"write": false,
"edit": false
}
}
}
}Markdown 설정
.opencode/mode/ (프로젝트) 또는 ~/.config/opencode/mode/ (글로벌)에 파일 생성:
---
description: Debug mode for investigation
mode: primary
temperature: 0.2
tools:
write: false
edit: false
---
You are in debug mode. Focus on investigating issues without making changes.일반적인 사용 사례
코드 리뷰 모드
{
"agent": {
"review": {
"mode": "primary",
"description": "Reviews code for quality and security",
"tools": {
"write": false,
"edit": false,
"bash": false
}
}
}
}문서 모드
{
"agent": {
"docs": {
"mode": "primary",
"description": "Writes and updates documentation",
"model": "anthropic/claude-sonnet-4",
"temperature": 0.3
}
}
}리팩토링 모드
{
"agent": {
"refactor": {
"mode": "primary",
"description": "Refactors code with careful analysis",
"temperature": 0.1
}
}
}모드 전환
- Tab을 눌러 기본 모드 순환
- 직접 접근을 위해 설정된 키 바인딩 사용
- 모드는 변경될 때까지 세션 내에서 유지