Claude Code
The Claude Code provider uses your Claude Code CLI subscription. Claude runs as an agent on your machine: it can read and write files in your notes folder directly.
What you need
A Claude Code subscription (claude.ai/code) with the claude CLI installed. If you've been using Claude Code for development work, you already have this.
Setup
- Open Settings → AI Providers
- Find Claude Code and click Configure
- Click Connect: this opens a terminal window in Coeus and runs the Claude authentication flow
- Follow the prompts in the terminal (it opens your browser to sign in)
- Once authenticated, close the terminal window
The status in Settings should update to show Claude Code as connected.
How it works
When you send a message, Coeus starts a Claude Code session and gives it access to your notes folder. Claude can read your notes, write new ones, and edit existing ones as part of answering your questions.
This is more capable than the raw API approach because Claude can navigate your notes like a real file system: following links, searching for related notes, and reading across multiple files at once.
Re-authenticating
Claude Code sessions expire. If Coeus shows an authentication error, go back to Settings → AI Providers → Claude Code and click Reconnect.
Note on permissions
When running via Coeus, Claude operates in bypass-permissions mode: it can read and write files in your notes folder without asking for confirmation on each action. It's sandboxed to your notes directory. It can't touch anything outside of it.