xhj的博客

高级设置 Claude Code 的系统要求、特定平台安装、版本管理和卸载。 本页面涵盖系统要求、特定平台安装详情、更新和卸载。有关首次会话的引导式演练，请参阅快速入门。如果您从未使用过终端，请参阅终端指南。 系统要求Claude Code 在以下平台和配置上运行： 操作系统： macOS 13.0+ Windows 10 1809+ 或 Windows Server 2019+ Ubuntu 20.04+ Debian 10+ Alpine Linux 3.19+ 硬件：4 GB+ RAM、x64 或 ARM64 处理器 网络：需要互联网连接。请参阅网络配置。 Shell：Bash、Zsh、PowerShell 或 CMD。 位置：Anthropic 支持的国家/地区 其他依赖项 ripgrep：通常包含在 Claude Code 中。如果搜索失败，请参阅搜索故障排除。 安装 Claude Code 更喜欢图形界面？[桌面应用](/zh-CN/desktop-quickstart)让您无需使用终端即可使用 Claude Code。下载适用于 [macO...

Claude Code 设置 使用全局和项目级设置以及环境变量配置 Claude Code。 Claude Code 提供多种设置来配置其行为以满足您的需求。您可以在使用交互式 REPL 时运行 /config 命令来配置 Claude Code，这会打开一个选项卡式设置界面，您可以在其中查看状态信息并修改配置选项。 配置作用域Claude Code 使用作用域系统来确定配置应用的位置以及与谁共享。了解作用域可以帮助您决定如何为个人使用、团队协作或企业部署配置 Claude Code。 可用作用域 作用域 位置 影响范围 与团队共享？ Managed 服务器管理的设置、plist / 注册表或系统级 managed-settings.json 机器上的所有用户 是（由 IT 部署） User ~/.claude/ 目录 您，跨所有项目 否 Project 存储库中的 .claude/ 此存储库上的所有协作者 是（提交到 git） Local .claude/settings.local.json 您，仅在此存储库中 否（gitignored） ...

管理会话 命名、恢复、分支和在 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-...

按计划运行提示词 使用 /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...

使用例程自动化工作 让 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 从您的手机、平板电脑或任何浏览器继续本地 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，您...

快速开始 欢迎使用 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/...

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 重新发送完整的上下文：系统提示、您的项目上下文、每条先前的消息和工...

平台和集成 选择在哪里运行 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...

选择权限模式 控制 Claude 在编辑文件或运行命令前是否询问。在 CLI 中使用 Shift+Tab 循环切换模式，或在 VS Code、Desktop 和 claude.ai 中使用模式选择器。 当 Claude 想要编辑文件、运行 shell 命令或发出网络请求时，它会暂停并要求您批准该操作。权限模式控制暂停发生的频率。您选择的模式塑造了会话的流程：默认模式让您在操作进行时审查每个操作，而更宽松的模式让 Claude 在更长的不间断时间内工作，然后报告完成情况。为敏感工作选择更多监督，或在您信任方向时选择更少中断。 可用模式每种模式在便利性和监督之间做出不同的权衡。下表显示了在每种模式中 Claude 无需权限提示即可执行的操作。 模式 无需询问即可运行的操作 最适合 default 仅读取 入门、敏感工作 acceptEdits 读取、文件编辑和常见文件系统命令（mkdir、touch、mv、cp 等） 迭代您正在审查的代码 plan 仅读取 在更改代码库前进行探索 auto 所有操作，带后台安全检查 长时间任务、减少提示疲劳 dontAs...