Back to Blog
BlogMarch 25, 20262

如何使用Claude代码自动模式:完整分步教程

如何使用Claude代码自动模式:完整分步教程

前提条件

在使用 Claude Code Auto Mode 之前,请确保满足以下条件:

  • Claude 订阅:团队版计划(研究预览版必需)或企业版计划(即将推出)。Auto Mode 在 Pro 版、Max 版或免费账户上不可用。
  • Claude 模型:Claude Sonnet 4.6 或 Opus 4.6(Auto Mode 必需)。
  • Claude Code 已安装:最新版本的 CLI、桌面应用或 VS Code 扩展。
  • 项目目录:需要处理的本地代码库。
  • 终端访问权限:用于 CLI 操作(建议用于完全控制)。

注意:Auto Mode 目前处于研究预览阶段。管理员可以通过托管设置在整个组织范围内禁用它。

步骤 1:安装 Claude Code

  1. 打开终端。

  2. 运行适用于您操作系统的安装命令:

    macOS / Linux / WSL

    curl -fsSL https://claude.ai/install.sh | bash
    

    Windows (PowerShell)

    irm https://claude.ai/install.ps1 | iex
    
  3. 验证安装:

    claude --version
    
  4. (可选)适用于 macOS 的 Homebrew:

    brew install --cask claude-code
    

安装后,Claude Code 将在后台自动更新。

步骤 2:登录 Claude Code

  1. 启动交互式会话:
    claude
    
  2. 按照屏幕上的登录提示操作(仅首次使用)。
  3. 使用团队版或企业版账户。

登录后,凭证将安全存储。

步骤 3:启用 Auto Mode

Auto Mode 必须在模式循环中显式解锁才会出现。

CLI 方法(推荐)

使用启用标志启动:

claude --enable-auto-mode

或直接以 Auto Mode 启动:

claude --enable-auto-mode --permission-mode auto

设置文件方法

创建或编辑 ~/.claude/settings.json(用户级别)或 .claude/settings.local.json(项目级别):

{
  "defaultMode": "auto"
}

重要提示:启动时仍需使用 --enable-auto-mode 标志,该模式才会出现在 Shift+Tab 循环中。

桌面版 / VS Code 扩展

  • 打开 Claude Code 设置。
  • Auto Mode 开关打开(仅通过 CLI 标志或管理员设置启用后才会出现)。

步骤 4:配置自动模式分类器(推荐)

自动模式使用后台分类器来批准安全操作。请根据您的环境进行自定义。

  1. 检查内置规则:

    claude auto-mode defaults
    
  2. 复制输出内容,使用受信任的基础设施创建/编辑您的设置文件:

    {
      "autoMode": {
        "environment": [
          "组织:Acme Corp。主要用途:软件开发",
          "源代码管理:github.com/acme-corp 及所有仓库",
          "云存储桶:s3://acme-build-artifacts"
        ],
        "allow": [
          "允许部署到预发布环境:隔离环境"
        ],
        "soft_deny": [
          "切勿在官方 CLI 之外运行数据库迁移"
        ]
      }
    }
    
  3. 验证您的配置:

    claude auto-mode config
    
  4. 获取关于自定义规则的 AI 反馈:

    claude auto-mode critique
    

步骤 5:启动会话并切换至自动模式

  1. 导航到您的项目目录:

    cd /path/to/your-project
    
  2. 启动已启用自动模式的 Claude Code:

    claude --enable-auto-mode
    
  3. 在会话期间切换模式

    • 重复按 Shift + Tab(或 Alt + M)进行循环切换:defaultacceptEditsplanauto
    • 当前模式会显示在状态栏中。
  4. 给 Claude 分配任务。示例:

    重构身份验证模块,添加单元测试,并运行完整的测试套件。
    

自动模式现在将自动批准低风险工具调用(文件读取、针对性编辑、标准构建/测试),而分类器会阻止任何高风险操作。

步骤 6:高效使用的最佳实践

  • 首先以计划模式开始:切换到 plan 模式(按两次 Shift+Tab),查看 Claude 的计划,然后切换到自动模式。
  • 添加项目上下文:在根目录创建 CLAUDE.md 文件,包含编码标准、构建命令和禁止操作。
  • 使用检查点:Claude 在更改前会自动保存状态。通过按两次 Esc/rewind 进行回退。
  • 与钩子结合使用:配置 .claude/settings.json 以在编辑后自动进行代码检查或测试。
  • 监控进度:使用详细模式(Ctrl + R)查看完整的推理过程。

常见问题与故障排除

  • 自动模式未在循环中出现

    • 请确保你已使用 --enable-auto-mode 参数启动程序。
    • 确认你使用的是支持 Sonnet 4.6 或 Opus 4.6 版本的团队/企业账户。
    • 若处于组织环境中,请检查管理员设置。
  • 分类器拦截了合法操作

    • autoMode.allowenvironment 中添加明确的规则。
    • 使用 claude auto-mode critique 获取建议。
    • 提供更清晰的任务说明,或暂时切换至 acceptEdits 模式。
  • 延迟或令牌使用量较高

    • 这是由于后台分类器运行所致,属正常现象。建议仅将其用于较长的会话场景。
  • 受保护路径出现权限错误

    • 在大多数模式下,对 .git.claude 等路径的操作仍会触发提示。如需完全自主操作,请使用隔离环境(如 Docker/虚拟机)。
  • 会话意外退出

    • 运行 claude -c 可继续最近一次的对话。

后续步骤

  • 在切换到自动模式前,可尝试规划模式以处理复杂的重构任务。
  • 为可重复的工作流程设置自定义命令挂钩
  • 使用子代理处理并行任务(例如,前端与后端同时进行)。
  • 通过 GitHub Actions 与 CI/CD 集成,打造全自动化的流水线。
  • 为保障安全,可在临时的 Git 分支或 Docker 容器中进行实验。

开启并正确配置自动模式后,你可以运行长达数小时的自主编码会话,大幅减少中断,同时保持严格的安全防护机制。不妨从今天开始,先从一个简单的任务着手,随着信心的提升,逐步扩展你的可信环境规则。

Share this article