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.js | 18.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 仍然无法使用?
- 确认 Claude Code 版本是否为
v2.1.96 - 执行
node claude-auto-mode-patcher.mjs --check验证补丁是否生效 - macOS 用户注意:脚本会自动重新签名二进制,如遇权限问题请以管理员权限执行
升级 Claude Code 后失效怎么办?
每次升级 Claude Code 后,补丁会失效,需重新执行第二步和第三步。建议在升级前先用 --restore 还原,再升级,再重新打补丁。
Auto Mode 会影响安全性吗?
不会降低 Claude Code 的内容安全能力。Auto Mode 仅绕过权限弹窗流程,Claude Code 底层的安全分类器(Safety Classifier)对每次工具调用的独立评估不受影响。
提示
如遇到其他问题,请参考 常见问题 FAQ 或联系 TokenPan 客服。