---
title: "使用 Langfuse 追踪 Codex 会话"
filename: "terminal"
canonical: /templates/langfuse-codex-observability-plugin/
---

# 使用 Langfuse 追踪 Codex 会话

安装 tracing@codex-observability-plugin，通过 Stop 钩子采集会话。设置 TRACE_TO_LANGFUSE=true，凭证通过进程环境传入。

```
codex plugin marketplace add langfuse/codex-observability-plugin
codex plugin add tracing@codex-observability-plugin
codex plugin list

# ~/.codex/config.toml
# [features]
# hooks = true
# [plugins."tracing@codex-observability-plugin"]
# enabled = true

# 启动 Codex 的 shell：
# export TRACE_TO_LANGFUSE="true"
# export LANGFUSE_PUBLIC_KEY="pk-lf-..."
# export LANGFUSE_SECRET_KEY="sk-lf-..."
# export LANGFUSE_BASE_URL="https://cloud.langfuse.com"

# 会话里：/hooks 审过 Stop 钩子再信任

# 升级：
# codex plugin marketplace upgrade codex-observability-plugin

# 不要：
# plugin_hooks = true
# npx skills add langfuse/skills
# tracing@langfuse
# mcp login
# [mcp_servers.langfuse.env] LANGFUSE_SECRET_KEY = "sk-lf-..."

```