Coding Agent 的 API Key 安全，首先要分清一件事：聊天窗口里看不到密钥，不等于运行工具的进程读不到密钥。如果进程能读取凭证文件或环境变量，具备相应工具权限的 Agent 也可能读到。
本文基于 2026 年 9 月 29 日核验的文档整理，不是安全认证，也不承诺任何云端 Workspace 都能让密钥无法被读取。
把身份、权限和花费分开
Key 用于认证调用方，附带的权限决定能做什么，账号资金规则影响花费。新建一个 Key，不代表自动得到独立的权限边界或硬预算。
每项集成都应记录负责人、环境、用途、允许的操作和撤销流程。需要独立撤销时，使用不同凭证，例如区分开发与生产。不要因为多人使用同一工具，就共享个人密钥。
更广泛的隔离和成员权限问题，可看 Coding Agent Workspace 安全指南。本文只聚焦凭证从创建到停用的生命周期。
提供凭证，不要把它变成项目内容
OpenAI 的密钥安全说明提醒，不要在客户端应用或仓库中暴露 Key。环境变量可以减少误写进代码的风险，但它不是安全沙箱。
优先使用认可的密钥管理器，并缩小执行环境的权限。条件允许时，让可信服务为已授权的请求附加凭证，而不是把原始密钥交给不受限制的工具进程。这种服务仍需认证、授权、日志和审查，不能因为叫“代理”就默认安全。
不要把密钥放进提示词、截图、调试转储、示例配置或支持工单。Git 忽略规则只能防止部分后续跟踪，无法清除已经提交或记录过的秘密。
先演练一次正常轮换
常规轮换前，先找齐所有依赖任务，并确认服务商是否允许新旧凭证同时有效。
- 按服务商支持的流程创建替代凭证。
- 先更新一个低风险使用方，用最小请求验证。
- 更新其他使用方，并确认重新加载了配置。
- 切换验证完成后，撤销旧凭证。
- 检查退役任务不能继续使用旧密钥成功调用。
如果服务商会立即让旧值失效，就安排统一切换，不要假设存在重叠期。密钥已经暴露时，更不能只为避免停机而让它继续有效。
怀疑泄露时，采取不同的处理顺序
及时撤销或禁用暴露的凭证，暂停受影响自动化，并通知账号负责人。检查可能泄露时间段内的用量及下游权限。
从当前文件移除密钥；如果进入过 Git 提交，按仓库认可的历史清理流程处理。删掉一行，并不能收回副本、日志和缓存。保留脱敏的事件证据，不要把真实密钥复制到另一个文档里。
恢复前先修复泄露路径：如果新 Key 仍被放进同一个公开前端包，它还会再次泄露。
验证访问，但不暴露密钥
Agent.Space Developer API 指南介绍了专用 Key 和请求记录检查。诊断时用请求标识和 Key 标签，不用完整秘密值。权限与资金控制要查当前产品实际提供的能力，不能默认存在统一硬上限。
需要受支持的 API 配置时，可以打开 Agent.Space。把凭证处理与提示词分开，并在交给 Agent 真实项目前，检查工具进程能访问什么。