Skip to content

docs(claude-code): fix invalid model IDs, add model pools/routing section#68

Open
tristantelleb wants to merge 1 commit into
mainfrom
fix/claude-code-model-ids-and-pools
Open

docs(claude-code): fix invalid model IDs, add model pools/routing section#68
tristantelleb wants to merge 1 commit into
mainfrom
fix/claude-code-model-ids-and-pools

Conversation

@tristantelleb

@tristantelleb tristantelleb commented Jul 10, 2026

Copy link
Copy Markdown
Member

What

Fixes and expands the Claude Code integration page (v3/integrations/claude-code.mdx).

Bug fix: invalid default model ID

The page referenced anthropic/claude-opus-4.7 (with a dot), which is not a valid catalog ID and returns model not found. The valid ID uses a dash (claude-opus-4-7). Upstream had fixed 2 of 5 occurrences; this cleans up the rest (bash setup block, the troubleshooting curl, and the "model not found" note).

Verified against the live catalog (GET https://api.edenai.run/v3/models): the dot form does not exist.

Staleness fix: use -latest aliases

Switched the setup block to the stable aliases claude-opus-latest / claude-sonnet-latest / claude-haiku-latest, which resolve to the newest model per tier (currently Opus 4-8 / Sonnet 5 / Haiku 4-5), so the default config never goes stale. Added a Tip on how to pin an exact version. Switching examples updated to current IDs.

New: "Model pools and routing" section

Documents Eden AI's actual routing features (verified in aifeatures/app/services/llm_router.py and the V3 OpenAPI schema):

  • @edenai smart routing, which works directly via ANTHROPIC_MODEL.
  • router_candidates (custom pool) and fallbacks (failover), with the honest caveat that Claude Code only forwards the model name, so those need the API/SDK. Links to the Smart Routing and Fallback pages.

Notes

  • No broken links introduced; both linked pages exist. No Python snippets on this page, so the snippet suite is unaffected.
  • dateModified bumped.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation
    • Updated Claude Code setup instructions with current model aliases and version-pinning guidance.
    • Refreshed model-switching examples with newer model identifiers.
    • Added guidance for automatic model routing, custom model pools, and ordered fallbacks.
    • Updated troubleshooting steps for resolving model-not-found errors using full provider/model identifiers.

…el pools

The Claude Code integration page referenced anthropic/claude-opus-4.7
(with a dot), which is not a valid catalog ID and returns model-not-found.
The valid ID uses a dash (claude-opus-4-7). This fixes the remaining dot
occurrences (bash setup, troubleshooting curl, and the "model not found"
note) and switches the setup block to the stable -latest aliases
(claude-opus-latest / claude-sonnet-latest / claude-haiku-latest) so the
default config never goes stale. Switching examples updated to current
IDs (Opus 4-8, Sonnet 5).

Adds a "Model pools and routing" section documenting @edenai smart
routing (works via ANTHROPIC_MODEL), plus router_candidates and fallbacks
with the caveat that Claude Code only forwards the model name.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Jul 10, 2026

Copy link
Copy Markdown

Review Change Stack

Walkthrough

The Claude Code integration guide updates its modification date, refreshes model identifiers and aliases, adds model routing and fallback documentation, and updates troubleshooting examples.

Changes

Claude Code integration documentation

Layer / File(s) Summary
Model aliases and troubleshooting
v3/integrations/claude-code.mdx
Setup and switching examples use newer Claude model IDs and -latest aliases, with guidance for pinning versions and troubleshooting full model identifiers.
Model pools and routing
v3/integrations/claude-code.mdx
Documents automatic @edenai routing plus custom router_candidates and fallbacks request fields.

Estimated code review effort: 2 (Simple) | ~10 minutes

Poem

A rabbit hops through models bright,
With latest tags to guide the night.
Pools and fallbacks neatly flow,
New Claude paths are set to go.
“Pin your version!” squeaks Bun.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly matches the main documentation updates: fixing invalid model IDs and adding the model pools/routing section.
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.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/claude-code-model-ids-and-pools

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick comments (1)
v3/integrations/claude-code.mdx (1)

50-57: 📐 Maintainability & Code Quality | 🔵 Trivial | 💤 Low value

Normalize PowerShell assignment spacing for consistency.

Lines 51–53 use spaces around = ($env:VAR = "value") while lines 54–56 omit them ($env:VAR="value"). Both are valid PowerShell, but the inconsistency within the same block is visually jarring and may confuse users about preferred syntax.

♻️ Proposed fix
-$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="anthropic/claude-haiku-latest"
-$env:ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-sonnet-latest"
-$env:ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-opus-latest"
+$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "anthropic/claude-haiku-latest"
+$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "anthropic/claude-sonnet-latest"
+$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "anthropic/claude-opus-latest"
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@v3/integrations/claude-code.mdx` around lines 50 - 57, Normalize the
PowerShell environment-variable assignments in the shown configuration block by
using one consistent spacing style around the equals sign for all entries,
including ANTHROPIC_API_KEY, ANTHROPIC_BASE_URL, ANTHROPIC_MODEL, and the
default model variables.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Nitpick comments:
In `@v3/integrations/claude-code.mdx`:
- Around line 50-57: Normalize the PowerShell environment-variable assignments
in the shown configuration block by using one consistent spacing style around
the equals sign for all entries, including ANTHROPIC_API_KEY,
ANTHROPIC_BASE_URL, ANTHROPIC_MODEL, and the default model variables.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 5b30bea5-5522-4669-b9d1-5b5031ef1007

📥 Commits

Reviewing files that changed from the base of the PR and between 5174e81 and f40ffb6.

📒 Files selected for processing (1)
  • v3/integrations/claude-code.mdx

@mintlify

mintlify Bot commented Jul 10, 2026

Copy link
Copy Markdown

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

Project Status Preview Updated (UTC)
edenai 🟢 Ready View Preview Jul 10, 2026, 3:36 PM

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant