From 30ae9c4087218f20fd34709aa221a96bbbf6b09e Mon Sep 17 00:00:00 2001
From: devndevs <67359053+devndevs@users.noreply.github.com>
Date: Thu, 17 Sep 2026 20:59:58 -0700
Subject: [PATCH] [Agent setup] Split Claude Code plugin install into separate
 code blocks

The "Install the Cloudflare plugin" step puts both plugin slash commands in a single code block, so the copy button hands the user two lines that cannot be run together.

Claude Code accepts one slash command per message, and there is an ordering dependency regardless: /plugin install cloudflare@cloudflare cannot resolve the cloudflare marketplace until /plugin marketplace add cloudflare/skills has finished registering it, and that first command can prompt for a trust confirmation. A user who copies the block and pastes it hits a real error and reasonably concludes the docs are wrong.

This splits the commands into two code blocks so each gets its own copy button, and adds "one at a time" to the instruction text so the sequencing is explicit. The commands themselves are unchanged.
---
 src/content/docs/agent-setup/claude-code.mdx | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/content/docs/agent-setup/claude-code.mdx b/src/content/docs/agent-setup/claude-code.mdx
index 37827fdee67..1423b944fdf 100644
--- a/src/content/docs/agent-setup/claude-code.mdx
+++ b/src/content/docs/agent-setup/claude-code.mdx
@@ -44,10 +44,12 @@ import { LinkCard } from "~/components";
 
 	3. **Install the Cloudflare plugin**
 
-		In Claude Code, run these two slash commands. This installs Cloudflare Skills and registers the Cloudflare MCP servers.
+		In Claude Code, run these two slash commands one at a time, waiting for the first to finish before running the second. This installs Cloudflare Skills and registers the Cloudflare MCP servers.
 
 		```txt
 		/plugin marketplace add cloudflare/skills
+		```
+		```txt
 		/plugin install cloudflare@cloudflare
 		```