0d3cb498a3
CI / Shell Format Check (push) Has been cancelled
CI / Check Ruby (3.4) (push) Has been cancelled
CI / CI Config (push) Has been cancelled
CI / Test on Node ${{ matrix.node }} and ${{ matrix.os }}${{ matrix.shard && format(' (shard {0}/3)', matrix.shard) || '' }} (push) Has been cancelled
CI / Build on Node ${{ matrix.node }} (push) Has been cancelled
CI / Style Check (push) Has been cancelled
CI / Generate Assets (push) Has been cancelled
CI / Check Python (3.14) (push) Has been cancelled
CI / Check Python (3.9) (push) Has been cancelled
CI / Build Docs (push) Has been cancelled
CI / Code Scan Action (push) Has been cancelled
CI / Site tests (push) Has been cancelled
CI / webui tests (push) Has been cancelled
CI / Run Integration Tests (push) Has been cancelled
CI / Run Smoke Tests (push) Has been cancelled
CI / Go Tests (push) Has been cancelled
CI / Share Test (push) Has been cancelled
CI / Redteam (Production API) (push) Has been cancelled
CI / Redteam (Staging API) (push) Has been cancelled
CI / GitHub Actions Lint (push) Has been cancelled
CI / Check Ruby (3.0) (push) Has been cancelled
release-please / release-please (push) Has been cancelled
release-please / build (push) Has been cancelled
release-please / publish-npm (push) Has been cancelled
release-please / publish-npm-backfill (push) Has been cancelled
release-please / docker (push) Has been cancelled
release-please / publish-code-scan-action (push) Has been cancelled
release-please / attest-code-scan-action (push) Has been cancelled
Deploy local.promptfoo.app / Deploy to Cloudflare Pages (push) Has been cancelled
Test and Publish Multi-arch Docker Image / test (push) Has been cancelled
Test and Publish Multi-arch Docker Image / build-docker-and-push-digests (map[digest-suffix:linux-amd64 platform:linux/amd64 runner:ubuntu-latest]) (push) Has been cancelled
Test and Publish Multi-arch Docker Image / build-docker-and-push-digests (map[digest-suffix:linux-arm64 platform:linux/arm64 runner:ubuntu-24.04-arm]) (push) Has been cancelled
Test and Publish Multi-arch Docker Image / merge-docker-digests (push) Has been cancelled
Test and Publish Multi-arch Docker Image / Attest Multi-arch Image (push) Has been cancelled
Validate Renovate Config / Validate Renovate Configuration (push) Has been cancelled
64 lines
2.0 KiB
Markdown
64 lines
2.0 KiB
Markdown
# anthropic/claude-code-session (Authenticate via Claude Code session)
|
|
|
|
This example shows how to run Promptfoo evals against the Anthropic Messages
|
|
API — including `llm-rubric` model-graded assertions — by reusing an existing
|
|
local Claude Code session instead of creating a separate Anthropic Console API
|
|
key.
|
|
|
|
It's meant for Claude Pro / Max subscribers who already use the
|
|
[`claude` CLI](https://docs.claude.com/en/docs/claude-code/overview) on the
|
|
same machine.
|
|
|
|
You can run this example with:
|
|
|
|
```bash
|
|
npx promptfoo@latest init --example anthropic/claude-code-session
|
|
cd anthropic/claude-code-session
|
|
```
|
|
|
|
## Prerequisites
|
|
|
|
1. Install and log in to Claude Code:
|
|
|
|
```bash
|
|
claude /login
|
|
```
|
|
|
|
Promptfoo reads the OAuth credential that Claude Code stores in either the
|
|
macOS keychain (`Claude Code-credentials`) or
|
|
`$HOME/.claude/.credentials.json`.
|
|
|
|
2. Make sure `ANTHROPIC_API_KEY` is **unset** if you specifically want
|
|
Promptfoo to use your Claude Code session. If the env var is set, Promptfoo
|
|
will prefer it over the OAuth credential.
|
|
|
|
## How it works
|
|
|
|
The provider config sets `apiKeyRequired: false`, which tells Promptfoo to:
|
|
|
|
- Skip its upfront API key check.
|
|
- Load the Claude Code OAuth credential from the local session.
|
|
- Authenticate Messages API requests with a Bearer token plus the
|
|
`claude-code-20250219,oauth-2025-04-20` beta headers.
|
|
- Prepend the required Claude Code identity system block
|
|
(`"You are Claude Code, Anthropic's official CLI for Claude."`) before your
|
|
own system prompt.
|
|
|
|
Requests made this way are expected to count against your Claude
|
|
subscription the same way calls from the `claude` CLI do. Check
|
|
[Anthropic's documentation](https://docs.claude.com/en/docs/claude-code/overview)
|
|
for current billing behavior.
|
|
|
|
## Run it
|
|
|
|
```bash
|
|
promptfoo eval
|
|
promptfoo view
|
|
```
|
|
|
|
## Configuration
|
|
|
|
See `promptfooconfig.yaml` — both the main provider and the `llm-rubric`
|
|
grader point at `anthropic:messages:claude-sonnet-4-6` with
|
|
`apiKeyRequired: false` so the entire eval runs on your Claude subscription.
|