> ## Documentation Index
> Fetch the complete documentation index at: https://arizeai-433a7140-roger-ci-skip-release-prs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Setup Tracing

> Configure tracing for your application

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.

<Steps>
  <Step title="Start Phoenix">
    In one terminal, start Phoenix and leave it running. It serves at `http://localhost:6006`:

    ```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
    uvx arize-phoenix serve
    ```

    Already have a Phoenix deployment? Skip this step. `px setup` can point at any running Phoenix, including a [self-hosted](/docs/phoenix/self-hosting) one.
  </Step>

  <Step title="Add tracing with a coding agent">
    In a new terminal, from your app's root directory, run one of these:

    <CodeGroup>
      ```bash npx theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
      npx -y @arizeai/phoenix-cli setup
      ```

      ```bash Install theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
      npm i -g @arizeai/phoenix-cli && px setup
      ```
    </CodeGroup>

    `px setup` hands the instrumentation to your coding agent and waits until a real trace arrives. It can also install the [Phoenix skills](/docs/phoenix/integrations/developer-tools/coding-agents#skills) so your agent can query what you capture. See [Agent-Assisted Setup](/docs/phoenix/agent-assisted-setup) for the full flow, CI usage, and unsupported agents.
  </Step>
</Steps>

## Quick Start

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

<CardGroup cols={2}>
  <Card title="Python Setup" icon="python" href="/docs/phoenix/tracing/how-to-tracing/setup-tracing/setup-using-phoenix-otel">
    Use `phoenix.otel` for automatic configuration with Phoenix-aware defaults
  </Card>

  <Card title="TypeScript Setup" icon="js" href="/docs/phoenix/sdk-api-reference/typescript/arizeai-phoenix-otel">
    Use `@arizeai/phoenix-otel` to trace your Node.js applications
  </Card>
</CardGroup>

***

## Instrumentation Methods

Choose how you want to instrument your code:

<CardGroup cols={2}>
  <Card title="Auto Instrumentation" icon="wand-magic-sparkles" href="/docs/phoenix/integrations">
    Automatically capture traces from popular frameworks and LLM providers with zero code changes
  </Card>

  <Card title="Tracing Helpers" icon="at" href="/docs/phoenix/tracing/how-to-tracing/setup-tracing/instrument">
    Use decorators and helpers to easily trace specific methods or code blocks in Python
  </Card>
</CardGroup>

***

## Organization

Organize your traces for better visibility and analysis:

<CardGroup cols={2}>
  <Card title="Projects" icon="folder" href="/docs/phoenix/tracing/how-to-tracing/setup-tracing/setup-projects">
    Group traces by application or environment using projects
  </Card>

  <Card title="Sessions" icon="messages" href="/docs/phoenix/tracing/how-to-tracing/setup-tracing/setup-sessions">
    Track multi-turn conversations by grouping related traces into sessions
  </Card>
</CardGroup>