从 Claude Code 迁移至 Warp

Claude Code 与本节中的其他来源不同：它不是一个终端模拟器，而是一个在任何终端中运行的 CLI 代理。Warp 是一个智能开发环境，内置了[代码编辑器](/code/code-editor/)、[代码审查](/code/code-review/)、[团队协作](/knowledge-and-collaboration/warp-drive/)和 [MCP](/agent-platform/capabilities/mcp/) 支持——因此您有两种路径可供选择

• 在 Warp 中使用 Claude Code - 您希望继续使用 Claude Code 作为您的编码代理并在 Warp 的终端中运行它。
• 从 Claude Code 切换到 Agent 模式 - 您希望用 Warp 内置的[Agent 模式](/agent-platform/local-agents/overview/)替换 Claude Code。

在 Warp 中使用 Claude Code

Warp 通过其[第三方 CLI 代理](/agent-platform/cli-agents/overview/)集成，为 Claude Code 提供一流支持。打开一个新标签页并运行

claude

Warp 自动检测 Claude Code 并在 TUI 之上解锁 IDE 级功能

• 富输入编辑器 (Ctrl+G) - 使用 @ 提及、语音输入和斜杠命令撰写多行提示。
• 代理通知 - 当 Claude Code 需要您的输入时，提供应用内和桌面警报。需要一次性插件安装（Warp 会提示您）。
• 内联代码审查 - 直接从 Warp 的[代码审查](/code/code-review/)面板向代理发送审查评论。
• 带有代理元数据的垂直标签页 - 通过状态指示器跟踪多个 Claude Code 会话。
• 远程控制 - 从另一设备共享或操控 Claude Code 会话。
• 标签页配置 - 保存并重新打开 Claude Code 会话布局。

有关完整的设置步骤（通知插件、生产力提示、故障排除），请参阅[在 Warp 中使用 Claude Code](/agent-platform/cli-agents/claude-code/) 和[如何设置 Claude Code](/guides/external-tools/how-to-set-up-claude-code/) 指南。

提示

• 在[终端模式](/agent-platform/local-agents/interacting-with-agents/terminal-and-agent-modes/)下运行 Claude Code，而不是 Agent 模式。如果您不小心进入了 Agent 模式，请按 ⌘+I (macOS) 或 Ctrl+I (Linux/Windows) 来切换模式。
• 使用 Shift+Enter 换行。 在 Claude Code 的提示中，使用 Shift+Enter 插入新行。如果它反而提交了消息，请检查您是否处于终端模式（而非 Agent 模式），并且您使用的是最新的 Warp 版本。
• 复制/粘贴处理。 Warp 默认启用带括号粘贴，因此将多行内容粘贴到 Claude Code 中无需额外配置即可工作。
• Warp 重启后恢复。 Warp 的[会话恢复](/terminal/sessions/session-restoration/)功能会保留标签页和窗格，但不会保留正在运行的 CLI 进程——关闭 Warp 会结束 Claude Code 的会话。重新打开 Warp 后，使用 Claude Code 内置的恢复选项（例如 claude --resume）来继续对话。

API 密钥和身份验证

Claude Code 的身份验证（API 密钥或 Anthropic 账户）由 Claude Code 本身处理，而不是 Warp。Warp 不会代理或修改 Claude Code 的网络调用。通过 [Warp Drive 环境变量](/knowledge-and-collaboration/warp-drive/environment-variables/) 配置您的 ANTHROPIC_API_KEY 环境变量，以便在不同会话中共享它，而无需将其提交到 shell 配置文件中。

从 Claude Code 切换到 Agent 模式

如果您准备用 Warp 内置的代理替换 Claude Code，核心工作流程如下

1. 在 Warp 中打开一个新标签页。
2. 要从终端模式切换到[Agent 模式](/agent-platform/local-agents/overview/)，请按 ⌘+Enter（或 Ctrl+Shift+Enter）
3. 用自然语言描述您想要实现什么。

Warp 的代理会读取您的代码库，运行命令，并像 Claude Code 一样编辑文件。

哪些会转移：上下文和规则

Claude Code 用户经常问的问题是：Warp 的代理会自动读取哪些文件和上下文？ Warp 会从您的仓库根目录中的 AGENTS.md（或 WARP.md）文件中获取项目规则——这直接等同于 Claude Code 的 CLAUDE.md。在 Agent 模式下运行 /init 来生成一个，或者重命名您现有的规则文件即可——无需重写。

Warp 的代理还会从其他几个明确的来源获取上下文

• 代码库上下文 - 当您打开一个目录时，Warp 会索引您的 Git 跟踪文件，以便代理可以搜索和引用您的代码，而无需您粘贴代码片段。
• 规则 - 全局和项目范围的规则。AGENTS.md 和 WARP.md 会自动在项目根目录中被识别；其他规则存储在 Warp Drive 中。
• Warp Drive - 您保存的笔记本、工作流程和环境变量可作为上下文供代理使用。
• Agent 模式上下文 - 将特定文件或笔记本固定到对话中，以便代理始终将其纳入范围。
• MCP - 您配置的任何 MCP 服务器都会使代理能够访问外部工具和数据。

需要重新配置什么

• 迁移您的 CLAUDE.md。 将其重命名为 AGENTS.md（或者如果您希望它超出仓库范围，可以将其复制到 Warp [规则](/agent-platform/capabilities/rules/)中）。Warp 会自动将其应用于新的对话。
• 设置您在 Claude Code 中依赖的 [MCP 服务器](/agent-platform/capabilities/mcp/)。
• 使用模型选择器为每个对话选择一个模型。请参阅[模型选择](/agent-platform/inference/model-choice/)。Warp 支持 Claude、GPT、Gemini 和 Auto。
• 配置代理的[配置文件和权限](/agent-platform/capabilities/agent-profiles-permissions/)，以决定代理可以自动执行什么操作。

与 Claude Code 的主要区别

• 紧密的终端集成。 Agent 模式在 Warp 内部运行，并能看到您的终端会话的完整状态——打开的文件、命令历史记录、环境变量——而无需您粘贴上下文。
• 并行代理。 Warp 可以同时在多个标签页中运行多个代理对话，每个对话都有自己的状态，您可以在代理管理面板中跟踪这些状态。
• 内置代码审查。 代理生成的差异会在 Warp 的[代码审查](/code/code-review/)面板中打开，而不是在终端中。
• 云编排。 长期运行或计划的代理工作可以卸载到 [Oz](/agent-platform/cloud-agents/overview/)。

Warp 原生对应功能

Claude Code 概念及其在 Warp 中的最接近对应项

来自 Claude Code	在 Warp
CLAUDE.md	AGENTS.md（或 WARP.md）在项目根目录，作为[规则](/agent-platform/capabilities/rules/)被识别
Claude Code 斜杠命令	Warp 自己的[斜杠命令](/agent-platform/capabilities/slash-commands/)（/init、/plan、/model 等）；您可以将自己的命令保存为[Warp Drive 提示](/knowledge-and-collaboration/warp-drive/prompts/)
工具定义	[MCP](/agent-platform/capabilities/mcp/)
恢复对话	Warp 会在每个标签页中保留代理对话；结合[标签页配置](/terminal/windows/tab-configs/)可重新打开相同的项目布局

要深入了解 Agent 模式，请参阅[在 Warp 中编码](/getting-started/quickstart/coding-in-warp/)和 [Warp 代理文档](/agent-platform/local-agents/overview/)。