From 9c70ba7dccc77422bf6c5a422db79d07041075b9 Mon Sep 17 00:00:00 2001 From: Ben Brandt Date: Thu, 16 Oct 2025 14:46:50 +0200 Subject: [PATCH] Fix split Claude Code docs (#40369) Closes #ISSUE Release Notes: - N/A *or* Added/Fixed/Improved ... --- docs/src/ai/external-agents.md | 42 ++++++++++++++++++++-------------- 1 file changed, 25 insertions(+), 17 deletions(-) diff --git a/docs/src/ai/external-agents.md b/docs/src/ai/external-agents.md index 6ee3ab4ac23ee6fa1cff317ab91e0c0532f8d0f1..508fd5211a119b1d36fe038f8b7d3a2d2b45d532 100644 --- a/docs/src/ai/external-agents.md +++ b/docs/src/ai/external-agents.md @@ -63,7 +63,7 @@ For more information, see the [Gemini CLI docs](https://github.com/google-gemini Similar to Zed's first-party agent, you can use Gemini CLI to do anything that you need. And to give it context, you can @-mention files, recent threads, symbols, or fetch the web. -> Note that some first-party agent features don't yet work with Gemini CLI: editing past messages, resuming threads from history, checkpointing, and using the agent in SSH projects. +> Note that some first-party agent features don't yet work with Gemini CLI: editing past messages, resuming threads from history, and checkpointing. > We hope to add these features in the near future. ## Claude Code @@ -113,6 +113,27 @@ If you want to override the executable used by the adapter, you can set the `CLA } ``` +### Usage + +Similar to Zed's first-party agent, you can use Claude Code to do anything that you need. +And to give it context, you can @-mention files, recent threads, symbols, or fetch the web. + +In complement to talking to it [over ACP](https://agentclientprotocol.com), Zed relies on the [Claude Code SDK](https://docs.anthropic.com/en/docs/claude-code/sdk/sdk-overview) to support some of its specific features. +However, the SDK doesn't yet expose everything needed to fully support all of them: + +- Slash Commands: A subset of [built-in commands](https://docs.anthropic.com/en/docs/claude-code/slash-commands#built-in-slash-commands) are supported, while [custom slash commands](https://docs.anthropic.com/en/docs/claude-code/slash-commands#custom-slash-commands) are fully supported. +- [Subagents](https://docs.anthropic.com/en/docs/claude-code/sub-agents) are supported. +- [Hooks](https://docs.anthropic.com/en/docs/claude-code/hooks-guide) are currently _not_ supported. + +> 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, and checkpointing. +> We hope to add these features in the near future. + +#### CLAUDE.md + +Claude Code in Zed will automatically use any `CLAUDE.md` file found in your project root, project subdirectories, or root `.claude` directory. + +If you don't have a `CLAUDE.md` file, you can ask Claude Code to create one for you through the `init` slash command. + ## Codex CLI You can also run [Codex CLI](https://github.com/openai/codex) directly via Zed's [agent panel](./agent-panel.md). @@ -154,25 +175,12 @@ Zed will always use this managed version of Codex even if you have it installed ### Usage -Similar to Zed's first-party agent, you can use Claude Code to do anything that you need. -And to give it context, you can @-mention files, recent threads, symbols, or fetch the web. +Similar to Zed's first-party agent, you can use Codex to do anything that you need. +And to give it context, you can @-mention files, symbols, or fetch the web. -In complement to talking to it [over ACP](https://agentclientprotocol.com), Zed relies on the [Claude Code SDK](https://docs.anthropic.com/en/docs/claude-code/sdk/sdk-overview) to support some of its specific features. -However, the SDK doesn't yet expose everything needed to fully support all of them: - -- Slash Commands: A subset of [built-in commands](https://docs.anthropic.com/en/docs/claude-code/slash-commands#built-in-slash-commands) are supported, while [custom slash commands](https://docs.anthropic.com/en/docs/claude-code/slash-commands#custom-slash-commands) are fully supported. -- [Subagents](https://docs.anthropic.com/en/docs/claude-code/sub-agents) are supported. -- [Hooks](https://docs.anthropic.com/en/docs/claude-code/hooks-guide) are currently _not_ supported. - -> 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. +> Note that some first-party agent features don't yet work with Codex: editing past messages, resuming threads from history, and checkpointing. > We hope to add these features in the near future. -#### CLAUDE.md - -Claude Code in Zed will automatically use any `CLAUDE.md` file found in your project root, project subdirectories, or root `.claude` directory. - -If you don't have a `CLAUDE.md` file, you can ask Claude Code to create one for you 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: