diff --git a/docs/references/settings_example.png b/docs/references/settings_example.png
index 1bd18430..202464f0 100644
Binary files a/docs/references/settings_example.png and b/docs/references/settings_example.png differ
diff --git a/packages/vscode/src/extension.ts b/packages/vscode/src/extension.ts
index 21c0004e..cf0c0706 100644
--- a/packages/vscode/src/extension.ts
+++ b/packages/vscode/src/extension.ts
@@ -26,6 +26,13 @@ const formatDurationMs = (value: number | null | undefined) => {
 export async function activate(context: vscode.ExtensionContext) {
   outputChannel = vscode.window.createOutputChannel('OpenChamber');
 
+  // Migration: clear legacy auto-set API URLs (ports 47680-47689 were auto-assigned by older extension versions)
+  const config = vscode.workspace.getConfiguration('openchamber');
+  const legacyApiUrl = config.get<string>('apiUrl') || '';
+  if (/^https?:\/\/localhost:4768\d\/?$/.test(legacyApiUrl.trim())) {
+    await config.update('apiUrl', '', vscode.ConfigurationTarget.Global);
+  }
+
   // Create OpenCode manager first
   openCodeManager = createOpenCodeManager(context);