diff --git a/sdk/identity/azure-identity/CHANGELOG.md b/sdk/identity/azure-identity/CHANGELOG.md
index 97ebd56c82d8..97653d07925a 100644
--- a/sdk/identity/azure-identity/CHANGELOG.md
+++ b/sdk/identity/azure-identity/CHANGELOG.md
@@ -9,6 +9,7 @@
 ### Bugs Fixed
 
 ### Other Changes
+- VisualStudioCodeCredential prints an informative error message when used (as it is currently broken) ([#30385](https://github.com/Azure/azure-sdk-for-python/pull/30385))
 
 ## 1.13.0 (2023-05-11)
 
diff --git a/sdk/identity/azure-identity/azure/identity/_credentials/vscode.py b/sdk/identity/azure-identity/azure/identity/_credentials/vscode.py
index 57e9dee4b7e1..2e0ff34843c5 100644
--- a/sdk/identity/azure-identity/azure/identity/_credentials/vscode.py
+++ b/sdk/identity/azure-identity/azure/identity/_credentials/vscode.py
@@ -46,7 +46,13 @@ def _get_refresh_token(self) -> str:
         if not self._refresh_token:
             self._refresh_token = get_refresh_token(self._cloud)
             if not self._refresh_token:
-                raise CredentialUnavailableError(message="Failed to get Azure user details from Visual Studio Code.")
+                message = (
+                    "Failed to get Azure user details from Visual Studio Code. "
+                    "Currently, the VisualStudioCodeCredential only works with the Azure "
+                    "Account extension version 0.9.11 and earlier. A long-term fix is in "
+                    "progress, see https://github.com/Azure/azure-sdk-for-python/issues/25713"
+                )
+                raise CredentialUnavailableError(message=message)
         return self._refresh_token
 
     def _initialize(self, vscode_user_settings: Dict, **kwargs: Any) -> None: