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

# Claude

> Connect Claude Enterprise analytics to Windmill to sync team AI usage into stats, performance reviews, and 1:1s without accessing conversations, prompts, code, or files.

<Warning>
  Claude's analytics API is only available on the **Claude Enterprise plan**. You must be on Claude Enterprise to connect this integration.
</Warning>

## Benefits of connecting Claude to Windmill

Connecting Claude to Windmill brings AI usage data directly into stats, performance reviews, and 1:1s — giving managers and engineers visibility into how Claude is being adopted across the team.

* Tracks how your team uses Claude across chat, Claude Code, and Claude's Office Agent for Excel and PowerPoint
* Surfaces adoption patterns across conversations, coding sessions, skills, and connectors without self-reporting
* Helps managers understand AI tool usage and coach their teams on effective workflows
* Provides concrete data for performance conversations about productivity and tool adoption
* Syncs automatically — no manual tracking or surveys required

Windmill turns Claude's enterprise analytics into actionable stats that flow into your existing performance workflow.

## How to connect Claude

<Steps>
  <Step title="Get your API key from Claude">
    Go to [claude.ai/analytics/api-keys](https://claude.ai/analytics/api-keys) and generate an API key. You must be a **Primary Owner** of your Claude organization to access this page.
  </Step>

  <Step title="Open the Claude integration in Windmill">
    In Windmill, navigate to [Settings > Integrations](https://app.gowindmill.com/COMPANY/config/integrations), find **Claude**, and click **Connect**.
  </Step>

  <Step title="Paste your API key and connect">
    Paste the API key from Claude into the input field and click **Connect Claude**. Windmill will validate the key and begin syncing analytics within the hour.
  </Step>
</Steps>

<Note>
  Claude is an account-level integration — an admin connects it once and it covers your entire Claude organization. Individual users don't need to connect separately.
</Note>

## Connected data

When connected, Windmill syncs **per-user analytics** from Claude's Enterprise Analytics API. This is usage data — Windmill does not access any conversations, prompts, code, or file content.

### Claude Chat

| Stat              | Description                                   | Unit          |
| ----------------- | --------------------------------------------- | ------------- |
| Conversations     | Distinct conversations started in Claude      | conversations |
| Chat Messages     | Messages sent in Claude chat                  | messages      |
| Artifacts Created | Artifacts created during Claude conversations | artifacts     |

### Claude Code

| Stat                 | Description                                | Unit     |
| -------------------- | ------------------------------------------ | -------- |
| Sessions             | Distinct Claude Code sessions              | sessions |
| Commits              | Commits made through Claude Code           | commits  |
| Pull Requests        | Pull requests created through Claude Code  | PRs      |
| Lines Added          | Lines of code added through Claude Code    | lines    |
| Lines Removed        | Lines of code removed through Claude Code  | lines    |
| Edits Accepted       | Number of AI-generated code edits accepted | edits    |
| Edit Acceptance Rate | Ratio of accepted to suggested AI edits    | %        |

### Skills and connectors

| Stat            | Description                                          | Unit        |
| --------------- | ---------------------------------------------------- | ----------- |
| Skill Usage     | Claude skill invocations across all products         | invocations |
| Connector Usage | Claude MCP/connector invocations across all products | invocations |

### Claude Office Agent — Excel

| Stat                  | Description                               | Unit        |
| --------------------- | ----------------------------------------- | ----------- |
| Excel Sessions        | Distinct Claude for Excel sessions        | sessions    |
| Excel Messages        | Messages sent in Claude for Excel         | messages    |
| Excel Skills Used     | Skill invocations in Claude for Excel     | invocations |
| Excel Connectors Used | Connector invocations in Claude for Excel | invocations |

### Claude Office Agent — PowerPoint

| Stat                       | Description                                    | Unit        |
| -------------------------- | ---------------------------------------------- | ----------- |
| PowerPoint Sessions        | Distinct Claude for PowerPoint sessions        | sessions    |
| PowerPoint Messages        | Messages sent in Claude for PowerPoint         | messages    |
| PowerPoint Skills Used     | Skill invocations in Claude for PowerPoint     | invocations |
| PowerPoint Connectors Used | Connector invocations in Claude for PowerPoint | invocations |

All stats are tracked per employee, per day.

## Visibility and access

Claude stats in Windmill follow the **manager hierarchy** visibility model:

* **Employees** can see their own Claude stats
* **Managers** can see Claude stats for their direct reports and anyone in their reporting chain
* **Admins** can see Claude stats for everyone in the organization
* **Peers** cannot see each other's Claude stats

This means Claude analytics are treated like other sensitive performance data in Windmill — visible to the people who need it for coaching and evaluation, but not exposed broadly.

## Permissions

Windmill requests **read-only** access to Claude's Enterprise Analytics API.

| Permission                                | Purpose                                                                            |
| ----------------------------------------- | ---------------------------------------------------------------------------------- |
| Read user analytics                       | To sync usage stats per team member into Windmill                                  |
| **No access to conversations or prompts** | Windmill never reads, stores, or accesses any conversation content from Claude     |
| **No access to code or files**            | Windmill does not read any code, files, or artifacts — only aggregate usage counts |
| Read-only access                          | Windmill never modifies anything in Claude                                         |

## User matching

Windmill matches Claude users to employees using their **email address**. If a Claude user's email matches an employee's email in Windmill, their stats are automatically attributed to that employee.

If you notice stats that aren't being attributed correctly, check that the email addresses in Claude match the employee emails in Windmill.

## FAQs

<AccordionGroup>
  <Accordion title="Do I need a Claude Enterprise plan?">
    Yes. Claude's analytics API is only available on the Enterprise plan. The integration won't work with Claude's free, Pro, or Team plans.
  </Accordion>

  <Accordion title="Does Windmill access any conversations, prompts, or code?">
    No. Windmill only reads usage analytics from Claude's API — session counts, message counts, and acceptance rates. Windmill never accesses conversation content, prompts, code, files, or artifacts.
  </Accordion>

  <Accordion title="How often does data sync?">
    Windmill syncs with Claude once per hour. New usage data typically appears within a few hours of the activity happening in Claude, as there is a short delay in Claude's analytics processing.
  </Accordion>

  <Accordion title="Can I see my own Claude stats?">
    Yes. Every employee can see their own Claude stats in Windmill.
  </Accordion>

  <Accordion title="Can my coworkers see my Claude stats?">
    No. Claude stats follow the manager hierarchy — only your manager (and their managers) can see your stats. Peers cannot see each other's Claude usage data.
  </Accordion>

  <Accordion title="Does each person need to connect Claude individually?">
    No. Claude is an account-level integration. An admin connects it once using an API key from Claude's analytics settings, and it covers your entire Claude organization.
  </Accordion>

  <Accordion title="What happens when someone leaves?">
    Their historical Claude stats remain for context, but Windmill stops attributing new activity once they are an Archived user.
  </Accordion>

  <Accordion title="Why aren't my Claude stats showing up?">
    This usually happens when your email in Claude doesn't match your email in Windmill. Make sure the email addresses match, or ask an admin to check the user mapping.
  </Accordion>
</AccordionGroup>
