OpenCode CLI 레퍼런스 — 명령과 플래그

OpenCode CLI 레퍼런스

opencode 는 인자 없이 실행하면 TUI 를 시작하고, 명령을 받으면 프로그래밍 방식으로도 동작합니다.

출처: CLI — 공식문서

주요 명령

  • opencode / tui — 기본 터미널 UI. --continue/-c 로 이전 세션, --session/-s 로 세션 지정, --model/-m 으로 모델 선택.
  • opencode run [message..] — 비대화형 실행. --attach 로 실행 중인 serve 인스턴스에 붙을 수 있고, --format json 으로 원시 이벤트를 받습니다.
  • opencode agent — 에이전트 관리. create 는 시스템 프롬프트·권한 설정으로 새 에이전트를 만들고, list 는 목록을 냅니다.
  • opencode auth login/list — 프로바이더 로그인·목록. 자격은 ~/.local/share/opencode/auth.json 에 저장됩니다.
  • opencode mcp add/list/auth/logout/debug — MCP 서버 추가·목록·OAuth 인증 관리.
  • opencode models [provider] — 연결된 프로바이더의 모델 목록을 provider/model 형태로 냅니다.
  • opencode serve / opencode web — 헤드리스 HTTP 서버(API 접근) 및 웹 UI 서버. OPENCODE_SERVER_PASSWORD 로 basic auth 를 켭니다.
  • opencode session list/delete — 세션 관리.
  • opencode stats — 토큰 사용량·비용 통계.
  • opencode export/import — 세션 데이터 JSON 내보내기/가져오기.
  • opencode github install/run — 저장소에 GitHub 에이전트(액션 워크플로) 설치·실행.

주요 환경변수

OPENCODE_CONFIG(설정 파일 경로), OPENCODE_SERVER_USERNAME/OPENCODE_SERVER_PASSWORD(서버 basic auth), OPENCODE_AUTO_SHARE(자동 공유), OPENCODE_ENABLE_EXA/OPENCODE_ENABLE_PARALLEL(웹 검색 도구 활성화) 등.

더 알아보기