From 07c9c91f8d4e252e9f7f8bf696e903f51fe84672 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 2f03492966e..fb84f52d738 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
 		```