a2a mcp
中文
Back to Blog
BlogMarch 25, 20262,217

如何使用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

Referenced Tools

Browse entries that are adjacent to the topics covered in this article.

Explore directory
Hyper3D MCP logo

Hyper3D MCP

MCP Servers

Hyper3D MCP is Hyper3D's hosted Rodin MCP server for creating 3D assets from natural-language instructions or supported references, checking asynchronous generation progress, and retrieving model download links inside AI coding clients. Official setup is documented for Codex, Claude Code, and Kimi Code CLI.

Semrush MCP Server logo

Semrush MCP Server

MCP Servers

Semrush MCP connects AI assistants to Semrush APIs for keyword, backlink, website traffic and market research.

Browserbase MCP Server logo

Browserbase MCP Server

MCP Servers

Browserbase MCP gives AI agents browser automation tools powered by Stagehand and Browserbase browser sessions.

SerpApi MCP Server logo

SerpApi MCP Server

MCP Servers

SerpApi MCP exposes search engine results to AI assistants through SerpApi, supporting live research and structured search data retrieval.

Similarweb MCP Server logo

Similarweb MCP Server

MCP Servers

Similarweb MCP brings website traffic and digital market intelligence into AI assistants for competitive research.

AgentQL MCP Server logo

AgentQL MCP Server

MCP Servers

AgentQL MCP connects AI agents to AgentQL web extraction, returning structured information from web pages for research and automation.

a2a mcp

搜索全站

搜索条目、技能、文章和分类。使用方向键选择,回车打开。