docs: remove fallback ANTHROPIC_API_KEY approach from Claude Code docs

[impoiler]

Summary

Simplifies the Claude Code documentation by removing the fallback ANTHROPIC_API_KEY approach, keeping only the recommended ANTHROPIC_CUSTOM_HEADERS method for passing Bifrost virtual keys.

Changes

• Removed the mention of falling back to ANTHROPIC_API_KEY for older Claude Code versions from the note callout
• Removed the ANTHROPIC_API_KEY-based JSON configuration example and the transitional text pointing users toward ANTHROPIC_CUSTOM_HEADERS

Type of change

• Bug fix
• Feature
• Refactor
• Documentation
• Chore/CI

Affected areas

• Core (Go)
• Transports (HTTP)
• Providers/Integrations
• Plugins
• UI (React)
• Docs

How to test

Review the updated docs/cli-agents/claude-code.mdx to confirm the note and configuration section only reference the ANTHROPIC_CUSTOM_HEADERS approach without any mention of the ANTHROPIC_API_KEY fallback.

Breaking changes

• Yes
• No

Related issues

Security considerations

None.

Checklist

• I read docs/contributing/README.md and followed the guidelines
• I added/updated tests where appropriate
• I updated documentation where needed
• I verified builds succeed (Go and UI)
• I verified the CI pipeline passes locally if applicable

[impoiler]

• docs: remove fallback ANTHROPIC_API_KEY approach from Claude Code docs #3597 👈 (View in Graphite)
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: ecbd9785-fc76-49b3-bf5a-3652339b27e3

📥 Commits

Reviewing files that changed from the base of the PR and between ddf4747 and bec578e.

📒 Files selected for processing (1)

• docs/cli-agents/claude-code.mdx

---

📝 Walkthrough

Summary by CodeRabbit

• Documentation
  • Updated Claude Code integration documentation, removing references to legacy versions and outdated fallback methods.
  • Streamlined setup guidance to focus exclusively on the recommended custom headers approach for Bifrost integration.

Walkthrough

Documentation for Claude Code integration with Bifrost is modernized to remove outdated fallback guidance for older versions and consistently use ANTHROPIC_CUSTOM_HEADERS with the x-bf-vk header for Bifrost virtual key authentication in the example configuration.

Changes

Claude Code Integration Documentation

Layer / File(s)	Summary
Version support and configuration example docs/cli-agents/claude-code.mdx	The "Tested on Claude Code versions" note removes the sentence describing a fallback path for older versions without custom header support. The settings.json example env configuration is updated to use ANTHROPIC_CUSTOM_HEADERS (with x-bf-vk) instead of ANTHROPIC_API_KEY.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

• maximhq/bifrost#3562: Both PRs modify docs/cli-agents/claude-code.mdx to standardize Claude Code authentication on ANTHROPIC_CUSTOM_HEADERS (including x-bf-vk) and remove ANTHROPIC_API_KEY fallback guidance.

Suggested reviewers

• akshaydeo

Poem

🐰 Hop, hop, hop—the docs take flight!
Old fallbacks fade, new headers shine bright,
Custom headers sing with x-bf-vk,
Bifrost and Claude now in harmony's key! 🌈

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly and specifically describes the main change: removing the fallback ANTHROPIC_API_KEY approach from Claude Code documentation.
Description check	✅ Passed	The description follows the template structure with complete Summary and Changes sections, correctly identifies the change type as Documentation, marks the affected area (Docs), provides testing instructions, and confirms no breaking changes.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch 05-19-docs_claude_code_docs_updates

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
bifrost	🟢 Ready	View Preview	May 19, 2026, 2:16 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[github-actions]

🧪 Test Suite Available

This PR can be tested by a repository admin.

Run tests for PR #3597

[greptile-apps]

Confidence Score: 5/5

Documentation-only removal of a deprecated fallback; no code paths or runtime behaviour are affected.

The change removes a stale configuration example and its surrounding note. The remaining content is intact and accurate, and no other files are touched.

No files require special attention.

Important Files Changed

Filename	Overview
docs/cli-agents/claude-code.mdx	Removes the ANTHROPIC_API_KEY fallback configuration example and the associated note about older Claude Code versions, leaving only the recommended ANTHROPIC_CUSTOM_HEADERS approach.

_{Reviews (1): Last reviewed commit: "docs: claude code docs updates" | Re-trigger Greptile}

[akshaydeo]

Merge activity

• May 19, 2:19 PM UTC: A user started a stack merge that includes this pull request via Graphite.
• May 19, 2:20 PM UTC: @akshaydeo merged this pull request with Graphite.