CLI

opencode CLI options and commands.

기본적으로 opencode CLI는 어떤 인수 없이 실행할 때 TUI를 시작합니다.

opencode

그러나이 페이지에서 문서로 명령을받습니다. opencode programmatically와 상호 작용할 수 있습니다.

opencode run "Explain how closures work in JavaScript"

튜이

opencode terminal 사용자 인터페이스를 시작합니다.

opencode [project]

플래그

플래그	짧은 이름	설명
`--continue`	`-c`	마지막 세션 계속하기
`--session`	`-s`	계속할 세션 ID
`--fork`		계속 시 세션 포크하기 (`--continue` 또는 `--session`과 함께 사용)
`--prompt`		사용할 프롬프트
`--model`	`-m`	`provider/model` 형식의 모델
`--agent`		사용할 에이전트
`--port`		수신 대기할 포트
`--hostname`		수신 대기할 호스트명

명령

opencode CLI에는 다음과 같은 명령이 있습니다.

에이전트

opencode에 대한 에이전트 관리.

opencode agent [command]

첨부

serve 또는 web 명령을 통해 이미 실행되는 opencode 백엔드 서버에 terminal을 첨부합니다.

opencode attach [url]

리모트 opencode 백엔드를 사용하여 TUI를 사용할 수 있습니다. 예를 들면:

# Start the backend server for web/mobile access
opencode web --port 4096 --hostname 0.0.0.0

# In another terminal, attach the TUI to the running backend
opencode attach http://10.20.30.40:4096

플래그

플래그	플래그	Description
`--dir`		TUI를 시작하는 작업 디렉토리
`--session`	`-s`	세션 ID

생성

사용자 정의 구성으로 새로운 에이전트를 만듭니다.

opencode agent create

이 명령은 사용자 정의 시스템 프롬프트 및 도구 구성으로 새로운 에이전트를 만들기 위해 안내합니다.

리스트

모든 사용 가능한 에이전트 목록.

opencode agent list

auth

credentials 및 로그인을 관리하는 명령.

opencode auth [command]

리스트

credentials 파일에 저장 한 모든 인증 된 제공 업체를 나열합니다.

opencode auth list

또는 짧은 버전.

opencode auth ls

로그아웃

credentials 파일에서 삭제하여 공급자에서 로그.

opencode auth logout

github에

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

opencode github [command]

설치

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

opencode github install

필요한 GitHub Actions 워크플로우를 설정하고 구성 프로세스를 통해 안내합니다. 더 알아보기.

실행

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

opencode github run

플래그

플래그	설명
`--event`	GitHub 모의 이벤트
`--token`	GitHub 개인 액세스 토큰

mcp를

Model Context Protocol 서버 관리

opencode mcp [command]

추가

MCP 서버를 구성에 추가합니다.

opencode mcp add

이 명령은 로컬 또는 원격 MCP 서버를 추가하여 안내합니다.

리스트

모든 구성 MCP 서버와 연결 상태를 나열합니다.

opencode mcp list

또는 짧은 버전을 사용합니다.

opencode mcp ls

auth

OAuth-enabled MCP 서버 인증

opencode mcp auth [name]

서버 이름을 제공하지 않으면 OAuth-capable 서버에서 선택할 수 있습니다.

OAuth-capable 서버와 인증 상태를 나열할 수 있습니다.

opencode mcp auth list

또는 짧은 버전을 사용합니다.

opencode mcp auth ls

로그아웃

MCP 서버의 OAuth 자격 제거.

opencode mcp logout [name]

디버그

MCP 서버의 OAuth 연결 문제.

opencode mcp debug <name>

모델

구성 공급자에서 모든 가능한 모델을 나열합니다.

opencode models [provider]

이 명령은 provider/model 형식으로 구성된 제공 업체에서 사용할 수있는 모든 모델을 표시합니다.

이것은 your config에서 사용하는 정확한 모델 이름을 파악하는 데 유용합니다.

선택적으로 공급자 ID를 필터 모델로 전달할 수 있습니다.

opencode models anthropic

플래그

플래그	설명
`--refresh`	모델 캐시를 모델에서 새로 고침
`--verbose`	더 많은 verbose 모델 출력 사용(비용과 같은 메타데이터 포함)

--refresh 플래그를 사용하여 캐시 모델 목록을 업데이트합니다. 이것은 새로운 모델이 공급자에 추가되었을 때 유용합니다. opencode에서 그들을보고 싶습니다.

opencode models --refresh

실행

직접 프롬프트를 통과하여 비동기 모드에서 opencode를 실행합니다.

opencode run [message..]

이것은 스크립트, 자동화 또는 전체 TUI를 실행하지 않고 빠른 응답을 원할 때 유용합니다. 예를 들어.

opencode run Explain the use of context in Go

opencode serve 인스턴스를 실행하여 MCP 서버 콜드 부팅 시간을 각 실행할 수 있습니다.

# Start a headless server in one terminal
opencode serve

# In another terminal, run commands that attach to it
opencode run --attach http://localhost:4096 "Explain async/await in JavaScript"

플래그

플래그	짧은 이름	설명
`--command`		실행 중인 명령 사용(미지정 시 args의 메시지 사용)
`--continue`	`-c`	마지막 세션
`--session`	`-s`	세션 ID
`--share`		세션 공유
`--model`	`-m`	`-m`의 형태로 사용 가능
`--agent`		에이전트
`--file`	`-f`	메시지 첨부 파일
`--format`		출력 형식: formatted 또는 json(raw JSON 이벤트)
`--title`		세션의 제목(제공되지 않은 경우 truncated prompt 사용)
`--attach`		운영 개시 서버(예: http://localhost:4096)
`--port`		현지 서버 포트

서비스

API 액세스를 위한 headless opencode 서버를 시작합니다. 완전한 HTTP 인터페이스를 위해 server docs를 체크하십시오.

opencode serve

TUI 인터페이스없이 API 액세스를 제공하는 HTTP 서버를 시작합니다. OPENCODE_SERVER_PASSWORD를 설정하여 HTTP 기본 auth (opencode에 기본적으로 이름을 지정합니다).

플래그

플래그	설명
`--port`	포트
`--hostname`	듣고 싶은 이름
`--mdns`	엔터블 mDNS 검색
`--cors`	CORS를 허용하는 추가 브라우저 기원

세션

opencode 세션 관리.

opencode session [command]

리스트

모든 opencode 세션 목록.

opencode session list

플래그

플래그	짧은 이름	설명
`--max-count`	`-n`	최근 세션에 제한
`--format`		출력 형식: table 또는 json

통계

opencode 세션에 대한 토큰 사용 및 비용 통계를 표시합니다.

opencode stats

플래그

플래그	설명
`--days`	지난 N일간의 통계를 보여 주세요(모든 시간)
`--tools`	쇼의 도구 수
`--models`	모델 사용 내역(기본적으로 숨겨져 있음) 상단 N을 표시할 수 있는 번호
`--project`	프로젝트별 필터링(모든 프로젝트, 빈 문자열: 현재 프로젝트)

수출

JSON으로 세션 데이터를 내보내기.

opencode export [sessionID]

세션 ID를 제공하지 않는 경우 사용 가능한 세션에서 선택할 수 있습니다.

가져오기

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

opencode import <file>

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

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

웹

웹 인터페이스로 headless opencode 서버를 시작합니다.

opencode web

HTTP 서버를 시작하고 웹 인터페이스를 통해 opencode에 액세스하는 웹 브라우저를 엽니 다. OPENCODE_SERVER_PASSWORD를 설정하여 HTTP 기본 auth (opencode에 기본적으로 이름을 지정합니다).

플래그

플래그	설명
`--port`	포트
`--hostname`	듣고 싶은 이름
`--mdns`	엔터블 mDNS 검색
`--cors`	CORS를 허용하는 추가 브라우저 기원

acp

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

opencode acp

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

플래그

플래그	설명
`--cwd`	작업 디렉토리
`--port`	포트
`--hostname`	듣고 싶은 이름

제거

opencode 제거하고 관련 파일을 제거합니다.

opencode uninstall

플래그

플래그	플래그	Description
`--keep-config`	`-c`	구성 파일 유지
`--keep-data`	`-d`	세션 데이터 및 스냅샷 유지
`--dry-run`		제거하지 않고 제거하는 것
`--force`	`-f`	확인 프롬프트

업그레이드

업데이트 opencode 최신 버전 또는 특정 버전.

opencode upgrade [target]

최신 버전으로 업그레이드하십시오.

opencode upgrade

특정 버전으로 업그레이드하십시오.

opencode upgrade v0.1.48

플래그

플래그	플래그	Description
`--method`	`-m`	사용중인 설치 방법; 컬, npm, pnpm, bun, brew

글로벌 플래그

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

플래그	짧은 이름	설명
`--help`	`-h`	디스플레이 도움말
`--version`	`-v`	인쇄판 번호
`--print-logs`		스터디로 로그인
`--log-level`		로그 레벨(DEBUG, INFO, WARN, ERROR)

환경 변수

opencode는 환경 변수를 사용하여 구성할 수 있습니다.

변하기 쉬운	유형	묘사
`OPENCODE_AUTO_SHARE`	불린	자동 공유 세션
`OPENCODE_GIT_BASH_PATH`	string	Windows에서 실행되는 Git Bash 경로
`OPENCODE_CONFIG`	string	설정파일 경로
`OPENCODE_CONFIG_DIR`	string	구성 디렉토리 경로
`OPENCODE_CONFIG_CONTENT`	문자열	인라인 json 구성 내용
`OPENCODE_DISABLE_AUTOUPDATE`	불린	자동 업데이트 체크 아웃
`OPENCODE_DISABLE_PRUNE`	boolean	오래된 자료의 무능
`OPENCODE_DISABLE_TERMINAL_TITLE`	불린	자동 단말 제목 업데이트
`OPENCODE_PERMISSION`	문자열	인라인 json 권한 설정
`OPENCODE_DISABLE_DEFAULT_PLUGINS`	불린	기본 플러그인 비활성화
`OPENCODE_DISABLE_LSP_DOWNLOAD`	불린	자동 LSP 서버 다운로드
`OPENCODE_ENABLE_EXPERIMENTAL_MODELS`	불린	실험 모델
`OPENCODE_DISABLE_AUTOCOMPACT`	boolean	자동 컨텍스트 컴팩트
`OPENCODE_DISABLE_CLAUDE_CODE`	boolean	`.claude`(prompt + Skill)의 읽을 수 있음
`OPENCODE_DISABLE_CLAUDE_CODE_PROMPT`	불린	`~/.claude/CLAUDE.md`를 읽을 수 있습니다
`OPENCODE_DISABLE_CLAUDE_CODE_SKILLS`	불린	`.claude/skills` 적재 가능
`OPENCODE_DISABLE_MODELS_FETCH`	boolean	리모트 소스에서 모델에 익숙하지 않은 모델
`OPENCODE_FAKE_VCS`	string	시험용 VCS 제공업체
`OPENCODE_DISABLE_FILETIME_CHECK`	boolean	최적화를 위한 파일 시간 검사
`OPENCODE_CLIENT`	string	클라이언트 식별자(`cli`와 동일)
`OPENCODE_ENABLE_EXA`	불린	엑다 웹 검색 도구
`OPENCODE_SERVER_PASSWORD`	string	`serve`/`web`에 대한 기본 요점
`OPENCODE_SERVER_USERNAME`	string	기본 사용자 이름(기본 `opencode`)
`OPENCODE_MODELS_URL`	string	모델 구성의 맞춤 URL

실험

이 환경변수는 변화하거나 제거될 수 있는 실험적인 특징을 가능하게 합니다.

변하기 쉬운	유형	묘사
`OPENCODE_EXPERIMENTAL`	불린	모든 실험적인 특징
`OPENCODE_EXPERIMENTAL_ICON_DISCOVERY`	boolean	아이콘 검색
`OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT`	불린	TUI의 선택 해제
`OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS`	번호	ms에서 bash 명령의 기본 시간
`OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX`	번호	LLM 응답을 위한 최대 Output Tokens
`OPENCODE_EXPERIMENTAL_FILEWATCHER`	boolean	전체 디디터용 파일워커
`OPENCODE_EXPERIMENTAL_OXFMT`	불린	엔블 oxfmt 형식
`OPENCODE_EXPERIMENTAL_LSP_TOOL`	불린	실험적인 LSP 도구
`OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER`	boolean	사용 가능한 파일워커
`OPENCODE_EXPERIMENTAL_EXA`	boolean	실험용 Exa 기능
`OPENCODE_EXPERIMENTAL_LSP_TY`	불린	실험적인 LSP형 검사
`OPENCODE_EXPERIMENTAL_MARKDOWN`	boolean	실험용 마운팅 기능
`OPENCODE_EXPERIMENTAL_PLAN_MODE`	불린	플랜 모드