Claude Code Integration for Obsidian

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.

Features

• Full Claude Code Agent — The same powerful AI assistant used in VS Code, Cursor, and Zed
• 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
• 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+.
• Diff Viewer — Review file changes before applying them

Requirements

Authentication

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!

Installation

Via BRAT (Recommended)

BRAT installs the plugin directly from GitHub and keeps it updated automatically.

1. Install BRAT from Obsidian: Settings → Community plugins → Browse → search "BRAT" → Install → Enable
2. Open BRAT settings: Settings → BRAT → Add Beta Plugin
3. Paste the repository URL: SmartAndPoint/obsidian-claude-code
4. Click Add Plugin — BRAT downloads and installs everything automatically
5. 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".

From GitHub Releases

1. Download main.js, manifest.json, and styles.css from the latest release
2. Create folder: YOUR_VAULT/.obsidian/plugins/obsidian-claude-code/
3. Copy the 3 files into that folder
4. In Obsidian: Settings → Community plugins → Enable "Claude Code Integration"

From Source

# 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/

Setup

1. Verify Claude Code Works

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.

2. API Key (Optional)

If you're using an API key instead of a subscription, set it before launching Obsidian:

export ANTHROPIC_API_KEY=sk-ant-api03-...
open /Applications/Obsidian.app

$env:ANTHROPIC_API_KEY = "sk-ant-api03-..."
& "C:\Users\YOU\AppData\Local\Obsidian\Obsidian.exe"

3. First Run

1. Click the bot icon in the left ribbon to open the Claude Code Integration panel
2. Click the plug icon (⚡) in the chat header to connect
3. On first connection, the plugin will automatically download the required components (~30 seconds)
4. Start chatting!

Usage

Basic Chat

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.

Code Selection

1. Select text in any file
2. Press Cmd+Shift+. (or Ctrl+Shift+. on Windows)
3. The selection appears as a chip in the chat input
4. Ask Claude about it!

Commands

Open Command Palette (Cmd/Ctrl + P):

Permissions

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

Troubleshooting

"Failed to find or download claude-code-acp binary"

Make sure Node.js and npm are installed and accessible:

node --version  # Should be 18+
npm --version

Connection Issues

1. Check that your ANTHROPIC_API_KEY is set correctly
2. Restart Obsidian after setting the environment variable
3. Check the Developer Console (Cmd+Option+I) for error messages

Binary Location

The plugin stores the Claude Code ACP binary in:

YOUR_VAULT/.obsidian/plugins/obsidian-claude-code/bin/

You can delete this folder to force a fresh download.

Privacy & Security

• 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

# Development mode with hot reload
npm run dev

# Type checking
npm run typecheck

# Production build
npm run build

Author

Created and maintained by Evgenii Konev ekonev@smartandpoint.com (SmartAndPoint)

License

MIT

Links

• Claude Code — Official Claude Code
• Anthropic — The company behind Claude
• Agent Client Protocol — The protocol powering this integration