Obsidian 사이드바에서 Claude Code 사용하기: AI 보조 작문 경험 극대화

Obsidian 사이드바에 Claude Code를 임베드하여, AI와 함께 글을 쓰고 편집하고 창작하세요.

단순한 AI 채팅창이 아닙니다. Niki AI는 Claude Code의 전체 기능(파일 읽기/쓰기, 코드 실행, MCP 툴체인)을 Obsidian 워크플로우에 네이티브하게 임베드합니다. AI가 단순히 질문에 답하는 것을 넘어, 직접 파일을 수정해줍니다.

🧬 깊은 통합 (Deep Integration)
🔒 개인 정보 보호 우선 (Privacy First)
⚡ 마찰 없는 사용성 (Zero Friction)
🛡️ 기본적으로 안전함 (Safe by Default)
| Claude Code CLI의 전체 MCP 툴체인 지원을 직접 임베드|
데이터는 항상 로컬에 저장되며, 사용자 지정 API 엔드포인트가 가능합니다.
@ 참조 · 드래그 앤 드롭 · 원클릭 삽입: 모든 상호작용이 세심하게 설계되었습니다.
AI 수정 후 원클릭 되돌리기(Undo) 및 다중 파일 일괄 복구 기능 제공|

• 지원 모델:
  Opus / Sonnet / Haiku 모델 간 전환 지원 - 전체 기능
  MCP 툴체인 지원 - 사용자 지정 가능
  시스템 프롬프트 및 작업 디렉토리 (Working Directory) - npm 버전 & 네이티브 버전
  자동 감지 (Auto-detection) (v4.0.9+) - 사용자 지정 지원
  API 엔드포인트 (제3자 프록시 호환) Windows / macOS / Linux 전 플랫폼 지원

먼저 Claude Code CLI를 설치해야 합니다:

| npm install -g @anthropic-ai/claude-code ✅ 크로스플랫폼 · 쉬운 업데이트 · 버전 제어 가능 |
| curl -fsSL https://claude.ai/install.sh | bash ✅ 의존성 없음 · 최적의 성능 · 자동 업데이트 |

두 가지 설치 방식 비교

방식 1: Release 설치 (1분 소요)

• 최신 Release를 다운로드합니다.
• main.js, manifest.json, styles.css 파일을 다음 경로에 넣습니다: <your-vault>/.obsidian/plugins/niki-ai/
• Obsidian을 재시작 → 설정 → 커뮤니티 플러그인(또는 서드파티 플러그인) → Niki AI를 활성화합니다.

방식 2: 소스 코드 빌드 (Source Code Build)

git clone https://github.com/KeloYuan/Niki-AI.git
cd Niki-AI
npm install
... 

~/.claude/settings.json을 편집합니다.

(최소 설정):

{

| 매개변수 | 설명 |
|---|---|
`permissions.defaultMode` | 파일 수정 확인 우회 (bypassPermissions) |
`model` | 사용할 모델 (`opus` / `sonnet` / `haiku`) |
`env.API_TIMEOUT_MS` | API 초과 시간 (밀리초) |
`env.ANTHROPIC_BASE_URL` | 사용자 지정 API 엔드포인트 |

**Obsidian → 설정 → 플러그인 → Niki AI**

| 설정 항목 | 설명 | 기본값 |
|---|---|
Claude command | CLI 명령어 템플릿 | `claude -p "{prompt}"` |
Default prompt | 요청마다 추가되는 시스템 프롬프트 | (없음) |
Working directory | Claude 작업 디렉토리 | 현재 Vault 경로 |
Claude 버전 선택 | CLI 버전 감지 전략 (v4.0.9+) | 자동 감지 |

💡

Claude command는 두 가지 모드를 지원합니다:

**인라인 모드 (권장):** `claude -p "{prompt}"`
— 플러그인이 `{prompt}`를 자동으로 대체합니다.

**Stdin 모드:** `claude`
— 플러그인이 stdin을 통해 prompt를 작성합니다.

파일 입력 @ → 파일 선택기 팝업
파일 드래그 → 컨텍스트에 직접 추가
폴더 드래그 📁 → 폴더 내 모든 파일을 자동으로 포함 (v4.0.3+)
...

설정 → Niki AI → Assistants → 사전 설정 추가
각 사전 설정은 독립적: 이름 · 시스템 프롬프트 · 역할 구성
사이드바 전송 버튼 옆에서 빠르게 전환 가능

좌측 상단 주제 드롭다운 → 주제 전환 / 새로 만들기 / 삭제
서로 간섭하지 않는 완전히 독립적인 주제 관리

AI가 코드 블록을 반환 → 「변경 내용 보기」 클릭 → 차이점 검토
확인 시 → 「모든 변경 내용 적용」 클릭 → 파일에 쓰기
후회했을 때? → 「수정 취소」 클릭 → 원클릭 복구

- 📁 채팅창으로 전체 폴더 드래그 지원
- AI가 폴더 내 모든 파일을 컨텍스트로 자동 읽음
- 시각적 지시: 폴더 아이콘 + 파일 개수

- 🪟 Windows용 수정:
`.cmd`
/`.bat`
파일 실행 오류 처리 - 스마트 셸 감지, 따옴표가 포함된 경로 처리

- 👤 다중 어시스턴트 사전 설정 시스템: 독립적인 시스템 프롬프트 및 역할 구성
- ⏹️ 전송/정지 버튼의 지능형 전환
- ⚙️ 자동 저장 설정 (500ms 디바운스)

Niki-AI/
├── src/
│ ├── main.ts # 플러그인 진입점
...

npm install # 의존성 설치
npm run dev # 개발 모드 (자동 감지 + Hot Reload)
npm run build # 프로덕션 빌드

**출력이 없나요?**

- 확인:
`Claude command` 설정이 올바른지 확인하고, 터미널에서 명령어를 테스트해 보세요: `claude -p "hello"`

- Claude Code가 로그인/API 키를 구성했는지 확인하세요.

**명령어를 찾을 수 없다고 표시되나요?**

PATH를 확인하거나 절대 경로를 사용하세요:

- npm:
`~/.npm-global/bin/claude`

- Homebrew:
`/opt/homebrew/bin/claude`

- 공식 스크립트:
`~/.claude/bin/claude`

- Windows:
`%APPDATA%
pm
ode_modules
pm
ode_exec.js` (원문에는 `claude.cmd`로 되어 있으나, 일반적인 npm 설치 경로를 반영하여 수정했습니다.)
*(참고: 원문에 명시된 `%APPDATA%
pm
ode_modules
pm
ode_exec.js`는 실제 Windows 환경에서 정확한 경로는 아닐 수 있습니다. 다만, 입력에 충실하기 위해 원래의 `claude.cmd`를 유지하는 것이 가장 안전합니다.)*

**AI가 수정했다고 하는데 파일이 변하지 않았나요?**

Claude Code 설정에서 `

*AI는 사용자가 있는 곳에서 작동해야 합니다—노트 내부에서요.*