feature: Add claude code metrics data integration

[la-tamas]

⚠️ Pre Checklist

Please complete ALL items in this checklist, and remove before submitting

• I have read through the Contributing Documentation.
• I have added relevant tests.
• I have added relevant documentation.
• I will add labels to the PR, such as pr-type/bug-fix, pr-type/feature-development, etc.

Summary

The PR allows users to:

• configure connection to Claude Code Analytics API
• ingest data from the API
• display the data in dashboards.

Does this close any open issues?

None

Screenshots

Include any relevant screenshots here.

Other Information

Any other information that is important to this PR.

[Copilot]

Pull request overview

Adds a new Claude Code data source integration to DevLake, including backend collectors/extractors for Anthropic analytics metrics, Config UI connection/scope support, and Grafana dashboards to visualize adoption.

Changes:

• Introduces a new claude_code backend plugin (models, migrations, API endpoints, pipeline plan, and analytics collectors/extractors).
• Extends Config UI to register/configure the Claude Code plugin, including token/org/custom-header connection fields.
• Adds two Grafana dashboards for org/user adoption views based on the new tool-layer tables.

Reviewed changes

Copilot reviewed 61 out of 62 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
grafana/dashboards/ClaudeCodeAdoption.json	New org-level Claude Code adoption dashboard querying _tool_claude_code_* tables.
grafana/dashboards/ClaudeCodeAdoptionByUser.json	New user-focused dashboard with row-level access filtering patterns in SQL.
config-ui/src/types/connection.ts	Extends connection typings to include custom headers and org/admin key fields.
config-ui/src/plugins/utils.ts	Adds claude_code scope naming logic and plugin alias mapping.
config-ui/src/plugins/register/index.ts	Registers the Claude Code plugin in the UI plugin list.
config-ui/src/plugins/register/claude-code/index.ts	Exports Claude Code plugin UI config module.
config-ui/src/plugins/register/claude-code/config.tsx	Defines Claude Code UI config: connection defaults, fields, entities.
config-ui/src/plugins/register/claude-code/assets/icon.svg	Adds Claude Code plugin icon.
config-ui/src/plugins/register/claude-code/connection-fields/index.ts	Exposes Claude Code connection field components.
config-ui/src/plugins/register/claude-code/connection-fields/organization.tsx	UI field to collect Anthropic organization identifier.
config-ui/src/plugins/register/claude-code/connection-fields/token.tsx	UI field to collect Anthropic API key (token) with conditional requirement.
config-ui/src/plugins/register/claude-code/connection-fields/custom-headers.tsx	UI to configure custom auth headers (middleware/proxy scenarios).
config-ui/src/plugins/register/claude-code/connection-fields/styled.ts	Shared styling for Claude Code connection field validation text.
config-ui/src/plugins/components/connection-form/index.tsx	Ensures connection test payload includes rateLimitPerHour and customHeaders.
config-ui/src/features/connections/utils.ts	Simplifies connection transformation by spreading API payload into UI model.
config-ui/src/config/entities.ts	Adds CLAUDE_CODE entity label for UI display.
config-ui/src/api/connection/index.ts	Extends connection test payload typing to include new connection fields.
backend/plugins/claude_code/claude_code.go	Adds standalone runner entry for debugging the plugin.
backend/plugins/claude_code/impl/impl.go	Implements plugin interfaces: init, API resources, models, subtasks, pipeline plan, migrations.
backend/plugins/claude_code/impl/connection_helper.go	Normalization helper for Claude Code connections.
backend/plugins/claude_code/api/init.go	Initializes API helpers for connections/scopes/scope-configs and remote scope listing.
backend/plugins/claude_code/api/connection.go	Connection CRUD + validation for Claude Code connections.
backend/plugins/claude_code/api/test_connection.go	Test connection endpoints (new + existing connection override).
backend/plugins/claude_code/api/connection_test.go	Unit tests for connection validation rules.
backend/plugins/claude_code/api/remote_api.go	Remote scope listing/search implementation (organization as scope).
backend/plugins/claude_code/api/scope.go	Scope CRUD endpoints via shared DS helper.
backend/plugins/claude_code/api/scope_config.go	Scope config CRUD endpoints via shared DS helper.
backend/plugins/claude_code/api/blueprint_v200.go	Generates blueprint v200 pipeline plan for Claude Code scopes.
backend/plugins/claude_code/service/connection_test_helper.go	Implements HTTP-level connection test logic against Anthropic endpoints.
backend/plugins/claude_code/models/models.go	Registers tool-layer tables for the plugin.
backend/plugins/claude_code/models/connection.go	Defines connection model, auth header setup, sanitization, and PATCH merge behavior.
backend/plugins/claude_code/models/connection_test.go	Tests secret-preserving merge behavior for token/custom headers.
backend/plugins/claude_code/models/scope.go	Defines organization scope model and normalization in BeforeSave.
backend/plugins/claude_code/models/scope_config.go	Defines tool-layer scope config model.
backend/plugins/claude_code/models/activity_summary.go	Tool-layer model for org activity summary metrics.
backend/plugins/claude_code/models/user_activity.go	Tool-layer model for per-user daily analytics metrics.
backend/plugins/claude_code/models/chat_project.go	Tool-layer model for chat project usage metrics.
backend/plugins/claude_code/models/skill_usage.go	Tool-layer model for skill usage metrics.
backend/plugins/claude_code/models/connector_usage.go	Tool-layer model for connector usage metrics.
backend/plugins/claude_code/models/migrationscripts/register.go	Registers Claude Code plugin migration scripts.
backend/plugins/claude_code/models/migrationscripts/20260309_initialize.go	Creates initial Claude Code connection/scope/scope-config tables.
backend/plugins/claude_code/models/migrationscripts/20260319_add_custom_headers.go	Adds custom headers support to connection table schema.
backend/plugins/claude_code/models/migrationscripts/20260319_replace_analytics_tables.go	Adds new analytics tool-layer + raw tables for the updated endpoints.
backend/plugins/claude_code/tasks/options.go	Defines task options (connectionId, scopeId).
backend/plugins/claude_code/tasks/task_data.go	Defines runtime task data container passed through subtasks.
backend/plugins/claude_code/tasks/subtasks.go	Declares subtask metas for collecting/extracting analytics datasets.
backend/plugins/claude_code/tasks/register.go	Returns the ordered list of Claude Code subtask metas.
backend/plugins/claude_code/tasks/api_client.go	Creates API client with rate limiting and Retry-After handling.
backend/plugins/claude_code/tasks/retry_after.go	Parses HTTP Retry-After header into a duration.
backend/plugins/claude_code/tasks/collector_utils.go	Shared collectors utilities: date windows, iterators, pagination parsing.
backend/plugins/claude_code/tasks/collector_utils_test.go	Unit tests for date-range computation logic.
backend/plugins/claude_code/tasks/activity_summary_collector.go	Collector for org summaries endpoint (chunked date ranges).
backend/plugins/claude_code/tasks/activity_summary_extractor.go	Extractor for org summary records into tool-layer table.
backend/plugins/claude_code/tasks/user_activity_collector.go	Collector for per-user daily analytics endpoint.
backend/plugins/claude_code/tasks/user_activity_extractor.go	Extractor for per-user activity records into tool-layer table.
backend/plugins/claude_code/tasks/user_activity_extractor_test.go	Unit tests around user activity email normalization/filter helpers.
backend/plugins/claude_code/tasks/chat_project_collector.go	Collector for chat project usage endpoint.
backend/plugins/claude_code/tasks/chat_project_extractor.go	Extractor for chat project usage records into tool-layer table.
backend/plugins/claude_code/tasks/skill_usage_collector.go	Collector for skill usage endpoint.
backend/plugins/claude_code/tasks/skill_usage_extractor.go	Extractor for skill usage records into tool-layer table.
backend/plugins/claude_code/tasks/connector_usage_collector.go	Collector for connector usage endpoint.
backend/plugins/claude_code/tasks/connector_usage_extractor.go	Extractor for connector usage records into tool-layer table.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[klesh]

Great job! I think this is a lovely addition to the project.
Do you plan to address Copilot’s suggestion?

[la-tamas]

Great job! I think this is a lovely addition to the project. Do you plan to address Copilot’s suggestion?

Managed to allocate some time to address issues.

[klesh]

It looks like the unit test check is failing—could you take a quick look and fix it so we can merge?

[albusshirazi]

I think this feature is really cool and will probably close issue #8713

[sclausson]

Thank you for the contribution @la-tamas I am also interested in this one. Is there any progress on fixing the failing unit test?

[la-tamas]

Thank you for the contribution @la-tamas I am also interested in this one. Is there any progress on fixing the failing unit test?

Managed to allocate time again for opensource work. Please take a look.

[ewega]

Just a small lint issue mind taking a look? @la-tamas Thanks again this is a big but good one

[klesh]

LGTM.
@ewega The linting passed. I am merging the PR~

[albusshirazi]

Great!!
When will this awesome feature be possible to deploy via devlake helm chart project?