키보드 단축키 참조

기본 키보드 단축키

일반 단축키

단축키	동작
`Ctrl+X H`	도움말 대화 상자 표시
`Ctrl+X N`	새 세션 시작
`Ctrl+X U`	이전 메시지 실행 취소
`Ctrl+X R`	취소된 메시지 다시 실행
`Ctrl+X C`	현재 세션 압축/요약
`Ctrl+X M`	사용 가능한 모델 목록 표시
`Ctrl+X L`	세션 목록 표시 및 전환
`Ctrl+X S`	대화 공유를 위한 공개 링크 생성
`Ctrl+X X`	대화를 Markdown으로 내보내기
`Ctrl+X E`	메시지용 외부 편집기 열기
`Ctrl+X I`	AGENTS.md 생성/업데이트
`Ctrl+X D`	도구 실행 세부 정보 표시 전환
`Ctrl+X Q`	OpenCode 종료

탐색 단축키

단축키	동작
`위쪽 화살표`	명령어 히스토리 순회
`아래쪽 화살표`	명령어 히스토리 순회
`Tab`	명령어 및 파일 경로 자동 완성
`Ctrl+C`	현재 입력 취소
`Ctrl+L`	터미널 화면 지우기

편집기 단축키

단축키	동작
`Ctrl+A`	커서를 줄 처음으로 이동
`Ctrl+E`	커서를 줄 끝으로 이동
`Ctrl+K`	커서에서 줄 끝까지 삭제
`Ctrl+U`	전체 줄 삭제
`Ctrl+W`	커서 앞 단어 삭제
`Alt+F`	한 단어 앞으로 이동
`Alt+B`	한 단어 뒤로 이동

키보드 단축키 사용자 정의

OpenCode에서는 작업 흐름과 기호에 맞게 키보드 단축키를 사용자 정의할 수 있습니다. 사용자 정의 단축키를 구성하는 방법은 다음과 같습니다:

구성 파일

단축키는 OpenCode 구성 파일에서 설정됩니다. 위치는 운영 체제에 따라 다릅니다:

macOS/Linux:

~/.config/opencode/config.toml
# 또는
$XDG_CONFIG_HOME/opencode/config.toml

Windows:

%APPDATA%\opencode\config.toml

구성 형식

단축키를 사용자 정의하려면 구성 파일에 [shortcuts] 섹션을 추가합니다:

[shortcuts]
# 일반 단축키
help = "Ctrl+X H"
new_session = "Ctrl+X N"
undo = "Ctrl+X U"
redo = "Ctrl+X R"
compact = "Ctrl+X C"
models = "Ctrl+X M"
sessions = "Ctrl+X L"
share = "Ctrl+X S"
export = "Ctrl+X X"
external_editor = "Ctrl+X E"
init = "Ctrl+X I"
toggle_details = "Ctrl+X D"
exit = "Ctrl+X Q"

키 구문

단축키를 정의할 때 다음 구문을 사용합니다:

Ctrl+는 Control 키를 나타냅니다
Alt+는 Alt/Option 키를 나타냅니다
Shift+는 Shift 키를 나타냅니다
단일 문자 또는 숫자

예:

Ctrl+X H (Control + X 다음 H)
Alt+S (Alt + S)
Ctrl+Shift+Q (Control + Shift + Q)

키보드 단축키의 효율성 이점

키보드 단축키는 OpenCode에서 작업 흐름 효율성을 크게 향상시킵니다. 다음과 같이 생산성을 향상시킵니다:

1. 더 빠른 탐색

명령에 빠르게 액세스: 메뉴 탐색 없이 일반 작업 실행
마우스 사용 감소: 키보드와 마우스 간의 컨텍스트 전환 최소화
단순화된 작업 흐름: 더 적은 키 입력으로 작업 수행

2. 컨텍스트 전환 감소

집중력 유지: 작업 흐름 유지
인지 부하 감소: 근육 기억으로 의사 결정 감소
연속 작업 흐름: 사고를 방해하지 않고 명령 실행

3. 생산성 향상

시간 절약: 빠른 작업이 시간이 지남에 따라 누적됨
일괄 처리: 여러 명령을 빠르게 실행
일관성: 세션 전체에서 표준화된 단축키

4. 인간 공학적 이점

스트레스 감소: 마우스 이동 및 클릭 감소
편안한 자세: 자연스러운 손 위치 유지
지속 가능한 코딩: 더 나은 자세 및 피로 감소

고급 단축키 기술

코드 단축키

OpenCode는 Ctrl+X H와 같은 많은 명령에 코드 단축키(두 키 조합)를 사용합니다. 이를 통해 충돌 없이 더 많은 고유 단축키를 사용할 수 있습니다.

코드 단축키 사용 방법:

첫 번째 키 조합을 누르고 유지합니다 (예: Ctrl+X)
두 키를 모두 놓습니다
두 번째 키를 누릅니다 (예: H)

사용자 정의 명령 단축키

사용자 정의 명령을 만들고 단축키를 할당할 수 있습니다. 사용자 정의 명령 만들기에 대한 자세한 내용은 슬래시 명령 참조를 참조하세요.

단축키 학습 팁

가장 일반적인 단축키부터 시작: Ctrl+X N (새 세션), Ctrl+X H (도움말), Ctrl+X Q (종료)에 초점 맞추기
도움말 대화 상자 사용: Ctrl+X H를 눌러 사용 가능한 모든 단축키 표시
정기적으로 연습: 반복을 통해 근육 기억 구축
치트 시트 만들기: 단축키 테이블을 인쇄하거나 저장하여 빠르게 참조
작업 흐름에 맞게 사용자 정의: 가장 자주 사용하는 작업에 맞게 단축키 조정

단축키 문제 해결

일반적인 문제

단축키 작동하지 않음: 시스템 또는 터미널 단축키와의 충돌 확인
일관되지 않은 동작: 올바른 코드 시퀀스를 사용하는지 확인
사용자 정의 단축키 인식되지 않음: 구성 파일의 구문 확인
터미널별 문제: 일부 터미널에서는 특정 키 조합이 다르게 처리될 수 있음

터미널 호환성

단축키에 문제가 있는 경우 터미널 에뮬레이터 설정을 확인하세요. 일부 터미널에서는 특정 키 조합을 올바르게 처리하기 위해 특정 구성이 필요합니다.

기본값으로 재설정

모든 단축키를 기본값으로 재설정하려면 구성 파일에서 [shortcuts] 섹션을 제거하거나 사용자 정의를 주석 처리하세요.

요약

키보드 단축키는 OpenCode 작업 흐름을 강화하는 강력한 도구입니다. 단축키를 학습하고 사용자 정의함으로써 다음과 같은 이점을 얻을 수 있습니다:

더 빠르게 작업하여 키 입력과 마우스 사용 감소
집중力 유지하여 컨텍스트 전환 최소화
피로 감소하여 인간 공학적 키 조합을 통해 편안하게 작업
환경 사용자 정의하여 기호에 맞게 조정

가장 일반적인 단축키를 학습하고 점진적으로 작업 흐름에 통합하세요. 시간이 지남에 따라 이들은 두 번째 본능이 되어 더 효율적이고 효과적으로 OpenCode를 사용할 수 있게 됩니다.