Claude Code Sidebar

Obsidian 사이드바에서 Claude Code CLI를 직접 실행할 수 있는 플러그인입니다. 완전한 터미널 에뮬레이션을 지원합니다.

기능

• xterm.js를 사용한 완전한 터미널 에뮬레이션
• 색상 지원 (256색 + 트루컬러)
• 다크 터미널 테마 (실제 터미널처럼 어두운 배경)
• 자동 터미널 크기 조정
• 크로스 플랫폼 지원 (macOS, Linux, Windows)
• Claude CLI 경로 자동 감지
• 툴바 재시작 버튼
• CLI 설치 기능 내장

설치 방법

BRAT을 통한 설치 (권장)

1. BRAT 플러그인 설치
2. 베타 플러그인 추가: hadamyeedady12-dev/claude-code-sidebar
3. 커뮤니티 플러그인 설정에서 플러그인 활성화

수동 설치

1. 최신 릴리스에서 main.js, manifest.json, styles.css 다운로드
2. 폴더 생성: .obsidian/plugins/claude-code-sidebar/
3. 다운로드한 파일을 해당 폴더에 복사
4. Obsidian 설정에서 플러그인 활성화

요구 사항

• Claude CLI 설치 필요
• macOS, Linux 또는 Windows
• Python 3 (macOS/Linux PTY 지원용)

사용 방법

1. 왼쪽 리본의 터미널 아이콘 클릭, 또는
2. 명령 팔레트 사용: "Open Claude Code Terminal"

설정

설정 → Claude Code Sidebar에서 설정 가능:

설정	설명
Claude CLI 경로	Claude CLI 사용자 지정 경로 (기본값: 자동 감지)
Font Size	터미널 폰트 크기 (10-24, 기본값: 13)
Theme	터미널 테마 (Dark / Light)
Auto Restart	세션이 예기치 않게 종료되면 자동 재시작
Install Claude CLI	npm을 통해 Claude CLI 설치

플랫폼별 참고 사항

macOS / Linux

Python PTY를 사용하여 색상 및 크기 조정을 포함한 완전한 터미널 지원을 제공합니다.

Windows

• node-pty 설치 시 최상의 경험 제공
• node-pty를 사용할 수 없는 경우 기본 파이프로 대체

개발

# 의존성 설치
npm install

# 빌드 (프로덕션)
npm run build

# 빌드 (감시 모드)
npm run dev

감사의 글

이 프로젝트는 reallygood83님의 Master of OpenCode를 기반으로 Claude Code용으로 재구성되었습니다.

원본 프로젝트를 만들어주신 문정님께 진심으로 감사드립니다.

라이선스

MIT