컨텐츠로 건너뛰기

슬래시 명령 참조

명령 빠른 참조

명령별칭단축키목적
/help-Ctrl+X H도움말 대화상자 표시
/new/clearCtrl+X N새 세션 시작
/undo-Ctrl+X U마지막 메시지 취소
/redo-Ctrl+X R취소한 메시지 다시 실행
/compact/summarizeCtrl+X C현재 세션 압축/요약
/connect--AI 공급자 추가
/models-Ctrl+X M사용 가능한 모델 나열
/sessions/resume, /continueCtrl+X L세션 나열 및 전환
/share-Ctrl+X S대화를 공유할 공개 링크 생성
/unshare--현재 세션 공유 해제
/export-Ctrl+X X대화를 Markdown으로 내보내기
/themes--사용 가능한 테마 나열
/editor-Ctrl+X E외부 편집기로 메시지 작성
/init-Ctrl+X IAGENTS.md 생성/업데이트
/details-Ctrl+X D도구 실행 세부정보 표시 전환
/thinking--AI 사고 과정 표시 전환
/exit/quit, /qCtrl+X QOpenCode 종료

세션 제어

/new

새 대화 세션을 시작합니다. 현재 컨텍스트를 지우고 새로 시작합니다.

별칭: /clear
단축키: Ctrl+X N

사용 사례

  • 새 작업: 다른 문제 작업 시작
  • 컨텍스트 재설정: 토큰 사용을 줄이기 위해 누적된 컨텍스트 지우기
  • 새로운 시작: 이전 대화 기록 없이 시작

/undo

대화에서 마지막 메시지를 취소합니다. Git 저장소가 필요합니다.

단축키: Ctrl+X U

사용 사례

  • 실수 수정: 잘못된 질문 제거
  • 흐름 제어: 다른 접근 방식을 시도하기 위해 대화 되돌리기
  • 컨텍스트 정리: 대화를 벗어나게 한 메시지 제거

/redo

이전에 취소한 메시지를 다시 실행합니다. Git 저장소가 필요합니다.

단축키: Ctrl+X R

사용 사례

  • 메시지 복원: 취소한 콘텐츠 가져오기
  • 흐름 복구: 취소 후 대화 흐름 복원
  • 실험: 다른 대화 경로 시도

/compact

컨텍스트를 유지하면서 토큰 사용을 줄이기 위해 현재 세션을 압축하고 요약합니다.

별칭: /summarize
단축키: Ctrl+X C

사용 사례

  • 긴 대화: 확장된 세션에서 토큰 감소
  • 비용 최적화: 컨텍스트를 유지하면서 API 비용 절감
  • 성능: 컨텍스트 크기를 줄여 응답 속도 향상

탐색 및 전환

/models

구성된 공급자의 사용 가능한 모든 AI 모델 목록을 표시합니다.

단축키: Ctrl+X M

사용 사례

  • 모델 선택: 현재 작업에 가장 적합한 모델 선택
  • 공급자 비교: 각 공급자가 제공하는 모델 확인
  • 기능 매칭: 특정 기능을 가진 모델 찾기

/sessions

모든 대화 세션을 나열하고 전환합니다.

별칭: /resume, /continue
단축키: Ctrl+X L

사용 사례

  • 컨텍스트 전환: 다른 프로젝트 간 이동
  • 세션 기록: 과거 대화 검토
  • 다중 프로젝트 작업: 여러 진행 중인 작업 관리

/themes

TUI 인터페이스에서 사용 가능한 색상 테마를 나열합니다.

사용 사례

  • UI 사용자 정의: OpenCode 인터페이스 개인화
  • 가시성: 가독성 향상을 위해 색상 조정
  • 선호도: 터미널 테마에 맞추기

도구 통합

/editor

더 긴 메시지나 프롬프트를 작성하기 위해 외부 편집기를 엽니다.

단축키: Ctrl+X E

사용 사례

  • 긴 프롬프트: 상세한 지침 작성
  • 포맷된 입력: 편집기 기능 사용
  • 여러 줄 메시지: 복잡한 쿼리를 더 쉽게 작성

/export

현재 대화를 Markdown 형식으로 내보냅니다.

단축키: Ctrl+X X

사용 사례

  • 문서화: 참조를 위해 대화 저장
  • 공유: 팀 구성원과 대화 공유
  • 보관: 중요한 상호작용 기록 보존

/share

현재 대화에 대한 공개 공유 링크를 만듭니다.

단축키: Ctrl+X S

사용 사례

  • 협업: 동료와 대화 공유
  • 지원 요청: 도움을 요청할 때 컨텍스트 제공
  • 지식 공유: 유용한 AI 상호작용 배포

/unshare

이전에 공유한 대화에 대한 공개 액세스를 제거합니다.

사용 사례

  • 개인정보 제어: 대화에 대한 공개 액세스 취소
  • 정리: 오래된 공유 링크 제거
  • 보안: 실수로 공유한 민감한 콘텐츠 공유 해제

시스템 구성

/connect

OpenCode에 새 AI 공급자를 대화식으로 추가합니다.

사용 사례

  • 설정: 새 AI 공급자 구성
  • 공급자 추가: 더 많은 모델 옵션 추가
  • 키 업데이트: 공급자 자격 증명 업데이트 또는 변경

/init

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

단축키: Ctrl+X I

사용 사례

  • 프로젝트 설정: 새 프로젝트용 OpenCode 초기화
  • 컨텍스트 개선: AI가 프로젝트 구조를 이해하도록 지원
  • 구성: 프로젝트 메타데이터 업데이트

/details

세부 도구 실행 정보 표시를 전환합니다.

단축키: Ctrl+X D

사용 사례

  • 디버깅: AI가 실행하는 도구 확인
  • 학습: OpenCode 작동 방식 이해
  • 투명성: AI 작업을 세부적으로 모니터링

/thinking

AI 사고 과정 및 추론 표시를 전환합니다.

사용 사례

  • 이해: AI가 문제에 접근하는 방법 확인
  • 디버깅: 추론 문제 식별
  • 학습: AI 문제 해결 접근 방식에서 배우기

도움말 및 종료

/help

사용 가능한 명령 및 단축키가 포함된 도움말 대화상자를 표시합니다.

단축키: Ctrl+X H

사용 사례

  • 빠른 참조: 사용 가능한 명령 조회
  • 학습: 새로운 기능 발견
  • 단축키: 키보드 단축키 찾기

/exit

OpenCode TUI를 종료합니다.

별칭: /quit, /q
단축키: Ctrl+X Q


특수 구문

파일 참조: @filename

프롬프트 내에서 파일 내용을 참조하여 대화 컨텍스트에 추가합니다.

구문

@path/to/file.ext

이 코드를 설명하세요: @src/main.go

@components/Header.tsx를 훅을 사용하도록 리팩토링

이 파일들을 검토하세요: @api/users.ts @api/auth.ts

사용 사례

  • 코드 검토: AI가 특정 파일을 분석하도록 요청
  • 리팩토링: 코드 변경을 위한 컨텍스트 제공
  • 설명: 코드에 대한 자세한 설명 얻기

Shell 명령: !command

Shell 명령을 실행하고 출력을 대화 컨텍스트에 포함합니다.

구문

!shell-command

최근에 무엇이 변경되었나요? !git log -10 --oneline

테스트 실패 분석: !npm test

디렉토리 구조 검토: !tree -L 2 src/

사용 사례

  • 동적 컨텍스트: 현재 시스템 상태 포함
  • 오류 분석: AI와 오류 출력 공유
  • 상태 확인: 질문에 명령 출력 포함

사용자 정의 명령

특정 디렉토리에 Markdown 파일을 배치하여 사용자 정의 슬래시 명령을 만들 수 있습니다.

파일 위치

프로젝트 수준(모든 플랫폼):

<PROJECT_DIR>/.opencode/commands/

전역 수준(macOS/Linux):

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

전역 수준(Windows):

%APPDATA%\opencode\commands\

파일 형식

사용자 정의 명령 파일은 YAML 프론트매터가 있는 Markdown을 사용합니다:

---
description: 명령에 대한 간단한 설명
agent: optional-agent-name
model: optional-model-name
---

명령 내용 또는 프롬프트 템플릿.

자리 표시자를 사용할 수 있습니다:
- $ARGUMENTS 사용자 제공 인수용
- @filename 파일 참조용
- !command shell 명령용

명명

파일 이름(.md 확장자 제외)이 명령 이름이 됩니다:

  • review-pr.md/review-pr
  • generate-tests.md/generate-tests

파일: .opencode/commands/review-pr.md

---
description: 풀 리퀘스트 변경 사항 검토
model: anthropic/claude-3.5-sonnet
---

다음 PR 변경 사항을 검토하고 제공하세요:
1. 코드 품질 평가
2. 잠재적 버그 또는 문제
3. 개선 제안

!git diff origin/main...HEAD

파일: .opencode/commands/explain.md

---
description: 코드를 자세히 설명
---

다음을 자세히 설명하세요: @$ARGUMENTS

포함 사항:
- 목적 및 기능
- 주요 구성 요소
- 사용되거나 위반된 모범 사례
- 개선 제안

모범 사례

추가 팁:

  • 명령을 단일 작업에 집중
  • 설명적인 이름 사용
  • 예상 인수 문서화
  • 먼저 안전한 환경에서 명령 테스트
  • 프로젝트 수준 명령 버전 관리