sessions
管理会话 命名、恢复、分支和在 Claude Code 对话之间切换。涵盖 --continue、--resume、--from-pr、/resume 选择器、会话命名和文本记录存储位置。 会话是与项目目录关联的已保存对话。Claude Code 在您工作时将其本地存储,因此您可以从中断处恢复、分支以尝试不同的方法,或在任务之间切换。 桌面应用、网页版 Claude Code 和 VS Code 扩展各自维护自己的会话历史记录。本页涵盖 CLI: 恢复之前的对话(通过标志、名称或 PR) 命名会话以便稍后查找 使用 /resume 选择器浏览会话 分支对话以尝试不同的方法 导出文本记录并在磁盘上找到它们 恢复会话会话在您工作时持续保存到本地文本记录文件,因此您可以在退出或运行 /clear 后返回到一个会话。使用这些入口点: 命令 功能 claude --continue 恢复当前目录中最近的会话 claude --resume 打开会话选择器 claude --resume <name> 直接恢复命名的会话 claude --from-...
scheduled-tasks
按计划运行提示词 使用 /loop 和 cron 调度工具在 Claude Code 会话中重复运行提示词、轮询状态或设置一次性提醒。 计划任务需要 Claude Code v2.1.72 或更高版本。使用 `claude --version` 检查您的版本。 计划任务让 Claude 按间隔自动重新运行提示词。使用它们来轮询部署、监督 PR、检查长时间运行的构建,或在会话中稍后提醒自己做某事。要对事件进行实时反应而不是轮询,请参阅 Channels:您的 CI 可以直接将失败推送到会话中。要保持会话工作转向转向直到满足条件而不是按间隔,请参阅 /goal。 任务是会话范围的:它们存在于当前对话中,当您启动新对话时就会停止。使用 --resume 或 --continue 恢复会带回任何尚未过期的任务:在过去 7 天内创建的重复任务,或计划时间尚未到达的一次性任务。对于独立于任何会话而存在的调度,请使用 Routines 在 Anthropic 管理的基础设施上创建例程、设置 Desktop 计划任务,或使用 GitHub Actions。 比较调度选项Cl...
routines
使用例程自动化工作 让 Claude Code 自动运行。定义在计划上运行、通过 API 调用触发或对来自 Anthropic 管理的云基础设施的 GitHub 事件做出反应的例程。 Routines 处于研究预览阶段。行为、限制和 API 表面可能会改变。 例程是一个保存的 Claude Code 配置:一个提示、一个或多个存储库和一组 connectors,打包一次并自动运行。例程在 Anthropic 管理的云基础设施上执行,因此当您的笔记本电脑关闭时它们仍然可以工作。 每个例程可以附加一个或多个触发器: Scheduled:按照每小时、每晚或每周等定期节奏运行,或在特定的未来时间运行一次 API:通过向每个例程端点发送带有持有者令牌的 HTTP POST 来按需触发 GitHub:自动响应存储库事件(如拉取请求或发布)运行 单个例程可以组合触发器。例如,PR 审查例程可以每晚运行、从部署脚本触发,也可以对每个新 PR 做出反应。 Routines 在启用了 Claude Code on the web 的 Pro、Max、Team 和 Enterprise...
remote-control
使用 Remote Control 从任何设备继续本地会话 使用 Remote Control 从您的手机、平板电脑或任何浏览器继续本地 Claude Code 会话。适用于 claude.ai/code 和 Claude 移动应用。 Remote Control 处于研究预览阶段,在所有计划中都可用。在 Team 和 Enterprise 上,在管理员在 [Claude Code 管理员设置](https://claude.ai/admin-settings/claude-code)中启用 Remote Control 切换之前,它默认处于关闭状态。 Remote Control 将 claude.ai/code 或 Claude 应用(iOS 和 Android)连接到在您的机器上运行的 Claude Code 会话。在您的办公桌上启动一个任务,然后从沙发上的手机或另一台计算机上的浏览器继续。 当您在机器上启动 Remote Control 会话时,Claude 始终在本地运行,因此没有任何内容移动到云端。使用 Remote Control,您...
quickstart
快速开始 欢迎使用 Claude Code! 本快速开始指南将在几分钟内让您使用 AI 驱动的编码辅助。完成本指南后,您将了解如何使用 Claude Code 完成常见的开发任务。 开始前确保您拥有: 打开的终端或命令提示符 如果您之前从未使用过终端,请查看终端指南 一个可以使用的代码项目 一个 Claude 订阅(Pro、Max、Team 或 Enterprise)、Claude Console 账户,或通过支持的云提供商的访问权限 本指南涵盖终端 CLI。Claude Code 也可在[网页](https://claude.ai/code)、[桌面应用](/zh-CN/desktop)、[VS Code](/zh-CN/vs-code) 和 [JetBrains IDE](/zh-CN/jetbrains)、[Slack](/zh-CN/slack) 中使用,以及通过 [GitHub Actions](/zh-CN/github-actions) 和 [GitLab](/zh-CN/gitlab-ci-cd) 进行 CI/CD。查看[所有界面](/zh-CN/...
prompt-caching
Claude Code 如何使用 prompt caching Claude Code 自动管理 prompt caching。了解为什么模型切换会触发缓慢的未缓存回合、/compact 的成本、为什么 CLAUDE.md 编辑在会话中期不适用,以及如何检查缓存命中率。 Prompt caching 使 Claude Code 更快、更经济高效。没有缓存,API 会在每个回合重新处理您的完整历史记录。有了缓存,它会重用已经处理过的内容,只对更改的部分进行新工作。 Claude Code 为您处理 prompt caching,除非您禁用它。了解 prompt caching 的工作原理仍然很有用,因为某些操作会使缓存失效,使下一个响应更慢、更昂贵,同时它重建缓存。本页涵盖哪些操作会这样做、为什么某些设置等待重启才能应用,以及当使用量看起来很高时如何检查缓存性能。 缓存的组织方式每次您在 Claude Code 中发送消息时,它都会发出新的 API 请求。模型在请求之间不记得任何东西,所以 Claude Code 重新发送完整的上下文:系统提示、您的项目上下文、每条先前的消息和工...
platforms
平台和集成 选择在哪里运行 Claude Code 以及连接什么工具。比较 CLI、Desktop、VS Code、JetBrains、Web 以及 Chrome、Slack 和 CI/CD 等集成。 Claude Code 在任何地方运行相同的底层引擎,但每个界面都针对不同的工作方式进行了优化。本页面帮助您为工作流选择合适的平台,并连接您已经使用的工具。 在哪里运行 Claude Code根据您喜欢的工作方式和项目所在位置选择平台。 平台 最适合 您获得的功能 CLI 终端工作流、脚本编写、远程服务器 完整功能集、Agent SDK、计算机使用在 macOS 上(Pro 和 Max)、第三方提供商 Desktop 视觉审查、并行会话、托管设置 Diff 查看器、应用预览、Pro 和 Max 上的计算机使用和 Dispatch VS Code 在 VS Code 内工作而无需切换到终端 内联 diff、集成终端、文件上下文 JetBrains 在 IntelliJ、PyCharm、WebStorm 或其他 JetBrains IDE 内工作 D...
permission-modes
选择权限模式 控制 Claude 在编辑文件或运行命令前是否询问。在 CLI 中使用 Shift+Tab 循环切换模式,或在 VS Code、Desktop 和 claude.ai 中使用模式选择器。 当 Claude 想要编辑文件、运行 shell 命令或发出网络请求时,它会暂停并要求您批准该操作。权限模式控制暂停发生的频率。您选择的模式塑造了会话的流程:默认模式让您在操作进行时审查每个操作,而更宽松的模式让 Claude 在更长的不间断时间内工作,然后报告完成情况。为敏感工作选择更多监督,或在您信任方向时选择更少中断。 可用模式每种模式在便利性和监督之间做出不同的权衡。下表显示了在每种模式中 Claude 无需权限提示即可执行的操作。 模式 无需询问即可运行的操作 最适合 default 仅读取 入门、敏感工作 acceptEdits 读取、文件编辑和常见文件系统命令(mkdir、touch、mv、cp 等) 迭代您正在审查的代码 plan 仅读取 在更改代码库前进行探索 auto 所有操作,带后台安全检查 长时间任务、减少提示疲劳 dontAs...
overview
概述 Claude Code 是一个代理编码工具,可以读取你的代码库、编辑文件、运行命令,并与你的开发工具集成。可在终端、IDE、桌面应用和浏览器中使用。 Claude Code 是一个由 AI 驱动的编码助手,可帮助你构建功能、修复错误和自动化开发任务。它理解你的整个代码库,可以跨多个文件和工具工作以完成任务。 开始使用选择你的环境来开始使用。大多数界面需要 Claude 订阅 或 Anthropic 控制台 账户。终端 CLI 和 VS Code 也支持第三方提供商。 功能完整的 CLI,用于直接在终端中使用 Claude Code。编辑文件、运行命令,并从命令行管理整个项目。 To install Claude Code, use one of the following methods: <Tabs> <Tab title="Native Install (Recommended)"> **macOS, Linux, WSL:** theme1curl -fsSL https://cl...
memory
Claude 如何记住你的项目 使用 CLAUDE.md 文件为 Claude 提供持久指令,并让 Claude 通过自动记忆功能自动积累学习内容。 每个 Claude Code 会话都从一个全新的上下文窗口开始。两种机制可以跨会话传递知识: CLAUDE.md 文件:你编写的指令,为 Claude 提供持久上下文 自动记忆:Claude 根据你的更正和偏好自己编写的笔记 本页面涵盖以下内容: 编写和组织 CLAUDE.md 文件 使用 .claude/rules/ 将规则范围限定到特定文件类型 配置自动记忆,使 Claude 自动记笔记 故障排除,当指令未被遵循时 CLAUDE.md 与自动记忆Claude Code 有两个互补的记忆系统。两者都在每次对话开始时加载。Claude 将它们视为上下文,而不是强制配置。要阻止某个操作,无论 Claude 决定什么,请改用 PreToolUse hook。你的指令越具体和简洁,Claude 遵循它们的一致性就越高。 CLAUDE.md 文件 自动记忆 谁编写 你 Claude 包含内容 指令和规则 学习和模...