Claude docs changes for January 30th, 2026 [diff]
Executive Summary
- New version 2.1.25: Fixed beta header validation for Bedrock/Vertex gateway users
- Structured outputs graduated from beta to GA with
output_formatrenamed tooutput_config.formatacross all SDKs - Analytics documentation rewritten for Teams/Enterprise dashboards with GitHub contribution metrics
New Claude Code versions
2.1.25
Major bug fixes
- Fixed beta header validation error for gateway users on Bedrock and Vertex, ensuring
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1avoids the error
Claude Code changes
Changed documents
Analytics [Source]
- Complete rewrite of analytics documentation with new structure for Teams/Enterprise and API customers. [lines 1-10] [Source]
- Added documentation for Teams and Enterprise dashboard including usage metrics, contribution metrics with GitHub integration, leaderboard, and data export capabilities. [lines 12-17] [Source]
- Added detailed setup instructions for enabling contribution metrics through GitHub app integration. [lines 19-51] [Source]
MCP [Source]
- Added Granola MCP server for AI notepad for meetings. [lines 79-83] [Source]
- Updated Atlassian transport from SSE to HTTP. [line 183] [Source]
- Added Smartsheet MCP server for analyzing and managing Smartsheet data. [lines 417-421] [Source]
- Added Supabase MCP server for managing databases, authentication, and storage. [lines 439-443] [Source]
Settings [Source]
- Added
spinnerVerbsconfiguration option to customize action verbs shown in spinner and turn duration messages. [line 163] [Source]
Setup [Source]
- Updated Windows operating system requirements to specify Windows 10 1809+ / Windows Server 2019+. [line 3] [Source]
API changes
New Documents
Agent SDK - Stream responses in real-time [Source]
New comprehensive documentation for streaming responses in the Agent SDK. Covers enabling streaming output with include_partial_messages / includePartialMessages, understanding StreamEvent message types, streaming text responses, streaming tool calls, building streaming UIs, and known limitations with extended thinking and structured outputs. Includes detailed examples for handling content_block_delta events, tracking tool execution progress, and creating cohesive streaming interfaces.
Changed documents
Remote MCP servers [Source]
- Added Granola remote MCP server. [lines 63-68] [Source]
- Added Smartsheet remote MCP server. [lines 573-578] [Source]
- Added Supabase remote MCP server. [lines 603-608] [Source]
Beta [Source]
- Removed structured outputs beta header requirement and updated parameter name from
output_formattooutput_config.format. [throughout file]
Beta - Messages [Source]
- Updated structured outputs parameter from
output_formattooutput_config.formatin examples. [throughout file]
Beta - Messages - Batches [Source]
- Updated structured outputs parameter references from
output_formattooutput_config.format. [throughout file]
Beta - Messages - Batches - Create [Source]
- Updated structured outputs parameter from
output_formattooutput_config.formatthroughout API reference. [throughout file]
Beta - Messages - Batches - Results [Source]
- Updated structured outputs parameter references in API response documentation. [throughout file]
Beta - Messages - Count tokens [Source]
- Updated structured outputs parameter from
output_formattooutput_config.format. [throughout file]
Beta - Messages - Create [Source]
- Added
output_configparameter with nestedformatobject for structured outputs configuration. [lines 1816-1832] [Source] - Added
strictparameter to Tool objects for schema validation guarantee. [lines 2244-2246] [Source] - Added
request_too_largeerror code to WebSearchToolRequestError. [line 1655] [Source]
Completions - Create [Source]
- Updated structured outputs parameter references from
output_formattooutput_config.format. [throughout file]
Go - Beta [Source]
- Updated Go SDK examples to use new
output_config.formatparameter instead ofoutput_format. [throughout file]
Go - Beta - Messages [Source]
- Updated Go SDK structured outputs examples with new parameter structure. [throughout file]
Go - Beta - Messages - Batches [Source]
- Updated Go SDK batch API examples with new structured outputs parameter. [throughout file]
Go - Beta - Messages - Batches - Create [Source]
- Updated structured outputs parameter in Go SDK batch create examples. [throughout file]
Go - Beta - Messages - Batches - Results [Source]
- Updated Go SDK batch results documentation with new parameter structure. [throughout file]
Go - Beta - Messages - Count tokens [Source]
- Updated Go SDK token counting examples with new structured outputs parameter. [throughout file]
Go - Beta - Messages - Create [Source]
- Updated Go SDK message creation examples with
output_config.formatparameter. [throughout file]
Go - Messages [Source]
- Updated Go SDK messages documentation with new structured outputs parameter. [throughout file]
Go - Messages - Batches [Source]
- Updated Go SDK batch messages with new parameter structure. [throughout file]
Go - Messages - Batches - Create [Source]
- Updated Go SDK batch create examples. [throughout file]
Go - Messages - Batches - Results [Source]
- Updated Go SDK batch results documentation. [throughout file]
Go - Messages - Count tokens [Source]
- Updated Go SDK token counting examples. [throughout file]
Go - Messages - Create [Source]
- Updated Go SDK message creation with new structured outputs parameter. [throughout file]
Java - Beta [Source]
- Updated Java SDK examples with new
output_config.formatparameter. [throughout file]
Java - Beta - Messages [Source]
- Updated Java SDK messages examples with new parameter structure. [throughout file]
Java - Beta - Messages - Batches [Source]
- Updated Java SDK batch examples. [throughout file]
Java - Beta - Messages - Batches - Create [Source]
- Updated Java SDK batch create documentation. [throughout file]
Java - Beta - Messages - Batches - Results [Source]
- Updated Java SDK batch results examples. [throughout file]
Java - Beta - Messages - Count tokens [Source]
- Updated Java SDK token counting documentation. [throughout file]
Java - Beta - Messages - Create [Source]
- Updated Java SDK message creation examples with new parameter. [throughout file]
Java - Messages [Source]
- Updated Java SDK messages documentation. [throughout file]
Java - Messages - Batches [Source]
- Updated Java SDK batch messages. [throughout file]
Java - Messages - Batches - Create [Source]
- Updated Java SDK batch create examples. [throughout file]
Java - Messages - Batches - Results [Source]
- Updated Java SDK batch results documentation. [throughout file]
Java - Messages - Count tokens [Source]
- Updated Java SDK token counting examples. [throughout file]
Java - Messages - Create [Source]
- Updated Java SDK message creation with new structured outputs parameter. [throughout file]
Messages [Source]
- Updated Messages API examples with new
output_config.formatparameter. [throughout file]
Messages - Batches [Source]
- Updated batch API examples with new parameter structure. [throughout file]
Messages - Batches - Create [Source]
- Updated batch create documentation with new structured outputs parameter. [throughout file]
Messages - Batches - Results [Source]
- Updated batch results examples. [throughout file]
Messages - Count tokens [Source]
- Updated token counting documentation with new parameter. [throughout file]
Messages - Create [Source]
- Added
output_configparameter with nestedformatobject for structured outputs configuration. [lines 1816-1832] [Source] - Added
strictparameter to Tool objects for guaranteed schema validation on tool names and inputs. [lines 2244-2246] [Source] - Added
request_too_largeerror code to WebSearchToolRequestError enum. [line 1655] [Source]
Python - Beta [Source]
- Updated Python SDK examples to use
output_config.formatand removed beta header requirements. [throughout file]
Python - Beta - Messages [Source]
- Updated Python SDK messages examples with new parameter structure. [throughout file]
Python - Beta - Messages - Batches [Source]
- Updated Python SDK batch examples. [throughout file]
Python - Beta - Messages - Batches - Create [Source]
- Updated Python SDK batch create documentation. [throughout file]
Python - Beta - Messages - Batches - Results [Source]
- Updated Python SDK batch results examples. [throughout file]
Python - Beta - Messages - Count tokens [Source]
- Updated Python SDK token counting documentation. [throughout file]
Python - Beta - Messages - Create [Source]
- Updated Python SDK message creation examples with new parameter and moved from
client.beta.messagestoclient.messages. [throughout file]
Python - Completions [Source]
- Updated Python SDK completions examples. [throughout file]
Python - Completions - Create [Source]
- Updated Python SDK completions create documentation. [throughout file]
Python - Messages [Source]
- Updated Python SDK messages documentation with new structured outputs parameter. [throughout file]
Python - Messages - Batches [Source]
- Updated Python SDK batch messages. [throughout file]
Python - Messages - Batches - Create [Source]
- Updated Python SDK batch create examples. [throughout file]
Python - Messages - Batches - Results [Source]
- Updated Python SDK batch results documentation. [throughout file]
Python - Messages - Count tokens [Source]
- Updated Python SDK token counting examples. [throughout file]
Python - Messages - Create [Source]
- Updated Python SDK message creation with new structured outputs parameter. [throughout file]
Ruby - Beta [Source]
- Updated Ruby SDK examples with new
output_config.formatparameter. [throughout file]
Ruby - Beta - Messages [Source]
- Updated Ruby SDK messages examples. [throughout file]
Ruby - Beta - Messages - Batches [Source]
- Updated Ruby SDK batch examples. [throughout file]
Ruby - Beta - Messages - Batches - Create [Source]
- Updated Ruby SDK batch create documentation. [throughout file]
Ruby - Beta - Messages - Batches - Results [Source]
- Updated Ruby SDK batch results examples. [throughout file]
Ruby - Beta - Messages - Count tokens [Source]
- Updated Ruby SDK token counting documentation. [throughout file]
Ruby - Beta - Messages - Create [Source]
- Updated Ruby SDK message creation examples with new parameter. [throughout file]
Ruby - Messages [Source]
- Updated Ruby SDK messages documentation. [throughout file]
Ruby - Messages - Batches [Source]
- Updated Ruby SDK batch messages. [throughout file]
Ruby - Messages - Batches - Create [Source]
- Updated Ruby SDK batch create examples. [throughout file]
Ruby - Messages - Batches - Results [Source]
- Updated Ruby SDK batch results documentation. [throughout file]
Ruby - Messages - Count tokens [Source]
- Updated Ruby SDK token counting examples. [throughout file]
Ruby - Messages - Create [Source]
- Updated Ruby SDK message creation with new structured outputs parameter. [throughout file]
TypeScript - Beta [Source]
- Updated TypeScript SDK examples with new
output_config.formatparameter. [throughout file]
TypeScript - Beta - Files - Download [Source]
- Updated TypeScript SDK files documentation. [throughout file]
TypeScript - Beta - Messages [Source]
- Updated TypeScript SDK messages examples. [throughout file]
TypeScript - Beta - Messages - Batches [Source]
- Updated TypeScript SDK batch examples. [throughout file]
TypeScript - Beta - Messages - Batches - Create [Source]
- Updated TypeScript SDK batch create documentation. [throughout file]
TypeScript - Beta - Messages - Batches - Results [Source]
- Updated TypeScript SDK batch results examples. [throughout file]
TypeScript - Beta - Messages - Count tokens [Source]
- Updated TypeScript SDK token counting documentation. [throughout file]
TypeScript - Beta - Messages - Create [Source]
- Updated TypeScript SDK message creation examples with new parameter. [throughout file]
TypeScript - Messages [Source]
- Updated TypeScript SDK messages documentation. [throughout file]
TypeScript - Messages - Batches [Source]
- Updated TypeScript SDK batch messages. [throughout file]
TypeScript - Messages - Batches - Create [Source]
- Updated TypeScript SDK batch create examples. [throughout file]
TypeScript - Messages - Batches - Results [Source]
- Updated TypeScript SDK batch results documentation. [throughout file]
TypeScript - Messages - Count tokens [Source]
- Updated TypeScript SDK token counting examples. [throughout file]
TypeScript - Messages - Create [Source]
- Updated TypeScript SDK message creation with new structured outputs parameter. [throughout file]
Citations [Source]
- Updated incompatibility note to reference new
output_config.formatparameter instead ofoutput_format. [line 125] [Source]
Extended thinking [Source]
Files [Source]
- Updated contact link for higher rate limits from obfuscated email to direct mailto link. [line 284] [Source]
Overview [Source]
- Updated structured outputs availability to include Amazon Bedrock (Beta) and changed from "Claude API (Beta)" to "Claude API" to reflect GA status. [line 23] [Source]
- Removed Opus 4.1 from supported models list for structured outputs. [line 23] [Source]
Structured outputs [Source]
- Changed from beta to GA status - removed beta header requirement and updated parameter from
output_formattooutput_config.format. [lines 1-13] [Source] - Added migration note explaining that old beta header and parameter will continue working during transition period. [lines 14-15] [Source]
- Updated all examples throughout the document to use new parameter structure. [throughout file]
- Updated Python SDK examples to use
client.messagesinstead ofclient.beta.messages. [lines 129-162] [Source] - Removed Opus 4.1 from supported models. [line 11] [Source]
Release notes - Overview [Source]
- Added January 29, 2026 release note announcing structured outputs GA with expanded schema support, improved grammar compilation latency, and simplified integration. [lines 9-11] [Source]