CLI

OpenCode CLI 옵션 및 명령어.

OpenCode CLI는 기본적으로 인수 없이 실행하면 TUI를 시작합니다.

opencode

하지만 이 페이지에 문서화된 명령어도 허용합니다. 이를 통해 OpenCode와 프로그래매틱하게 상호작용할 수 있습니다.

opencode run "Explain how closures work in JavaScript"

tui

OpenCode 터미널 사용자 인터페이스를 시작합니다.

opencode [project]

플래그

플래그	축약	설명
`--continue`	`-c`	마지막 세션 계속하기
`--session`	`-s`	계속할 세션 ID
`--prompt`		사용할 프롬프트
`--model`	`-m`	provider/model 형식의 모델
`--agent`		사용할 에이전트
`--port`		수신할 포트
`--hostname`		수신할 호스트명

명령어

OpenCode CLI에는 다음 명령어도 있습니다.

agent

OpenCode용 에이전트를 관리합니다.

opencode agent [command]

attach

serve 또는 web 명령어로 시작된 이미 실행 중인 OpenCode 백엔드 서버에 터미널을 연결합니다.

opencode attach [url]

이를 통해 원격 OpenCode 백엔드와 함께 TUI를 사용할 수 있습니다. 예를 들어:

# 웹/모바일 접근을 위한 백엔드 서버 시작
opencode web --port 4096 --hostname 0.0.0.0
 
# 다른 터미널에서 실행 중인 백엔드에 TUI 연결
opencode attach http://10.20.30.40:4096

플래그

플래그	축약	설명
`--dir`		TUI를 시작할 작업 디렉토리
`--session`	`-s`	계속할 세션 ID

create

사용자 정의 설정으로 새 에이전트를 생성합니다.

opencode agent create

이 명령어는 사용자 정의 시스템 프롬프트와 도구 설정으로 새 에이전트를 생성하는 과정을 안내합니다.

list

사용 가능한 모든 에이전트를 나열합니다.

opencode agent list

auth

프로바이더의 자격 증명 및 로그인을 관리하는 명령어입니다.

opencode auth [command]

login

OpenCode는 Models.dev (opens in a new tab)의 프로바이더 목록을 사용하므로, opencode auth login을 사용하여 원하는 프로바이더의 API 키를 설정할 수 있습니다. 이는 ~/.local/share/opencode/auth.json에 저장됩니다.

opencode auth login

OpenCode가 시작되면 자격 증명 파일에서 프로바이더를 로드합니다. 환경 변수나 프로젝트의 .env 파일에 정의된 키도 로드됩니다.

list

자격 증명 파일에 저장된 모든 인증된 프로바이더를 나열합니다.

opencode auth list

또는 축약 버전.

opencode auth ls

logout

자격 증명 파일에서 제거하여 프로바이더에서 로그아웃합니다.

opencode auth logout

github

저장소 자동화를 위한 GitHub 에이전트를 관리합니다.

opencode github [command]

install

저장소에 GitHub 에이전트를 설치합니다.

opencode github install

이는 필요한 GitHub Actions 워크플로우를 설정하고 설정 과정을 안내합니다. 자세히 알아보기.

run

GitHub 에이전트를 실행합니다. 일반적으로 GitHub Actions에서 사용됩니다.

opencode github run

플래그

플래그	설명
`--event`	에이전트를 실행할 GitHub 모의 이벤트
`--token`	GitHub 개인 액세스 토큰

mcp

Model Context Protocol 서버를 관리합니다.

opencode mcp [command]

add

설정에 MCP 서버를 추가합니다.

opencode mcp add

이 명령어는 로컬 또는 원격 MCP 서버를 추가하는 과정을 안내합니다.

list

설정된 모든 MCP 서버와 연결 상태를 나열합니다.

opencode mcp list

또는 축약 버전을 사용하세요.

opencode mcp ls

auth

OAuth가 활성화된 MCP 서버에 인증합니다.

opencode mcp auth [name]

서버 이름을 제공하지 않으면 사용 가능한 OAuth 지원 서버 중에서 선택하라는 메시지가 표시됩니다.

OAuth 지원 서버와 인증 상태도 나열할 수 있습니다.

opencode mcp auth list

또는 축약 버전을 사용하세요.

opencode mcp auth ls

logout

MCP 서버의 OAuth 자격 증명을 제거합니다.

opencode mcp logout [name]

debug

MCP 서버의 OAuth 연결 문제를 디버그합니다.

opencode mcp debug <name>

models

설정된 프로바이더에서 사용 가능한 모든 모델을 나열합니다.

opencode models [provider]

이 명령어는 설정된 프로바이더에서 provider/model 형식으로 사용 가능한 모든 모델을 표시합니다.

이는 설정에서 사용할 정확한 모델 이름을 파악하는 데 유용합니다.

선택적으로 프로바이더 ID를 전달하여 해당 프로바이더의 모델만 필터링할 수 있습니다.

opencode models anthropic

플래그

플래그	설명
`--refresh`	models.dev에서 모델 캐시 새로고침
`--verbose`	더 자세한 모델 출력 사용 (비용 등 메타데이터 포함)

캐시된 모델 목록을 업데이트하려면 --refresh 플래그를 사용하세요. 프로바이더에 새 모델이 추가되어 OpenCode에서 보고 싶을 때 유용합니다.

opencode models --refresh

run

프롬프트를 직접 전달하여 비대화형 모드로 opencode를 실행합니다.

opencode run [message..]

이는 스크립팅, 자동화 또는 전체 TUI를 시작하지 않고 빠른 답변을 원할 때 유용합니다. 예를 들어.

opencode run "Explain the use of context in Go"

매번 실행할 때마다 MCP 서버 콜드 부팅 시간을 피하기 위해 실행 중인 opencode serve 인스턴스에 연결할 수도 있습니다:

# 한 터미널에서 헤드리스 서버 시작
opencode serve
 
# 다른 터미널에서 연결하여 명령어 실행
opencode run --attach http://localhost:4096 "Explain async/await in JavaScript"

플래그

플래그	축약	설명
`--command`		실행할 명령어, args에는 message 사용
`--continue`	`-c`	마지막 세션 계속하기
`--session`	`-s`	계속할 세션 ID
`--share`		세션 공유
`--model`	`-m`	provider/model 형식의 모델
`--agent`		사용할 에이전트
`--file`	`-f`	메시지에 첨부할 파일
`--format`		형식: default (포맷됨) 또는 json (원시 JSON 이벤트)
`--title`		세션 제목 (값이 제공되지 않으면 잘린 프롬프트 사용)
`--attach`		실행 중인 opencode 서버에 연결 (예: http://localhost:4096 (opens in a new tab))
`--port`		로컬 서버 포트 (기본값은 랜덤 포트)

serve

API 접근을 위한 헤드리스 OpenCode 서버를 시작합니다. 전체 HTTP 인터페이스는 서버 문서를 확인하세요.

opencode serve

이는 TUI 인터페이스 없이 opencode 기능에 대한 API 접근을 제공하는 HTTP 서버를 시작합니다. HTTP 기본 인증을 활성화하려면 OPENCODE_SERVER_PASSWORD를 설정하세요 (사용자 이름 기본값은 opencode).

플래그

플래그	설명
`--port`	수신할 포트
`--hostname`	수신할 호스트명
`--mdns`	mDNS 검색 활성화
`--cors`	CORS를 허용할 추가 브라우저 출처

session

OpenCode 세션을 관리합니다.

opencode session [command]

list

모든 OpenCode 세션을 나열합니다.

opencode session list

플래그

플래그	축약	설명
`--max-count`	`-n`	최근 N개 세션으로 제한
`--format`		출력 형식: table 또는 json (table)

stats

OpenCode 세션의 토큰 사용량 및 비용 통계를 표시합니다.

opencode stats

플래그

플래그	설명
`--days`	최근 N일 통계 표시 (전체 기간)
`--tools`	표시할 도구 수 (전체)
`--models`	모델 사용량 분석 표시 (기본적으로 숨김). 상위 N개를 표시하려면 숫자 전달
`--project`	프로젝트별 필터 (모든 프로젝트, 빈 문자열: 현재 프로젝트)

export

세션 데이터를 JSON으로 내보냅니다.

opencode export [sessionID]

세션 ID를 제공하지 않으면 사용 가능한 세션 중에서 선택하라는 메시지가 표시됩니다.

import

JSON 파일 또는 OpenCode 공유 URL에서 세션 데이터를 가져옵니다.

opencode import <file>

로컬 파일 또는 OpenCode 공유 URL에서 가져올 수 있습니다.

opencode import session.json
opencode import https://opncd.ai/s/abc123

web

웹 인터페이스가 있는 헤드리스 OpenCode 서버를 시작합니다.

opencode web

이는 HTTP 서버를 시작하고 웹 인터페이스를 통해 OpenCode에 접근할 수 있도록 웹 브라우저를 엽니다. HTTP 기본 인증을 활성화하려면 OPENCODE_SERVER_PASSWORD를 설정하세요 (사용자 이름 기본값은 opencode).

플래그

플래그	설명
`--port`	수신할 포트
`--hostname`	수신할 호스트명
`--mdns`	mDNS 검색 활성화
`--cors`	CORS를 허용할 추가 브라우저 출처

acp

ACP (Agent Client Protocol) 서버를 시작합니다.

opencode acp

이 명령어는 nd-JSON을 사용하여 stdin/stdout을 통해 통신하는 ACP 서버를 시작합니다.

플래그

플래그	설명
`--cwd`	작업 디렉토리
`--port`	수신할 포트
`--hostname`	수신할 호스트명

uninstall

OpenCode를 제거하고 모든 관련 파일을 삭제합니다.

opencode uninstall

플래그

플래그	축약	설명
`--keep-config`	`-c`	설정 파일 유지
`--keep-data`	`-d`	세션 데이터 및 스냅샷 유지
`--dry-run`		삭제하지 않고 삭제될 항목 표시
`--force`	`-f`	확인 프롬프트 건너뛰기

upgrade

opencode를 최신 버전 또는 특정 버전으로 업데이트합니다.

opencode upgrade [target]

최신 버전으로 업그레이드하려면.

opencode upgrade

특정 버전으로 업그레이드하려면.

opencode upgrade v0.1.48

플래그

플래그	축약	설명
`--method`	`-m`	사용된 설치 방법; curl, npm, pnpm, bun, brew

글로벌 플래그

opencode CLI는 다음 글로벌 플래그를 허용합니다.

플래그	축약	설명
`--help`	`-h`	도움말 표시
`--version`	`-v`	버전 번호 출력
`--print-logs`		stderr로 로그 출력
`--log-level`		로그 레벨 (DEBUG, INFO, WARN, ERROR)

환경 변수

OpenCode는 환경 변수를 사용하여 설정할 수 있습니다.

변수	타입	설명
`OPENCODE_AUTO_SHARE`	boolean	세션 자동 공유
`OPENCODE_GIT_BASH_PATH`	string	Windows에서 Git Bash 실행 파일 경로
`OPENCODE_CONFIG`	string	설정 파일 경로
`OPENCODE_CONFIG_DIR`	string	설정 디렉토리 경로
`OPENCODE_CONFIG_CONTENT`	string	인라인 json 설정 내용
`OPENCODE_DISABLE_AUTOUPDATE`	boolean	자동 업데이트 확인 비활성화
`OPENCODE_DISABLE_PRUNE`	boolean	오래된 데이터 정리 비활성화
`OPENCODE_DISABLE_TERMINAL_TITLE`	boolean	자동 터미널 제목 업데이트 비활성화
`OPENCODE_PERMISSION`	string	인라인 json 권한 설정
`OPENCODE_DISABLE_DEFAULT_PLUGINS`	boolean	기본 플러그인 비활성화
`OPENCODE_DISABLE_LSP_DOWNLOAD`	boolean	자동 LSP 서버 다운로드 비활성화
`OPENCODE_ENABLE_EXPERIMENTAL_MODELS`	boolean	실험적 모델 활성화
`OPENCODE_DISABLE_AUTOCOMPACT`	boolean	자동 컨텍스트 압축 비활성화
`OPENCODE_DISABLE_CLAUDE_CODE`	boolean	`.claude` (prompt + skills) 읽기 비활성화
`OPENCODE_DISABLE_CLAUDE_CODE_PROMPT`	boolean	`~/.claude/CLAUDE.md` 읽기 비활성화
`OPENCODE_DISABLE_CLAUDE_CODE_SKILLS`	boolean	`.claude/skills` 로드 비활성화
`OPENCODE_DISABLE_MODELS_FETCH`	boolean	원격 소스에서 모델 가져오기 비활성화
`OPENCODE_FAKE_VCS`	string	테스트용 가짜 VCS 프로바이더
`OPENCODE_DISABLE_FILETIME_CHECK`	boolean	최적화를 위한 파일 시간 확인 비활성화
`OPENCODE_CLIENT`	string	클라이언트 식별자 (기본값 `cli`)
`OPENCODE_ENABLE_EXA`	boolean	Exa 웹 검색 도구 활성화
`OPENCODE_SERVER_PASSWORD`	string	`serve`/`web`에 대한 기본 인증 활성화
`OPENCODE_SERVER_USERNAME`	string	기본 인증 사용자 이름 재정의 (기본값 `opencode`)
`OPENCODE_MODELS_URL`	string	모델 설정을 가져올 사용자 정의 URL

실험적

이러한 환경 변수는 변경되거나 제거될 수 있는 실험적 기능을 활성화합니다.

변수	타입	설명
`OPENCODE_EXPERIMENTAL`	boolean	모든 실험적 기능 활성화
`OPENCODE_EXPERIMENTAL_ICON_DISCOVERY`	boolean	아이콘 검색 활성화
`OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT`	boolean	TUI에서 선택 시 복사 비활성화
`OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS`	number	bash 명령어의 기본 타임아웃 (ms)
`OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX`	number	LLM 응답의 최대 출력 토큰
`OPENCODE_EXPERIMENTAL_FILEWATCHER`	boolean	전체 디렉토리에 대한 파일 감시자 활성화
`OPENCODE_EXPERIMENTAL_OXFMT`	boolean	oxfmt 포매터 활성화
`OPENCODE_EXPERIMENTAL_LSP_TOOL`	boolean	실험적 LSP 도구 활성화
`OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER`	boolean	파일 감시자 비활성화
`OPENCODE_EXPERIMENTAL_EXA`	boolean	실험적 Exa 기능 활성화
`OPENCODE_EXPERIMENTAL_LSP_TY`	boolean	실험적 LSP 타입 검사 활성화
`OPENCODE_EXPERIMENTAL_MARKDOWN`	boolean	실험적 markdown 기능 활성화
`OPENCODE_EXPERIMENTAL_PLAN_MODE`	boolean	계획 모드 활성화

TUI 웹