한국어
문서
CLI

CLI

OpenCode CLI는 OpenCode 기능에 대한 명령줄 접근을 제공합니다. 기본적으로 opencode를 실행하면 터미널 사용자 인터페이스(TUI)가 시작됩니다.

opencode

프로그래매틱 상호작용을 위해 명령어 전달:

opencode run "Explain how closures work in JavaScript"

TUI 플래그

플래그축약목적
--continue-c이전 세션 재개
--session-s세션 ID 지정
--prompt—초기 프롬프트 제공
--model-m모델 설정 (프로바이더/모델)
--agent—에이전트 선택

명령어

run

비대화형 모드로 OpenCode 실행:

opencode run [message..]

플래그:

  • --continue, -c: 마지막 세션 재개
  • --model, -m: 모델 설정
  • --file, -f: 파일 첨부
  • --format: default 또는 json으로 출력

auth

인증 정보 관리:

opencode auth login    # API 키 설정
opencode auth list     # 프로바이더 표시
opencode auth logout   # 인증 정보 제거

models

사용 가능한 모델 목록:

opencode models [provider]
opencode models --refresh  # 캐시된 목록 업데이트
opencode models --verbose  # 비용 표시

session

세션 관리:

opencode session list
opencode session list --format json

serve

헤드리스 HTTP 서버 시작:

opencode serve --port 4096

web

웹 인터페이스로 서버 시작:

opencode web --port 4096

agent

에이전트 관리:

opencode agent create  # 사용자 정의 에이전트 생성
opencode agent list    # 에이전트 목록

mcp

MCP 서버 관리:

opencode mcp add       # 서버 추가
opencode mcp list      # 서버 표시
opencode mcp auth      # 인증
opencode mcp debug     # 문제 해결

stats

사용 통계 표시:

opencode stats --days 30
opencode stats --models

upgrade

OpenCode 업데이트:

opencode upgrade           # 최신 버전
opencode upgrade v0.1.48   # 특정 버전

글로벌 플래그

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

환경 변수

핵심 설정

변수목적
OPENCODE_CONFIG설정 파일 경로
OPENCODE_CONFIG_DIR설정 디렉토리
OPENCODE_CONFIG_CONTENT인라인 JSON 설정

기능

변수목적
OPENCODE_DISABLE_AUTOUPDATE업데이트 비활성화
OPENCODE_ENABLE_EXPERIMENTAL_MODELS실험적 모델 활성화
OPENCODE_DISABLE_AUTOCOMPACT압축 비활성화
TUIIDE