Claude Code セッションをトレースとして Opik にログ記録し、AI アプリケーションの計測と評価のための SKILL を追加します。
別名 comet-ml/opik-claude-code-plugin
- スター
- 25
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- —
- 最終コミット
- 2026年10月22日
- ライセンス
- Apache-2.0
Opik MCPとは
Claude Code セッションをトレースとして Opik にログ記録し、AI アプリケーションの計測と評価のための SKILL を追加します。
プロジェクトのREADMEから生成された概要
Opik MCP server について
Claude Code を使用している開発者は、AI セッションを Opik オブザーバビリティプラットフォームにトレースとしてログ記録することで、セッションを監視できます。このプラグインは、会話のターン、ツール呼び出し、思考をスパンとして自動的にキャプチャし、親子の関係を通じてネストされたサブエージェントの呼び出しも追跡します。ユーザーエクスペリエンスを損なうことなく、複雑なタスク中にコーディングエージェントがどのように動作するかを可視化するように設計されています。
セッションのログ記録に加えて、このプラグインは、観測可能な AI アプリケーションの構築と維持を支援する専用の SKILL とエージェントを提供します。ユーザーは、LangChain、OpenAI、LlamaIndex などのフレームワークを自動検出し、必要なトレーシングデコレータを追加することで、自身の Python または TypeScript コードに計測機能を組み込むことができます。セットアップには、Claude Code marketplace 経由でのプラグインのインストールと、Opik CLI を使用した API キーおよびワークスペース設定による Opik への接続設定が必要です。
このツールは、エージェントのアーキテクチャのセキュリティと冪等性をチェックするための専用エージェント・レビュアーを提供している点で優れています。また、失敗したトレースのデバッグ、実験結果の比較、AI インターフェース内での直接的なプロンプトの最適化などのタスクを実行するための包括的なスキルパックも含まれています。
できること
- 1Claude Code セッションのトレースClaude Code セッション内のすべてのインタラクションとツール呼び出しを Opik プラットフォームに自動的にログ記録し、後でレビューできるようにします。
- 2アプリケーションコードの計測サポートされている AI フレームワークを自動的に検出して統合することで、既存の Python または TypeScript プロジェクトにオブザーバビリティを追加します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
設定
OPIK_CC_PARENT_TRACE_IDOPIK_CC_PROJECTOPIK_CC_ROOT_SPAN_IDOPIK_CC_TRUNCATE_FIELDSOPIK_CC_WORKSPACE
| 名前 | 説明 | 種類 |
|---|---|---|
| OPIK_CC_PARENT_TRACE_ID | — | |
| OPIK_CC_PROJECT | — | |
| OPIK_CC_ROOT_SPAN_ID | — | |
| OPIK_CC_TRUNCATE_FIELDS | — | |
| OPIK_CC_WORKSPACE | — |
自動チェック
実行日 2026年11月14日完全なレポート →まだ検証されていません。サーバーには80点のスコア、重大な問題がないこと、および検証に必要な十分なデータが必要です。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能comet-ml/opik-claude-code-plugin is public and reachablegithub.com/comet-ml/opik-claude-code-plugin ↗合格
- パッケージがこのリポジトリをソースとして指定未チェック
- ビルドの来歴 (Sigstore 証明)未チェック
- オープンソースライセンス (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-10-22github.com/comet-ml/opik-claude-code-plugin ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していない未チェック
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見るOpik Claude Code Plugin
Log Claude Code sessions to Opik for LLM observability, plus skills and agents for building observable AI applications.
Opik is the open-source LLM observability and evaluation platform, built by Comet.
Features
- Session Tracing: Automatically log Claude Code sessions as Opik traces
- Span Tracking: Each tool call becomes a span within the trace
- Subagent Support: Nested agent calls are tracked with parent-child relationships
- Skills: Built-in knowledge for LLM observability, tracing, and evaluation
- Agents: Code review agent for agent architecture best practices
How Tracing Works
We trigger tracing for everything done in Claude Code, but don't slow you down.
Each conversation turn becomes an Opik trace. Tool calls, thoughts, and responses become spans. Subagent invocations are nested under their parent Task span.
Installation
From within Claude Code:
/plugin marketplace add comet-ml/opik-claude-code-plugin
Then install the plugin:
/plugin install opik
Local Install (for contributors)
If you've cloned the repo locally, add it as a marketplace and install from there:
/plugin marketplace add /path/to/opik-claude-code-plugin
/plugin install opik
Important: Restart any running Claude Code sessions after installation. Hooks only load when a session starts.
Configuration
Run the Opik CLI to configure your connection:
pip install opik
opik configure
This creates ~/.opik.config with your API URL, key, and workspace.
Optional Environment Variables
export OPIK_CC_PROJECT="my-project" # Project name (default: claude-code)
export OPIK_CC_WORKSPACE="my-workspace" # Workspace override (default: OPIK_WORKSPACE / ~/.opik.config)
export OPIK_CC_TRUNCATE_FIELDS="false" # Don't truncate large fields
All plugin env vars use the OPIK_CC_ prefix to avoid conflicts with standard Opik SDK variables.
OPIK_CC_WORKSPACE and OPIK_CC_PROJECT let you send Claude Code traces to a different
workspace/project than the rest of your Opik setup, without touching the global
OPIK_WORKSPACE / project_name in ~/.opik.config used by the Opik SDK. Both can also be
set in ~/.opik.config via the plugin-scoped cc_workspace and cc_project keys:
[opik]
workspace = my-sdk-workspace # used by the Opik SDK
project_name = my-sdk-project # used by the Opik SDK
cc_workspace = my-cc-workspace # used only by the Claude Code plugin
cc_project_name = my-cc-project # used only by the Claude Code plugin
Note: for backward compatibility, if
cc_project_nameis not set the plugin still falls back to the sharedproject_namekey.
External Trace Linking
Link Claude Code sessions to existing Opik traces (useful for embedding Claude Code in larger workflows):
export OPIK_CC_PARENT_TRACE_ID="your-trace-id" # Attach to existing trace
export OPIK_CC_ROOT_SPAN_ID="your-span-id" # Set parent span for all Claude Code spans
MCP Server Setup
The Opik MCP server provides Claude with tools to interact with your Opik data - query traces, analyze experiments, and access evaluation results directly in conversation.
For Opik Cloud
Add to your ~/.claude.json:
{
"mcpServers": {
"opik": {
"command": "npx",
"args": ["-y", "opik-mcp", "--apiKey", "YOUR_OPIK_API_KEY"]
}
}
}
Replace YOUR_OPIK_API_KEY with your API key from comet.com.
For Self-Hosted Opik
{
"mcpServers": {
"opik": {
"command": "npx",
"args": ["-y", "opik-mcp", "--apiBaseUrl", "http://localhost:5173/api"]
}
}
}
Adjust the apiBaseUrl to match your Opik instance.
Pre-configured Templates
Copy-ready configurations are available in mcp-configs/mcp-servers.json.
Commands
/opik:trace-claude-code - Claude Code Session Tracing
Enable/disable automatic tracing of your Claude Code sessions to Opik.
/opik:trace-claude-code start # Enable tracing for this project
/opik:trace-claude-code start --debug # Enable tracing + debug logging
/opik:trace-claude-code stop # Disable tracing for this project
/opik:trace-claude-code status # Check project + global + effective state
/opik:trace-claude-code start --global # Enable tracing for all projects
/opik:trace-claude-code stop --global # Disable tracing globally
Tracing state is stored in .claude/.opik-tracing-enabled (project) or ~/.claude/.opik-tracing-enabled (global). Resolution order (first match wins):
- Project file containing
off/disabled→ disabled (opt a single project out of a global enable) - Project file present → enabled (
debugcontent also enables debug logging) - Global file present → enabled (same content rules)
- Neither → disabled
So the project setting always takes precedence over the global one. Running stop in a project while global tracing is on writes the off opt-out for that project rather than removing the global enable.
Note: Changes take effect immediately for new conversation turns (no restart needed).
/opik:instrument - Add Observability to Your Code
Automatically detect frameworks in your code and add the correct Opik integration.
/opik:instrument my_agent.py # Add tracing to a specific file
/opik:instrument # Analyze current context and add tracing
Supports automatic detection and integration for:
- Python: OpenAI, Anthropic, LangChain, LlamaIndex, CrewAI, Bedrock, Groq, LiteLLM
- TypeScript: OpenAI, LangChain, Vercel AI SDK
- Custom code: Adds
@opik.trackdecorators orOpikclient usage
The command ensures tracing starts at your entry point (critical for replay capability) and uses the correct span types.
Skills
Opik skills (vendored from comet-ml/opik-mcp)
The plugin ships the Opik skill pack — the same skills published as opik-skills. Claude loads them by task:
| Skill | Use for |
|---|---|
opik |
SDK reference — span types, integrations, threads, the prompt library |
opik-instrument |
"add opik tracing", "instrument my code" — and verify a real trace lands |
opik-diagnose |
"what is broken in production", "which traces need attention" |
opik-explain |
"why did this trace fail", "debug this trace" |
opik-test |
"turn this trace into a test", "make sure this doesn't happen again" |
opik-compare |
"did my fix work", "which cases regressed" |
opik-evaluate |
"evaluate my agent", "build an eval", "write an LLM judge" |
opik-online-eval |
"score production traces", "take this judge live" |
opik-optimize |
"optimize this prompt", "run the prompt optimizer" |
opik-verify |
"is this safe to ship", "go/no-go on this change" |
They are vendored at a pinned opik-mcp commit (see skills/SHARED.md); edit them upstream, not here.
Agents
agent-reviewer
Reviews agent code for:
- Idempotence and retry safety
- Security vulnerabilities
- Architecture patterns
- State management
- Observability hooks
Directory Structure
opik-claude-code-plugin/
├── .claude-plugin/
│ ├── plugin.json # Plugin manifest
│ └── marketplace.json # Marketplace definition
├── hooks/
│ └── hooks.json # Hook configuration
├── scripts/
│ └── opik-logger # Platform selector script
├── bin/
│ └── opik-logger-* # Compiled binaries (darwin/linux, amd64/arm64)
├── src/
│ └── *.go # Go source code
├── skills/ # Opik skill pack, vendored from comet-ml/opik-mcp (see skills/SHARED.md)
│ ├── opik/
│ ├── opik-instrument/ … opik-optimize/
├── agents/
│ └── agent-reviewer.md # Agent review agent
├── commands/
│ ├── trace-claude-code.md # /opik:trace-claude-code command
│ └── instrument.md # /opik:instrument command
└── mcp-configs/
└── mcp-servers.json # MCP server configurations
Building from Source
make build # Build for all platforms
make build-local # Build for current platform only
Opik for Claude Code
This repo is part of a set of tools for observing Claude Code and other coding agents with Opik:
- opik-claude-code-plugin: log Claude Code sessions as Opik traces, with skills and agents included (this repo)
- ccsync: export Claude Code conversation history to Opik
- cost-intelligence-proxy: meter Claude Code token spend and cost per call
- opik-skills: agent skills for instrumenting your code with Opik
Opik MCPのよくある質問
Claude Code 用の Opik プラグインをインストールするにはどうすればよいですか?
marketplace を追加して Claude Code 内からプラグインをインストールし、実行中のセッションを再起動してください。
Opik はどのように Claude Code セッションをトレースしますか?
会話のターンごとに Opik トレースが作成されます。ツール呼び出し、思考、レスポンスはスパンとなり、サブエージェントは親となる Task スパンの下にネストされます。
Opik の接続設定はどうすればよいですか?
Opik CLI をインストールして opik configure を実行してください。これにより、API URL、キー、ワークスペースが ~/.opik.config に書き込まれます。
Claude Code のトレースを別のプロジェクトやワークスペースに送信できますか?
はい、OPIK_CC_PROJECT と OPIK_CC_WORKSPACE を設定するか、~/.opik.config 内の cc_project_name と cc_workspace キーを設定してください。
自身のエージェントコードに Opik のトレーシングを追加するにはどうすればよいですか?
/opik:instrument を実行してください。OpenAI、LangChain、CrewAI などのフレームワークを検出し、適切な Opik インテグレーションを追加します。