From 3b7dbb87b07e8b784ce52fbbf36e06ae9011e3b3 Mon Sep 17 00:00:00 2001
From: Danilo Leal <67129314+danilo-leal@users.noreply.github.com>
Date: Wed, 3 Sep 2025 18:31:54 -0300
Subject: [PATCH] docs: Add note about `CLAUDE.md` usage (#37496)

Some users asked whether Claude Code in Zed can also observe/consume
`CLAUDE.md` guidelines, regardless of whether they're at the root
`.claude` directory or within the project. Answer is yes and the
documentation will mention it now!

Release Notes:

- N/A
---
 docs/src/ai/external-agents.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/src/ai/external-agents.md b/docs/src/ai/external-agents.md
index de374511d053d6226e22c3d55e1cf2a96b91ad85..c0794a6a0181369e97d50cca64c9a711fbd8e5f4 100644
--- a/docs/src/ai/external-agents.md
+++ b/docs/src/ai/external-agents.md
@@ -98,6 +98,11 @@ However, the SDK doesn't yet expose everything needed to fully support all of th
 > Also note that some [first-party agent](./agent-panel.md) features don't yet work with Claude Code: editing past messages, resuming threads from history, checkpointing, and using the agent in SSH projects.
 > We hope to add these features in the near future.
 
+#### CLAUDE.md
+
+If you already have a `CLAUDE.md` file in your project (either at the root of it or in subdirectories) or at your root `.claude` directory, Claude Code in Zed will use it.
+If you don't have one, you can make Claude Code create one for you through through the `init` slash command.
+
 ## Add Custom Agents {#add-custom-agents}
 
 You can run any agent speaking ACP in Zed by changing your settings as follows: