[DOCS] Outdated model versions in documentation and lack of alias-first examples

Documentation Type

Unclear/confusing documentation

Documentation Location

• docs/en/model-config.md - docs/en/statusline.md - docs/en/amazon-bedrock.md - docs/en/agent-sdk/sessions.md

Section/Topic

• Code examples and JSON configuration snippets showing the model or id fields.

Current Documentation

• docs/en/model-config.md: "model": "claude-opus-4-1"
• docs/en/statusline.md: "id": "claude-opus-4-1"
• docs/en/agent-sdk/sessions.md: model: "claude-sonnet-4-5" (Generic string)
• docs/en/amazon-bedrock.md: global.anthropic.claude-sonnet-4-5-20250929-v1:0

What's Wrong or Missing?

The documentation examples are significantly behind the software's capabilities as noted in the changelog:

• Opus Version Mismatch: Changelog 2.0.51 and 2.0.58 confirm the availability of Opus 4.5, yet the primary configuration guides and status line examples still reference claude-opus-4-1.
• Hardcoded Strings vs. Aliases: Many examples use long, brittle version strings (e.g., claude-sonnet-4-5-20250929). While technically correct, this forces a documentation update every few months. The documentation should prioritize simple aliases (sonnet, opus, haiku) which are already supported by the CLI and SDK.
• Platform Discrepancy: Amazon Bedrock documentation uses the specific v1:0 strings, while other files use varying formats, confusing users on what the "blessed" string for the latest version is.

Suggested Improvement

• Prioritize Aliases: Update all primary configuration examples to use "model": "sonnet" or "model": "opus" instead of hardcoded date-stamped strings. This makes the documentation "future-proof."
• Update Legacy References: Replace all claude-opus-4-1 references with claude-opus-4-5 to reflect the latest stable release.
• Alias Guide: Add a clear note in model-config.md explicitly recommending the use of aliases (sonnet/opus) to ensure users automatically stay on the latest version as Anthropic updates the underlying snapshots.

Impact

High - Prevents users from using a feature

Additional Context

• Changelog 2.0.51: "Added Opus 4.5! https://www.anthropic.com/news/claude-opus-4-5"
• Changelog 2.0.58: "Pro users now have access to Opus 4.5 as part of their subscription!"
• Internal Consistency: While docs/en/amazon-bedrock.md lists the current IDs correctly, the general model-config.md (which most users find first) is still pointing to the 4-1 generation.