Skip to main content
Get started sending traces to Phoenix from your application. Choose the approach that best fits your needs. Let your coding agent set this up. Works with Claude Code, Codex, Cursor, and OpenCode.
1

Start Phoenix

In one terminal, start Phoenix and leave it running. It serves at http://localhost:6006:
Already have a Phoenix deployment? Skip this step. px setup can point at any running Phoenix, including a self-hosted one.
2

Add tracing with a coding agent

In a new terminal, from your app’s root directory, run one of these:
px setup hands the instrumentation to your coding agent and waits until a real trace arrives. It can also install the Phoenix skills so your agent can query what you capture. See Agent-Assisted Setup for the full flow, CI usage, and unsupported agents.

Quick Start

The fastest way to get started is using the Phoenix OTEL wrapper, which provides sensible defaults and automatic configuration.

Python Setup

Use phoenix.otel for automatic configuration with Phoenix-aware defaults

TypeScript Setup

Use @arizeai/phoenix-otel to trace your Node.js applications

Instrumentation Methods

Choose how you want to instrument your code:

Auto Instrumentation

Automatically capture traces from popular frameworks and LLM providers with zero code changes

Tracing Helpers

Use decorators and helpers to easily trace specific methods or code blocks in Python

Organization

Organize your traces for better visibility and analysis:

Projects

Group traces by application or environment using projects

Sessions

Track multi-turn conversations by grouping related traces into sessions