diff --git a/docs/en/release-notes/changelog.md b/docs/en/release-notes/changelog.md
index 2ad578ae8..5b8b6557b 100644
--- a/docs/en/release-notes/changelog.md
+++ b/docs/en/release-notes/changelog.md
@@ -6,6 +6,45 @@ outline: 2
 
 This page documents the changes in each Kimi Code CLI release.
 
+## 0.20.2 (2026-06-29)
+
+### Features
+
+- Support the Anthropic-compatible protocol for Kimi Code, including video input.
+- Add a completion sound and question notifications to the web UI, with separate Settings toggles for completion notifications, question notifications, and sound. Question notifications default off so question text only reaches your desktop after you opt in.
+- Add `KIMI_CODE_CUSTOM_HEADERS` for custom outbound LLM request headers, and send the `User-Agent` header to non-Kimi providers. Set `KIMI_CODE_CUSTOM_HEADERS` to newline-separated `Name: Value` lines.
+- Add an optional `exclude_empty` parameter to the session list API to omit sessions that have no messages.
+
+### Bug Fixes
+
+- Recover from provider 413 context overflows by compacting before retrying.
+- Cap compaction output at 128k tokens by default to avoid provider `max_tokens` errors.
+- Fix compaction ignoring the configured max output size.
+- Fix unnecessary full-screen redraws when typing in the input box or toggling the slash panel.
+- Keep unsent composer attachments scoped to their session in the web UI, so switching sessions no longer leaks them into another session's next message.
+- Fix the web composer occasionally keeping typed text after sending the first message of a new session.
+- Fix debug timing output lingering after undoing a turn.
+- Fix working tips getting squeezed against the agent swarm progress bar.
+
+### Polish
+
+- Rework the web ask-user-question card into a step-by-step wizard so multi-question navigation and the final Submit action are easier to see.
+- In the bundled web UI, a new session is now created only when the first message is sent, so `+ New` without a workspace opens the composer instead of making an empty session.
+- Restore each session's scroll position when switching back to it in the web UI.
+- Keep the open side panel when switching between sessions in the web UI.
+- Scope the web composer's up/down input history to the current session instead of sharing it across all sessions.
+- In the bundled web UI, `/new` and `/clear` are now aliases that open the session onboarding composer and focus the input. iOS auto-zoom is prevented by keeping text inputs at 16px instead of disabling viewport scaling.
+- Hide unused "New Session" entries from the web session list by default.
+- Remove the `/sessions` slash command from the web UI; the sidebar already covers session browsing.
+- Show the first five sessions per workspace in the web sidebar instead of ten.
+- Replace the web composer attach button's plus icon with an image icon.
+
+### Refactors
+
+- Route Kimi Code models on the Anthropic-compatible protocol through the beta Messages API.
+- Upgrade web markdown renderer dependencies (katex, markstream-vue, shiki) for bug fixes and performance improvements.
+- Add provider type and protocol attributes to turn and API error telemetry.
+
 ## 0.20.1 (2026-06-26)
 
 ### Features
diff --git a/docs/zh/release-notes/changelog.md b/docs/zh/release-notes/changelog.md
index 2240560b6..e1ed926bf 100644
--- a/docs/zh/release-notes/changelog.md
+++ b/docs/zh/release-notes/changelog.md
@@ -6,6 +6,45 @@ outline: 2
 
 本页记录 Kimi Code CLI 每个版本的变更内容。
 
+## 0.20.2（2026-06-29）
+
+### 新功能
+
+- Kimi Code 现支持 Anthropic 兼容协议，并支持视频输入。
+- web UI 新增完成提示音与问题通知，并在设置中分别提供完成通知、问题通知和提示音的开关。问题通知默认关闭，仅在用户主动开启后才会将问题文本发送到桌面。
+- 新增 `KIMI_CODE_CUSTOM_HEADERS` 环境变量，用于自定义出站 LLM 请求头，并向非 Kimi 供应商发送 `User-Agent` 请求头。将 `KIMI_CODE_CUSTOM_HEADERS` 设为由换行分隔的 `Name: Value` 行。
+- 会话列表 API 新增可选的 `exclude_empty` 参数，用于省略没有任何消息的会话。
+
+### 修复
+
+- 遇到供应商 413 上下文溢出时，先压缩再重试以恢复。
+- 默认将压缩输出限制在 128k token，避免供应商 `max_tokens` 错误。
+- 修复压缩忽略已配置最大输出长度的问题。
+- 修复在输入框输入或切换斜杠面板时不必要的全屏重绘。
+- 在 web UI 中将未发送的输入框附件限定在所属会话内，切换会话时不再将其泄漏到另一个会话的下一条消息中。
+- 修复 web 输入框在新会话发送首条消息后偶尔残留已输入文本的问题。
+- 修复撤销轮次后调试计时输出残留的问题。
+- 修复运行提示被挤压到 Agent Swarm 进度条上的问题。
+
+### 优化
+
+- 将 web 询问用户问题卡片重做为分步向导，使多问题导航和最终的 Submit 操作更清晰。
+- 在内置 web UI 中，现在仅在发送首条消息时才创建新会话，因此未选择工作区时点击 `+ New` 会打开输入框，而不是创建空会话。
+- 在 web UI 中切换回某会话时恢复其滚动位置。
+- 在 web UI 中切换会话时保持已打开的侧面板。
+- 将 web 输入框的上下方向键输入历史限定在当前会话，不再跨会话共享。
+- 在内置 web UI 中，`/new` 和 `/clear` 现在作为别名打开会话引导输入框并聚焦输入；文本输入框字号保持为 16px 即可避免 iOS 自动放大，无需再禁用视口缩放。
+- 默认在 web 会话列表中隐藏未使用的 "New Session" 条目。
+- 从 web UI 中移除 `/sessions` 斜杠命令，侧边栏已覆盖会话浏览功能。
+- web 侧边栏每个工作区显示前五个会话，而非十个。
+- 将 web 输入框附件按钮的加号图标替换为图片图标。
+
+### 重构
+
+- 将 Anthropic 兼容协议上的 Kimi Code 模型改走 beta Messages API。
+- 升级 web Markdown 渲染器依赖（katex、markstream-vue、shiki），以修复问题并改进性能。
+- 在轮次和 API 错误遥测中新增供应商类型与协议属性。
+
 ## 0.20.1（2026-06-26）
 
 ### 新功能