fix: update valid models list to include claude-opus-4-5 (anthropics#323)

* fix: update valid models list to include claude-opus-4-5

Replace claude-opus-4-1 with claude-opus-4-5 in the cookbook audit skill
validation and documentation.

Closes anthropics#322

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

* fix: complete opus-4-5 migration across all validation systems

- Update deprecated model mappings in scripts/validate_all_notebooks.py
- Add claude-opus-4-1 -> claude-opus-4-5 deprecation in both validation scripts
- Add deprecation warning handling in cookbook audit skill (warnings instead of errors)
- Add Opus model to CLAUDE.md documentation

This ensures 18+ existing notebooks using claude-opus-4-1 will show deprecation
warnings rather than failing validation.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

---------

Co-authored-by: Claude <[email protected]>

Author: PedramNavid

.claude/skills/cookbook-audit/SKILL.md

@@ -123,7 +123,7 @@ Use this to ensure comprehensive coverage:
 **Technical Requirements**
 - [ ] Executable without modification (except API keys)
 - [ ] Uses non-deprecated API patterns
-- [ ] Uses valid model names (claude-sonnet-4-5, claude-haiku-4-5, claude-opus-4-1)
+- [ ] Uses valid model names (claude-sonnet-4-5, claude-haiku-4-5, claude-opus-4-5)
 - [ ] Model name defined as constant at top of notebook
 - [ ] Includes dependency specifications
 - [ ] Assigned to primary category

.claude/skills/cookbook-audit/validate_notebook.py

@@ -327,11 +327,16 @@ def check_model_constant(self):
     def check_deprecated_patterns(self):
         """Check for deprecated API patterns and invalid models."""
         # Valid models
-        valid_models = ["claude-sonnet-4-5", "claude-haiku-4-5", "claude-opus-4-1"]
+        valid_models = ["claude-sonnet-4-5", "claude-haiku-4-5", "claude-opus-4-5"]
 
         # Pattern to match model strings
         model_pattern = r'["\']claude-([a-z0-9\.-]+)["\']'
 
+        # Deprecated models that should be migrated
+        deprecated_models = {
+            "claude-opus-4-1": "claude-opus-4-5",
+        }
+
         deprecated_patterns = {
             r"\.completion\(": "Using old completion API (use messages API)",
         }
@@ -342,11 +347,16 @@ def check_deprecated_patterns(self):
 
             source = self.get_cell_source(cell)
 
-            # Check for invalid models
+            # Check for invalid or deprecated models
             model_matches = re.findall(model_pattern, source)
             for match in model_matches:
                 full_model = f"claude-{match}"
-                if full_model not in valid_models:
+                if full_model in deprecated_models:
+                    self.warnings.append(
+                        f"Cell {i}: Deprecated model '{full_model}'. "
+                        f"Please update to '{deprecated_models[full_model]}'"
+                    )
+                elif full_model not in valid_models:
                     self.issues.append(
                         f"Cell {i}: Invalid model '{full_model}'. "
                         f"Valid models are: {', '.join(valid_models)}"

CLAUDE.md

@@ -64,6 +64,7 @@ style: lint/format
 3. **Models:** Use current Claude models. Check docs.anthropic.com for latest versions.
    - Sonnet: `claude-sonnet-4-5-20250929`
    - Haiku: `claude-haiku-4-5-20251001`
+   - Opus: `claude-opus-4-5-20251101`
 
 4. **Notebooks:**
    - Keep outputs in notebooks (intentional for demonstration)

scripts/validate_all_notebooks.py

@@ -114,10 +114,11 @@ def validate_notebook(self, notebook_path: Path, mode: str = "full") -> dict:
             "claude-3-5-sonnet-latest": "claude-sonnet-4-5",
             "claude-3-haiku-20240307": "claude-haiku-4-5",
             "claude-3-5-haiku-20241022": "claude-haiku-4-5",
-            "claude-3-opus-20240229": "claude-opus-4-1",
-            "claude-3-opus-latest": "claude-opus-4-1",
+            "claude-3-opus-20240229": "claude-opus-4-5",
+            "claude-3-opus-latest": "claude-opus-4-5",
             "claude-sonnet-4-20250514": "claude-sonnet-4-5",
-            "claude-opus-4-20250514": "claude-opus-4-1",
+            "claude-opus-4-20250514": "claude-opus-4-5",
+            "claude-opus-4-1": "claude-opus-4-5",
         }
 
         for i, cell in enumerate(nb.get("cells", [])):
@@ -643,10 +644,11 @@ def fix_deprecated_models(self, notebook_path: Path) -> bool:
                 "claude-3-5-sonnet-latest": "claude-sonnet-4-5",
                 "claude-3-haiku-20240307": "claude-haiku-4-5",
                 "claude-3-5-haiku-20241022": "claude-haiku-4-5",
-                "claude-3-opus-20240229": "claude-opus-4-1",
-                "claude-3-opus-latest": "claude-opus-4-1",
+                "claude-3-opus-20240229": "claude-opus-4-5",
+                "claude-3-opus-latest": "claude-opus-4-5",
                 "claude-sonnet-4-20250514": "claude-sonnet-4-5",
-                "claude-opus-4-20250514": "claude-opus-4-1",
+                "claude-opus-4-20250514": "claude-opus-4-5",
+                "claude-opus-4-1": "claude-opus-4-5",
             }
 
             modified = False