Use Claude Code — Anthropic's AI coding assistant — directly inside Obsidian.
This plugin integrates the full Claude Code agent experience into your vault: not just a simple chat, but a complete agentic workflow with file operations, tool calls, and intelligent code assistance.
Note: This is a third-party integration, not an official Anthropic product.
- Full Claude Code Agent — The same powerful AI assistant used in VS Code, Cursor, and Zed
- Works with Claude Pro/Max subscriptions — Uses the official Claude Agent SDK, no API key required
- Session memory — Conversations persist in your vault and Claude restores context automatically when you resume
- File Operations — Claude can read, write, and edit files in your vault with your permission
- Tool Execution — Supports bash commands, file search, and other tools
- Clipboard paste — Paste images and files directly into chat (images saved to vault, files referenced by path)
- Permission System — You control what Claude can do with intuitive Allow/Deny prompts
- Streaming Responses — Real-time message display with markdown rendering
- Code Selection — Select code and send it to Claude with
Cmd+Shift+.— shows as @N chip references - Diff Viewer — Review file changes before applying them
- Session picker — Switch between conversations, each stored as a searchable markdown file in your vault
| Requirement | Description | Installation |
|---|---|---|
| Claude Code | Main requirement — must be installed and working | Install Claude Code |
| Obsidian | Version 1.5.0+ (Desktop only) | Download Obsidian |
| Node.js | Version 18+ (for automatic component download) | Download Node.js |
You need one of the following:
- Claude Pro/Team subscription — Claude Code uses your subscription automatically
- Anthropic API Key — Get one at console.anthropic.com if you don't have a subscription
Note: If you already use Claude Code in your terminal and it works, you're all set!
BRAT installs the plugin directly from GitHub and keeps it updated automatically.
- Install BRAT from Obsidian: Settings → Community plugins → Browse → search "BRAT" → Install → Enable
- Open BRAT settings: Settings → BRAT → Add Beta Plugin
- Paste the repository URL:
SmartAndPoint/obsidian-claude-code - Click Add Plugin — BRAT downloads and installs everything automatically
- Enable the plugin: Settings → Community plugins → Enable "Claude Code Integration"
Auto-updates: BRAT checks for new releases on Obsidian startup. You can also manually check via Command Palette → "BRAT: Check for updates to all beta plugins".
- Download
main.js,manifest.json, andstyles.cssfrom the latest release - Create folder:
YOUR_VAULT/.obsidian/plugins/obsidian-claude-code/ - Copy the 3 files into that folder
- In Obsidian: Settings → Community plugins → Enable "Claude Code Integration"
# Clone the repository
git clone https://github.com/SmartAndPoint/obsidian-claude-code
cd obsidian-claude-code
# Install dependencies and build
npm install
npm run build
# Copy to your vault's plugins folder
mkdir -p YOUR_VAULT/.obsidian/plugins/obsidian-claude-code
cp main.js manifest.json styles.css YOUR_VAULT/.obsidian/plugins/obsidian-claude-code/Before using this plugin, make sure Claude Code works in your terminal:
claude "Hello, Claude!"If this works, you're ready to go! The plugin will use the same authentication.
If you're using an API key instead of a subscription, set it before launching Obsidian:
macOS/Linux
export ANTHROPIC_API_KEY=sk-ant-api03-...
open /Applications/Obsidian.appAdd to ~/.zshrc or ~/.bashrc for persistence.
Windows (PowerShell)
$env:ANTHROPIC_API_KEY = "sk-ant-api03-..."
& "C:\Users\YOU\AppData\Local\Obsidian\Obsidian.exe"- Click the bot icon in the left ribbon to open the Claude Code Integration panel
- Click the plug icon (⚡) in the chat header to connect
- Start chatting!
Just type your message and press Enter or click Send. Claude will respond with helpful answers, code suggestions, and can perform actions in your vault.
- Select text in any file
- Press
Cmd+Shift+.(orCtrl+Shift+.on Windows) - The selection appears as a chip in the chat input
- Ask Claude about it!
Open Command Palette (Cmd/Ctrl + P):
| Command | Description |
|---|---|
| Claude Code Integration: Open Chat | Open the chat panel |
| Claude Code Integration: Connect | Connect to Claude |
| Claude Code Integration: Disconnect | Disconnect from Claude |
| Claude Code Integration: Add Selection to Chat | Add selected text to chat |
When Claude wants to perform actions (edit files, run commands), you'll see a permission prompt:
- Allow — Permit this specific action
- Allow All — Permit all similar actions this session
- Deny — Reject this action
The plugin requires the claude CLI to be installed and in your PATH:
claude --version # Should print version
which claude # Should print path (e.g., /opt/homebrew/bin/claude)If not installed, visit claude.ai/code to install Claude Code.
- Make sure
claudeworks in your terminal first:claude "Hello" - If using an API key, check it's set in your environment
- Restart Obsidian after installing Claude Code or setting environment variables
- Check the Developer Console (
Cmd+Option+I) for error messages
Sessions are stored as markdown files in your vault:
YOUR_VAULT/claude-code/sessions/
Pasted images are stored in:
YOUR_VAULT/claude-code/images/
- Your API key is only used to communicate with Anthropic's API
- All file operations require your explicit permission
- The plugin works entirely locally — no data is sent to third parties
- See Anthropic's Privacy Policy for API usage
# Development mode with hot reload
npm run dev
# Type checking
npm run typecheck
# Production build
npm run buildCreated and maintained by Evgenii Konev ekonev@smartandpoint.com (SmartAndPoint)
- Claude Code — Official Claude Code
- Anthropic — The company behind Claude
- Claude Agent SDK — The SDK powering this integration