컨텐츠로 건너뛰기
쇼케이스 생태계 문서

CLI 참조

명령어 빠른 참조

명령어용도
opencode tui터미널 사용자 인터페이스 시작
opencode run프로그래밍 방식으로 프롬프트 실행
opencode serve헤드리스 백엔드 서버 시작
opencode web웹 인터페이스가 있는 백엔드 서버 시작
opencode attach실행 중인 백엔드 서버에 연결
opencode authAI Provider 자격 증명 관리
opencode models사용 가능한 AI 모델 나열
opencode session대화 세션 관리
opencode githubGitHub 에이전트 관리
opencode prGitHub PR 가져오고 체크아웃
opencode export대화 데이터 내보내기
opencode import데이터 가져오기
opencode stats사용 통계 표시
opencode init프로젝트 초기화 및 AGENTS.md 생성

핵심 상호작용 명령어

opencode tui

OpenCode 터미널 사용자 인터페이스(TUI)를 시작합니다. 이는 인수 없이 opencode를 실행할 때의 기본 동작입니다.

구문

opencode tui [options]

예제

# 현재 디렉터리에서 TUI 시작
opencode tui

# TUI 시작 (기본 동작)
opencode

사용 사례

  • 대화형 개발: AI 지원을 통한 일상적인 코딩 작업
  • 프로젝트 탐색: 익숙하지 않은 코드베이스 탐색 및 이해
  • 실시간 협업: 복잡한 문제를 AI와 함께 해결

opencode run

TUI에 들어가지 않고 프로그래밍 방식으로 프롬프트를 실행합니다. 스크립팅 및 자동화에 이상적입니다.

구문

opencode run "<prompt>" [options]

예제

# 단일 프롬프트 실행
opencode run "Explain how closures work in JavaScript"

# 특정 모델 사용
opencode run "Refactor this function" --model anthropic/claude-3.5-sonnet

# 이전 세션에서 계속
opencode run "Continue the refactoring" --continue

사용 사례

  • CI/CD 통합: 자동화된 코드 리뷰 및 제안
  • 일괄 처리: 스크립트에서 여러 프롬프트 처리
  • 빠른 쿼리: TUI를 열지 않고 즉시 답변 얻기

opencode serve

터미널 인터페이스 없이 API 액세스를 제공하는 헤드리스 OpenCode 백엔드 서버를 시작합니다.

구문

opencode serve [options]

예제

# 백엔드 서버 시작
opencode serve

# 사용자 지정 포트에서 서버 시작
opencode serve --port 4096

사용 사례

  • 원격 액세스: 서버에서 OpenCode를 실행하고 클라이언트에서 연결
  • 팀 협업: 단일 OpenCode 인스턴스 공유
  • 통합 개발: 사용자 지정 프론트엔드 또는 도구 구축

opencode web

웹 인터페이스가 있는 백엔드 서버를 시작하여 브라우저를 통해 OpenCode에 액세스할 수 있습니다.

구문

opencode web [options]

옵션

옵션설명
--port수신 대기할 포트 (기본값은 상황에 따라 다름)
--hostname바인딩할 호스트명

예제

# 웹 서버 시작
opencode web

# 특정 포트 및 호스트명으로 시작
opencode web --port 4096 --hostname 0.0.0.0

# 외부 액세스 허용
opencode web --hostname 0.0.0.0

사용 사례

  • 모바일 액세스: 태블릿이나 스마트폰에서 OpenCode 사용
  • 브라우저 선호: 터미널 대신 웹 UI에서 작업
  • 화면 공유: 페어 프로그래밍 중 공유가 더 쉬움

opencode attach

이미 실행 중인 OpenCode 백엔드 서버(serve 또는 web로 시작)에 연결합니다.

구문

opencode attach [url] [options]

옵션

옵션설명
--dirTUI를 시작할 작업 디렉터리
--session, -s계속할 세션 ID

예제

# 원격 서버에 연결
opencode attach http://10.20.30.40:4096

# 연결하고 작업 디렉터리 지정
opencode attach http://server:4096 --dir /path/to/project

# 연결하고 특정 세션 계속
opencode attach http://server:4096 --session abc123

사용 사례

  • 원격 개발: 강력한 서버에서 실행되는 OpenCode에 연결
  • 세션 공유: 여러 사용자가 동일한 백엔드에 연결
  • 재연결: 네트워크 중단 후 작업 재개

인증 관리

opencode auth

AI Provider의 자격 증명 및 인증을 관리합니다.

구문

opencode auth [command]

하위 명령어

opencode auth login

Models.dev가 지원하는 AI Provider의 API 키를 구성합니다. 자격 증명은 ~/.local/share/opencode/auth.json에 저장됩니다.

예제

# 대화형 인증 시작
opencode auth login

# 특정 Provider로 인증
opencode auth login --provider anthropic

사용 사례

  • 초기 설정: 처음 사용 시 OpenCode 구성
  • Provider 전환: 새 AI Provider 자격 증명 추가
  • 키 교체: 보안을 위해 API 키 업데이트

모델 관리

opencode models

구성된 Provider의 사용 가능한 모든 모델을 나열합니다. 모델은 provider/model 형식으로 표시됩니다.

구문

opencode models [provider]

예제

# 사용 가능한 모든 모델 나열
opencode models

# 특정 Provider의 모델 나열
opencode models anthropic

# grep과 함께 사용하여 필터링
opencode models | grep claude

사용 사례

  • 모델 검색: 사용 사례에 맞는 사용 가능한 모델 찾기
  • Provider 비교: 각 Provider가 제공하는 것 확인
  • 구성 참조: 구성 파일에 필요한 정확한 모델 이름 얻기

세션 관리

opencode session

대화 세션을 관리합니다.

구문

opencode session [command]

사용 사례

  • 세션 기록: 과거 대화 검토
  • 컨텍스트 전환: 다른 프로젝트 간 이동
  • 세션 정리: 오래된 세션 아카이브 또는 삭제

GitHub 통합

opencode github

AI 기반 GitHub 워크플로우 자동화를 가능하게 하는 OpenCode의 GitHub 에이전트를 관리합니다.

구문

opencode github [command]

하위 명령어

opencode github install

리포지토리 또는 조직에 대한 GitHub 에이전트를 설치하고 구성합니다.

예제

# GitHub 에이전트 설치
opencode github install

사용 사례

  • 리포지토리 자동화: GitHub 워크플로우를 위한 AI 지원 설정
  • 팀 온보딩: 팀에 대한 AI 코드 리뷰 활성화
  • CI/CD 통합: GitHub Actions에 OpenCode 통합

opencode github run

GitHub 에이전트를 실행하여 이벤트 및 자동화 작업을 처리합니다.

예제

# GitHub 에이전트 실행
opencode github run

사용 사례

  • 자동 리뷰: AI 지원으로 풀 리퀵스트 처리
  • 이슈 분류: 이슈를 자동으로 분석하고 분류
  • 지속적 지원: 진행 중인 작업을 위해 에이전트를 계속 실행

opencode pr

GitHub 풀 리퀵스트 브랜치를 가져와서 체크아웃한 다음 해당 컨텍스트에서 OpenCode를 시작합니다. 이를 통해 코드 리뷰 워크플로우가 간소화됩니다.

구문

opencode pr <number> [options]

예제

# PR #42를 체크아웃하고 OpenCode 시작
opencode pr 42

# 특정 모델로 PR 리뷰
opencode pr 123 --model anthropic/claude-3.5-sonnet

사용 사례

  • 코드 리뷰: 리뷰를 위해 PR 컨텍스트로 빠르게 이동
  • PR 지원: 변경사항을 이해하기 위한 AI 도움 받기
  • 협업: 코멘트하기 전에 AI와 PR 변경사항에 대해 논의

프로젝트 초기화

opencode init

AGENTS.md 파일을 생성하거나 업데이트하여 프로젝트를 초기화하고 OpenCode가 프로젝트 구조를 이해할 수 있도록 합니다.

구문

opencode init

예제

# 현재 프로젝트 초기화
opencode init

# TUI 내에서 실행
/init

사용 사례

  • 새 프로젝트: 새 코드베이스에 OpenCode 설정
  • 프로젝트 업데이트: 구조 변경 시 AGENTS.md 업데이트
  • 컨텍스트 최적화: AI가 프로젝트를 더 잘 이해하도록 지원

데이터 작업

opencode export

대화 데이터를 내보냅니다.

구문

opencode export [options]

사용 사례

  • 문서화: 참조용으로 대화 저장
  • 백업: 중요한 상호작용 아카이브
  • 공유: 대화를 내보내 동료와 공유

opencode import

OpenCode로 데이터를 가져옵니다.

구문

opencode import [options]

사용 사례

  • 마이그레이션: OpenCode 인스턴스 간 데이터 이동
  • 복원: 백업에서 복원
  • 팀 동기화: 공유 대화 기록 가져오기

opencode stats

사용 통계를 표시합니다.

구문

opencode stats

사용 사례

  • 비용 추적: API 사용량 및 비용 모니터링
  • 사용 분석: 상호작용 패턴 이해
  • 예산 관리: 지출 제한 내에서 유지

전역 플래그

이러한 플래그는 대부분의 OpenCode 명령어와 함께 사용하여 동작을 수정할 수 있습니다.

플래그짧은 형식설명
--continue-c마지막 세션에서 계속
--session-s계속할 세션 ID 지정
--prompt-사용할 프롬프트 정의
--model-m모델 지정 (형식: provider/model)
--agent-사용할 에이전트 지정
--port-수신 대기할 포트 정의
--hostname-수신 대기할 호스트명 정의

예제

# 마지막 세션에서 계속
opencode --continue

# 특정 모델 사용
opencode run "Explain this code" --model anthropic/claude-3.5-sonnet

# 사용자 지정 포트에서 시작
opencode web --port 8080