Claude Code Auto Mode 解锁教程

前置说明

重要提示

  • 本教程适用于通过 TokenPan 中转服务使用 Claude Code 的用户
  • 补丁基于 Claude Code v2.1.96 版本,其他版本可能不兼容,升级后需重新执行
  • 操作前请确保已完成 Claude Code 配置教程 中的基础配置

背景说明

Claude Code 的 Auto Mode(自动模式) 是其最强大的功能之一——开启后,Claude Code 无需每次操作前向你确认权限,能够自主完成文件读写、命令执行等任务,极大提升开发效率。

然而,Anthropic 官方对 Auto Mode 做了限制:只有通过官方 API 才能使用。通过 TokenPan 等第三方中转服务接入时,该功能默认被锁定,即使手动切换也无法生效。

本教程将指导你通过补丁工具解除此限制,让 Auto Mode 在 TokenPan 中转服务下正常工作。

环境要求

条件要求
Claude Code 版本v2.1.96(执行 claude --version 查看)
Node.js18.0 或更高版本
操作系统macOS 或 Linux

操作步骤

第一步:确认 Claude Code 版本

在终端执行:

bash
claude --version

确认输出为 2.1.96,否则请先将版本固定到该版本,或等待补丁支持更新。

第二步:下载补丁脚本

bash
curl -O https://raw.githubusercontent.com/zzturn/claude-auto-mode-unlock/main/claude-auto-mode-patcher.mjs

第三步:执行补丁

bash
node claude-auto-mode-patcher.mjs

执行成功后,脚本会自动备份原始二进制文件,并完成以下 6 项修改:

  • 绕过 API 服务商限制检查
  • 绕过模型名称白名单校验
  • 强制启用功能门控(Feature Gate)
  • 关闭熔断器(Circuit Breaker)
  • 修改权限验证路径
  • 启用 Auto Mode 入口

第四步:启用 Auto Mode

补丁完成后,通过以下任意方式启用 Auto Mode:

方式一:启动时直接指定

bash
claude --permission-mode auto

方式二:启动后切换

启动 Claude Code 后,按 Shift + Tab 即可在不同权限模式之间切换。

其他操作

检查补丁状态

bash
node claude-auto-mode-patcher.mjs --check

还原原始版本

bash
node claude-auto-mode-patcher.mjs --restore

指定 Claude Code 二进制路径

如果 Claude Code 安装在非标准路径,可通过环境变量指定:

bash
CLAUDE_BIN=/path/to/claude node claude-auto-mode-patcher.mjs

常见问题

打补丁后 Auto Mode 仍然无法使用?

  1. 确认 Claude Code 版本是否为 v2.1.96
  2. 执行 node claude-auto-mode-patcher.mjs --check 验证补丁是否生效
  3. macOS 用户注意:脚本会自动重新签名二进制,如遇权限问题请以管理员权限执行

升级 Claude Code 后失效怎么办?

每次升级 Claude Code 后,补丁会失效,需重新执行第二步和第三步。建议在升级前先用 --restore 还原,再升级,再重新打补丁。

Auto Mode 会影响安全性吗?

不会降低 Claude Code 的内容安全能力。Auto Mode 仅绕过权限弹窗流程,Claude Code 底层的安全分类器(Safety Classifier)对每次工具调用的独立评估不受影响。

提示

如遇到其他问题,请参考 常见问题 FAQ 或联系 TokenPan 客服。