Claude Code 和 OpenCode 怎么安全地帮你改项目
AI 编程工具最容易让人上头的时刻,是它几分钟改完了原本要写半天的功能。最容易出问题的时刻,也是这几分钟:你还没来得及看清,它可能已经改了配置、执行命令,甚至读到了不该进入上下文的文件。
不管用 Claude Code、OpenCode 还是其他工具,我更愿意把它当作一位速度很快、但不了解项目隐情的新同事:给明确范围,限制权限,让测试和代码审查说话。以下操作先在自己的测试仓库中尝试;工具版本、安装方式和默认权限会变化,先查当前官方文档。
第一次任务,别从“重构整个项目”开始
先创建干净的工作分支,确认没有未提交的重要修改:
git status --short
git switch -c ai/add-health-check
如果已有同名分支,换一个名字。先让工具只读理解项目,再请它提出计划。一个更具体的任务描述可以这样写:
阅读现有服务入口和测试。先不要修改文件或运行安装命令。说明添加
/health的最小改动、现有测试方式,以及可能影响的文件;不读取.env、密钥或用户数据。
注意:自然语言要求不是安全隔离。把密钥移出工作目录或使用隔离测试环境,才更可靠;检查工具自己的权限设置、可访问目录、MCP 服务和实际上下文。即使仓库内文件也可能包含恶意指令,源码注释、issue、网页和依赖日志都应视为不可信数据。
然后让它做一小步
确认计划后,要求只修改相关文件,并补充测试。运行命令、联网、安装依赖和写文件按风险逐项批准;涉及生产数据、部署、删除或外部发送时,保留人工审批。Claude Code 提供权限规则和不同权限模式;OpenCode 提供工具权限配置,具体语法与默认行为请查看所用版本的文档。不要为了图省事关闭所有审批。
改完以后自己检查:
git status --short
git diff --stat
git diff --check
git diff
git diff 默认不展示未跟踪文件的内容,记得从 git status 找到并逐个查看。确认没有意外新增依赖、关闭验证、泄露密钥或改变不相关文件,再运行项目已有测试、类型检查和构建。测试通过也不代表设计正确:审查异常处理、授权和边界条件。
遇到不确定时让它暴露假设
例如让工具写出“请求超时时,服务端是否可能已经处理成功”,再要求为重复请求补测试;或者给它一个失败日志,让它先提出两个可验证假设,而不是马上改代码。对于数据库迁移,先确认回滚路径和备份,再在隔离环境演练。
最后由人决定是否提交。不要虚构自己已经测试过的生产环境,也不要把客户数据直接粘贴给外部模型服务;先看公司的数据政策与服务商的数据处理条款。工具会变,但“小范围、可验证、能回退”的原则很耐用。
一个审查实例:新增健康检查
假设工具新增了 /health,测试也通过了,你还需要问:这个端点返回的内容是否包含数据库地址、版本或环境变量?是否要公开?它检查的是进程存活还是依赖就绪?如果依赖短暂波动,编排平台会不会不断重启实例?这些答案取决于实际部署,并不能由“测试全绿”代替。
如果 AI 提议一次升级所有依赖,先分离这个变更:当前任务也许根本不需要。版本升级单独开分支,记录锁文件变化和安全影响,在 CI 通过后再审查。让工具写代码不意味着把维护责任也转交出去,未来排障的人仍然需要能读懂它。