> ## Documentation Index
> Fetch the complete documentation index at: https://docs.octonote.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code

> Teach Claude Code to save and find your work in Octonote.

Install the CLI and sign in first ([Install the CLI](https://docs.octonote.ai/cli/install.md)). Then:

```bash theme={null}
octonote setup claude            # this project's CLAUDE.md
octonote setup claude --global   # every project (~/.claude/CLAUDE.md)
octonote setup claude --skill    # also install the Octonote skill
```

`setup` adds a short Octonote section to `CLAUDE.md` ([see exactly what](https://docs.octonote.ai/agents/agent-guide.md)). The skill loads the full guide whenever Octonote comes up, so Claude knows every command without you explaining it.

## Skip the permission prompt

To stop Claude asking each time it runs a command, allow `octonote` in `.claude/settings.json` (this project) or `~/.claude/settings.json` (everywhere):

```json .claude/settings.json theme={null}
{ "permissions": { "allow": ["Bash(octonote:*)"] } }
```

## Try it

> Save what we figured out about the cache bug to my Research notebook, with a diagram.

Claude writes the note as markdown and the diagram as a mermaid flowchart, then runs:

```bash theme={null}
octonote project create "Cache bug: stale reads" --note bug.md --canvas-mermaid bug.mmd --notebook Research
```

A week later, in a new session:

> What did we decide about rate limits?

Claude searches your notes (`octonote search`), reads the right one (`octonote note show`) and answers from it.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.