데스크톱 앱

OpenCode는 그래픽 인터페이스를 갖춘 네이티브 데스크톱 애플리케이션으로 사용할 수 있으며, 더 사용자 친화적인 환경에서 동일한 강력한 AI 코딩 기능을 제공합니다.

다운로드

릴리스 페이지 또는 opencode.ai/download에서 직접 데스크톱 앱을 다운로드하세요.

플랫폼	다운로드
macOS (Apple Silicon)	opencode-desktop-darwin-aarch64.dmg
macOS (Intel)	opencode-desktop-darwin-x64.dmg
Windows	opencode-desktop-windows-x64.exe
Linux	.deb, .rpm, 또는 AppImage

패키지 관리자 설치

macOS (Homebrew)

brew install --cask opencode-desktop

Windows (Scoop)

scoop bucket add extras
scoop install extras/opencode-desktop

기능

데스크톱 앱은 터미널 버전의 모든 기능에 추가적인 이점을 제공합니다:

그래픽 인터페이스

친숙한 UI를 갖춘 네이티브 데스크톱 창
드래그 앤 드롭 파일 지원
시스템 트레이 통합
키보드 단축키
다중 창 지원

세션 관리

여러 동시 세션
세션 기록 및 북마크
링크를 통한 세션 공유
세션 로그 내보내기

에디터 통합

구문 강조가 포함된 내장 코드 에디터
코드 변경을 위한 차이 뷰어
파일 트리 탐색
빠른 파일 검색

인증

CLI에서 사용할 수 있는 모든 인증 방법이 데스크톱 앱에서도 사용할 수 있습니다:

OpenCode Zen: 내장 무료 모델
GitHub Copilot: 기존 구독 사용
ChatGPT Plus/Pro: 직접 통합
사용자 지정 API 키: 모든 제공업체 구성

구성

데스크톱 앱은 구성을 다음 위치에 저장합니다:

macOS: ~/Library/Application Support/opencode/
Windows: %APPDATA%\opencode\
Linux: ~/.config/opencode/

설정 파일

구성은 config.json에 저장됩니다:

{
  "theme": "dark",
  "fontSize": 14,
  "model": "zen-default",
  "language": "ko"
}

키보드 단축키

작업	단축키
새 세션	`Cmd/Ctrl + N`
파일 열기	`Cmd/Ctrl + O`
저장	`Cmd/Ctrl + S`
찾기	`Cmd/Ctrl + F`
사이드바 전환	`Cmd/Ctrl + B`
설정	`Cmd/Ctrl + ,`
종료	`Cmd/Ctrl + Q`

자동 업데이트

데스크톱 앱은 시작 시 자동으로 업데이트를 확인합니다. 수동으로 업데이트를 확인할 수도 있습니다:

macOS: OpenCode → 업데이트 확인...
Windows: 도움말 → 업데이트 확인
Linux: 도움말 → 업데이트 확인

CLI와 비교

기능	데스크톱 앱	CLI
그래픽 인터페이스	✅	❌
다중 세션	✅	✅
세션 공유	✅	✅
파일 탐색	GUI	터미널
리소스 사용량	높음	낮음
자동화/스크립팅	제한적	✅
원격 액세스	❌	✅

문제 해결

앱이 시작되지 않음

다른 인스턴스가 이미 실행 중인지 확인
시스템 요구 사항(Node.js 18+) 확인
방화벽 설정 확인

인증 문제

먼저 터미널에서 opencode auth login 실행
API 키 유효성 확인
네트워크 연결 확인

성능 문제

동시 세션 수 줄이기
세션 기록 지우기
사용 가능한 시스템 메모리 확인

베타 상태

데스크톱 앱은 현재 베타입니다. 일상 사용에 안정적이지만 다음과 같은 문제가 발생할 수 있습니다:

가끔 UI 글리치
버전 간 기능 변경
성능 변동

데스크톱 경험을 개선하기 위해 피드백을 적극적으로 수집합니다. GitHub Issues 페이지에서 문제를 보고해 주세요.