From 01e05c15268dedb76da95f442fbf5201cd8e7a44 Mon Sep 17 00:00:00 2001
From: shivam <91240327+shivamhwp@users.noreply.github.com>
Date: Mon, 14 Sep 2026 12:39:57 +0530
Subject: [PATCH] docs(claude): clarify OpenRouter model selection (#11369)

---
 docs/user/providers-claude.md | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/docs/user/providers-claude.md b/docs/user/providers-claude.md
index 6d3ee3b16300cf04d1e6c5a4d29a9169a7ec7e7a..cce194dbd2b4ac690fc23086a992c1c962d3eb34 100644
--- a/docs/user/providers-claude.md
+++ b/docs/user/providers-claude.md
@@ -88,8 +88,15 @@ If that Claude config directory has a cached Anthropic login, run `/logout` in a
 Claude Code session using that directory before starting the router setup. Cached
 login credentials can conflict with the router token.
 
-Verify requests in OpenRouter's activity dashboard. For model-role overrides and
-current compatibility requirements, use the
+Select the model you want in T3 Code. For an OpenRouter model outside the built-in
+list, open that Claude instance in **Settings > Providers** and add its full model
+ID with **Add custom model**. Then select it in the chat model picker.
+`ANTHROPIC_DEFAULT_*_MODEL` variables map Claude Code aliases such as `sonnet`; they
+do not replace the explicit model ID selected in T3 Code. Custom models may have
+fewer effort, thinking, or context controls than built-in models.
+
+Verify the model used in OpenRouter's activity dashboard. For current compatibility
+requirements, use the
 [OpenRouter Claude Code guide](https://openrouter.ai/docs/cookbook/coding-agents/claude-code-integration).
 
 ## Other routers
-- 
2.54.0