Secret Handoff

Claude Code 和 Codex 的 Secret Handoff

通过密封的秘密信息，为你的 Agent 提供访问权限。

让你的 Agent 使用临时密码、令牌和一次性验证码，而无需在聊天中透露其值。本地工具会打开一个私密浏览器页面，说明 Agent 为何需要访问权限，并将秘密信息应用于你批准的请求。无需配置保管库。无需注册 Secret Handoff 账户。

此存储库发布了适用于 Claude Code 和 Codex 的插件，对应已签名的 Secret Handoff 0.0.2 版本。 其中包含技能、本地 stdio MCP 配置、Claude 检测钩子，以及仅显示状态的 Claude 卡片。秘密信息只在浏览器中输入。 这些是存储库插件，并非声称它们已获供应商审核并收录到目录中。

安装

先下载并安装本地工具。 选择二进制文件 0.0.2。网站安装程序会验证其归档文件的校验和并安装该二进制文件。当 Claude Code 和 Codex 的 CLI 位于 PATH 中时，运行下方的 secrethandoff setup 进行连接。

secrethandoff version
secrethandoff setup
secrethandoff doctor

预期版本：0.0.2。在 Agent 工作的项目中，运行 secrethandoff init 添加凭据使用指南。然后启动新的 Agent 会话。

Claude Code

如果你希望在安装二进制文件后自行安装插件：

claude plugin marketplace add geland/secrethandoff-integrations
claude plugin install secrethandoff@secrethandoff

Codex

codex plugin marketplace add geland/secrethandoff-integrations
codex plugin add secrethandoff@secrethandoff

安装后重启客户端或启动全新会话。客户端继承的 PATH 中必须包含该二进制文件，包括启动桌面应用时的 PATH。 secrethandoff doctor 会检查本地设置。

对于固定版本的市场，Codex 支持 codex plugin marketplace add geland/secrethandoff-integrations --ref v0.0.2。 Claude Code 支持通过 claude plugin marketplace add 添加 Git 源 https://github.com/geland/secrethandoff-integrations.git#v0.0.2。也可下载发布 ZIP 以供审查。

使用

向你的 Agent 提出请求：“使用 Secret Handoff 提供此任务所需的临时凭据。” 只在 Secret Handoff 浏览器页面中输入凭据值。批准范围受限的 API 主机、方法和路径。Agent 使用引用并接收已脱敏的结果。任务完成后，让 Agent 忘记该秘密信息。

秘密信息会保留在工具进程的内存中，直到被忘记或进程退出。已填入的秘密信息没有自动过期计时器。获批的 API 会收到该值。默认情况下，run_with_secret 需要你在浏览器中批准命令；获批的命令会收到该值，并可能泄露它。用户可以选择启用经过验证的 Claude Code 原生权限提示或 Codex 审批设置；Codex 设置可能会自动授权。这些模式不会改变秘密信息的输入方式。

Claude 检测钩子可以在某些意外粘贴的内容到达模型之前将其拦截。但它们无法删除已保存在客户端本地记录中的值。切勿在聊天中粘贴秘密信息。请阅读安全边界。

选择启用 Codex 命令审批

使用受支持的二进制文件和 0.155 系列中稳定版 Codex 0.155.1，或确切的桌面版构建 0.162.0-alpha.17.2 时，所有者可以选择原生主机策略授权。它遵循所有者的设置，包括允许规则、钩子和自动审核；在此模式下，无需人工点击。 浏览器审批仍是默认分发方式。输入密钥始终通过隔离的 Secret Handoff 页面进行。

在此仓库的检出目录中，重新加载插件，运行所有者选择启用辅助脚本，然后开始新的聊天。该辅助脚本不包含在审查 ZIP 中：

codex plugin add secrethandoff@secrethandoff
python3 scripts/configure_codex_approval.py codex \
  --plugin-dir ~/.codex/plugins/cache/secrethandoff/secrethandoff/0.0.2

该辅助脚本仅验证和编辑已安装的 mcp.json 和 .mcp.json 启动环境。它不会更改主机策略、审核方或钩子。重新安装会重置选择启用设置；重新加载后请再次运行该脚本。使用 browser 而不是 codex 可恢复浏览器命令审批。只有在所有者明确指示时，Agent 才能应用此设置。

python3 scripts/check_codex_approval.py 使用无害服务测试实时允许/拒绝传递。python3 scripts/check_codex_approval.py --installed-plugin 检查真实的缓存插件是否以原生模式启动，并能列出新的空存储。两者都仅隔离子进程，不使用密钥。向任一检查传入 --codex-bin /absolute/path/to/codex，即可验证桌面版捆绑的可执行文件，而不是终端 CLI。运行 python3 -m unittest discover -s tests -p test_codex_approval_config.py，执行辅助脚本保留设置和拒绝场景测试。桌面版提示词渲染需要由所有者另行运行虚拟测试。命令结果会报告 client_policy / host_policy，绝不会声称有人点击了按钮。

分组凭据

request_secrets 会在一个本地浏览器页面上请求 2–8 个凭据。组名用于标识请求；每个字段都有单独的名称和可选标签。一项策略适用于所有字段，所有值会一起就绪。使用组名等待。忘记该组或其中任一成员，都会擦除所有成员。目前不支持通过手机/无头中继填写分组凭据。现有的 request_secret 调用仍只收集一个值。此功能不会更改命令审批设置。

发布范围

• 使用 secrethandoff mcp 为 Claude Code 和 Codex 提供本地交接。
• 公共服务未启用手机和远程中继交接。
• 一次性查看链接仍可通过分享密钥单独使用。
• 其他客户端配置和列表草稿会保留以供后续测试；它们不是已发布到市场的列表，也不代表已验证的主机支持声明。
• release-lock.json 固定了全部六个平台注册包和六个 MCPB 捆绑包的哈希值。插件会启动 PATH 上的二进制文件；元数据不会替代或强制使用该二进制文件。使用前请检查 secrethandoff version。源代码和发布来源信息可在二进制文件仓库中查看。

开发和验证

使用 Python 3.11+ 和 Node 24。在虚拟环境中安装 requirements-review.txt，然后运行：

python scripts/test_release.py
python scripts/validate.py --release
python scripts/package.py --release
python scripts/test_package.py

tests/card.test.tsx 使用 Claude 模组测试运行器运行。tests/card-state.test.mjs 使用 Node 运行，TypeScript 通过 SECRETHANDOFF_TEST_TYPESCRIPT 提供。请参阅 0.0.2 发布状态、Agent 评估和贡献者指南。