TUI

OpenCode 터미널 사용자 인터페이스 사용법.

OpenCode는 LLM과 함께 프로젝트 작업을 위한 대화형 터미널 인터페이스 또는 TUI를 제공합니다.

OpenCode를 실행하면 현재 디렉토리에 대한 TUI가 시작됩니다.

opencode

또는 특정 작업 디렉토리에 대해 시작할 수 있습니다.

opencode /path/to/project

TUI에 들어가면 메시지로 프롬프트할 수 있습니다.

Give me a quick summary of the codebase.

파일 참조

메시지에서 @를 사용하여 파일을 참조할 수 있습니다. 현재 작업 디렉토리에서 퍼지 파일 검색을 수행합니다.

팁: 메시지에서 파일을 참조하기 위해 @를 사용할 수도 있습니다.

How is auth handled in @packages/functions/src/api/index.ts?

파일의 내용이 대화에 자동으로 추가됩니다.

Bash 명령어

!로 메시지를 시작하면 셸 명령을 실행합니다.

!ls -la

명령의 출력이 도구 결과로 대화에 추가됩니다.

명령어

OpenCode TUI를 사용할 때 / 다음에 명령어 이름을 입력하여 빠르게 액션을 실행할 수 있습니다. 예시:

/help

대부분의 명령어는 ctrl+x를 리더 키로 사용하는 키 바인딩도 있으며, ctrl+x가 기본 리더 키입니다. 자세히 알아보기.

사용 가능한 모든 슬래시 명령어입니다:

connect

OpenCode에 프로바이더를 추가합니다. 사용 가능한 프로바이더에서 선택하고 API 키를 추가할 수 있습니다.

/connect

compact

현재 세션을 압축합니다. 별칭: /summarize

/compact

키 바인딩: ctrl+x c

details

도구 실행 세부 정보를 토글합니다.

/details

키 바인딩: ctrl+x d

editor

메시지 작성을 위해 외부 편집기를 엽니다. EDITOR 환경 변수에 설정된 편집기를 사용합니다. 자세히 알아보기.

/editor

키 바인딩: ctrl+x e

exit

OpenCode를 종료합니다. 별칭: /quit, /q

/exit

키 바인딩: ctrl+x q

export

현재 대화를 Markdown으로 내보내고 기본 편집기에서 엽니다. EDITOR 환경 변수에 설정된 편집기를 사용합니다. 자세히 알아보기.

/export

키 바인딩: ctrl+x x

help

도움말 대화 상자를 표시합니다.

/help

키 바인딩: ctrl+x h

init

AGENTS.md 파일을 생성하거나 업데이트합니다. 자세히 알아보기.

/init

키 바인딩: ctrl+x i

models

사용 가능한 모델을 나열합니다.

/models

키 바인딩: ctrl+x m

new

새 세션을 시작합니다. 별칭: /clear

/new

키 바인딩: ctrl+x n

redo

이전에 실행 취소한 메시지를 다시 실행합니다. /undo 사용 후에만 사용 가능합니다.

팁: 파일 변경 사항도 복원됩니다.

내부적으로 파일 변경 사항을 관리하기 위해 Git을 사용합니다. 따라서 프로젝트가 Git 저장소여야 합니다.

/redo

키 바인딩: ctrl+x r

sessions

세션을 나열하고 전환합니다. 별칭: /resume, /continue

/sessions

키 바인딩: ctrl+x l

현재 세션을 공유합니다. 자세히 알아보기.

/share

키 바인딩: ctrl+x s

themes

사용 가능한 테마를 나열합니다.

/theme

키 바인딩: ctrl+x t

thinking

대화에서 thinking/reasoning 블록의 표시를 토글합니다. 활성화하면 확장된 사고를 지원하는 모델의 추론 과정을 볼 수 있습니다.

참고: 이 명령어는 thinking 블록이 표시되는지만 제어합니다 — 모델의 추론 기능을 활성화하거나 비활성화하지 않습니다. 실제 추론 기능을 토글하려면 ctrl+t를 사용하여 모델 변형 간에 전환하세요.

/thinking

undo

대화에서 마지막 메시지를 실행 취소합니다. 가장 최근 사용자 메시지, 모든 후속 응답, 파일 변경 사항을 제거합니다.

팁: 파일 변경 사항도 되돌려집니다.

내부적으로 파일 변경 사항을 관리하기 위해 Git을 사용합니다. 따라서 프로젝트가 Git 저장소여야 합니다.

/undo

키 바인딩: ctrl+x u

upgrade

OpenCode를 최신 버전으로 업그레이드합니다.

/upgrade

키 바인딩: ctrl+x U

unshare

현재 세션의 공유를 취소합니다. 자세히 알아보기.

/unshare

스크롤

TUI는 다음 키 바인딩을 사용하여 대화를 스크롤할 수 있습니다:

Page Up / Page Down - 한 페이지씩 위/아래로 스크롤
Shift+Up / Shift+Down - 몇 줄씩 위/아래로 스크롤
Home / End - 대화의 맨 위/아래로 이동

설정에서 스크롤 동작을 구성할 수 있습니다:

scroll_acceleration - 부드럽고 자연스러운 스크롤을 위한 macOS 스타일 스크롤 가속을 활성화합니다. 활성화하면 빠른 스크롤 제스처에서 스크롤 속도가 증가하고 느린 움직임에서는 정밀하게 유지됩니다. 이 설정은 scroll_speed보다 우선하며 활성화 시 이를 재정의합니다.
scroll_speed - 스크롤 명령 사용 시 TUI의 스크롤 속도를 제어합니다 (최소: 1). 기본값은 3입니다. 참고: scroll_acceleration.enabled가 true로 설정되면 무시됩니다.

편집기 설정

/editor와 /export 명령어 모두 EDITOR 환경 변수에 지정된 편집기를 사용합니다.

Linux/macOS

# Example for nano or vim
export EDITOR=nano
export EDITOR=vim
 
# For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
# include --wait
export EDITOR="code --wait"

영구적으로 설정하려면 셸 프로필에 추가하세요; ~/.bashrc, ~/.zshrc 등.

Windows (CMD)

set EDITOR=notepad
 
# For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
# include --wait
set EDITOR=code --wait

영구적으로 설정하려면 시스템 속성 > 환경 변수를 사용하세요.

Windows (PowerShell)

$env:EDITOR = "notepad"
 
# For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
# include --wait
$env:EDITOR = "code --wait"

영구적으로 설정하려면 PowerShell 프로필에 추가하세요.

설정

OpenCode 설정 파일을 통해 TUI 동작을 커스터마이즈할 수 있습니다.

opencode.json

옵션

scroll_acceleration - 부드럽고 자연스러운 스크롤을 위한 macOS 스타일 스크롤 가속을 활성화합니다. 활성화하면 빠른 스크롤 제스처에서 스크롤 속도가 증가하고 느린 움직임에서는 정밀하게 유지됩니다. 이 설정은 scroll_speed보다 우선하며 활성화 시 이를 재정의합니다.
scroll_speed - 스크롤 명령 사용 시 TUI의 스크롤 속도를 제어합니다 (최소: 1). 기본값은 3입니다. 참고: scroll_acceleration.enabled가 true로 설정되면 무시됩니다.

커스터마이즈

명령 팔레트(ctrl+x h 또는 /help)를 사용하여 TUI 뷰의 다양한 측면을 커스터마이즈할 수 있습니다. 이 설정은 재시작 후에도 유지됩니다.

사용자 이름 표시

채팅 메시지에 사용자 이름이 표시되는지 토글합니다. 다음을 통해 접근하세요:

명령 팔레트: "username" 또는 "hide username" 검색
설정은 자동으로 저장되며 TUI 세션 간에 기억됩니다

Windows (WSL)CLI

TUI