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

# Claude Code

> Record Claude Code sessions in Sovara and add relevant lessons to each prompt.

Each session is a Sovara trace and each prompt a turn. Tool calls are tool steps, Claude's reply
is a model step, and matching lessons are added to the prompt as extra context.

1. Install the hook program with either runtime:

   ```sh theme={"theme":{"light":"github-light","dark":"github-dark"}}
   uv tool install sovara-claude-code     # Python 3.10+
   pip install sovara-claude-code         # or pip
   npm install -g @sovara/claude-code     # or Node.js 24.22.1+
   ```

2. Sign in with `sovara login --url <your Sovara URL>`, or set `SOVARA_SERVER_URL` and
   `SOVARA_AGENT_TOKEN`.

3. In Claude Code, add the marketplace and install the plugin:

   ```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
   /plugin marketplace add SovaraLabs/sovara-claude-code
   /plugin install sovara-recording@sovara-claude-code
   ```

   Restart Claude Code to activate the hooks.

The project is the folder you start Claude Code in; set `SOVARA_PROJECT` to choose another.

* Hooks never block Claude Code. If Sovara is unavailable, the session runs unrecorded.
* Lessons are recorded as retrieved, not applied: Claude Code doesn't expose the exact model
  input, so Sovara can't confirm what reached the model.


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