diff --git a/CHANGELOG.md b/CHANGELOG.md
index 66bd2462..1934d4c8 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,9 @@
 # Changelog
 
+## 2.1.25
+
+- Fixed beta header validation error for gateway users on Bedrock and Vertex, ensuring `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` avoids the error
+
 ## 2.1.23
 
 - Added customizable spinner verbs setting (`spinnerVerbs`)