diff --git a/docs/cli.md b/docs/cli.md
index 3aba477d20e..ba0930ff7fd 100644
--- a/docs/cli.md
+++ b/docs/cli.md
@@ -336,11 +336,15 @@ If the package(s) you want to install provide extras, you can specify them
 when adding the package:
 
 ```bash
-poetry add requests[security,socks]
+poetry add "requests[security,socks]"
 poetry add "requests[security,socks]~=2.22.0"
 poetry add "git+https://github.com/pallets/flask.git@1.1.1[dotenv,dev]"
 ```
 
+{{% warning %}}
+Some shells may treat square braces (`[` and `]`) as special characters. It is suggested to always quote arguments containing these characters to prevent unexpected shell expansion.
+{{% /warning %}}
+
 If you want to add a package to a specific group of dependencies, you can use the `--group (-G)` option:
 
 ```bash