高级参数、工具与环境配置

高级设置覆盖网络访问、凭据与登录、自动审核、遥测审计等进阶能力。其中不少来自企业安全部署场景，个人环境未必需要、也不应盲目照搬。本节按类别解释作用与安全含义，并标注官方示例键名仅供理解、具体以当前版本官方文档为准；命令级放行规则（如只读检查命令白名单）将在第 12 章权限治理展开。

一、四类高级配置概览（官方安全指南示例，非穷举）

类别	官方示例键（示例）	作用	适用场景
自动审核	approvals_reviewer = "auto_review"	由自动审核子智能体批准低风险操作，高风险在足够授权下才自动放行，减少频繁打断	团队受控环境；个人谨慎开启
网络与检索	allowed_web_search_modes、[experimental_network] 下的 enabled/allowed_domains/denied_domains	限定检索缓存模式、网络代理开关、允许与禁止域名、本地绑定	需要联网或收紧外发时
凭据与登录	cli_auth_credentials_store、mcp_oauth_credentials_store、forced_login_method、forced_chatgpt_workspace_id	凭据存入系统钥匙串、强制登录方式与绑定工作空间	个人安全存放 + 企业强制绑定
遥测审计	[otel]、[otel.exporter.otlp-http]	导出提示词、审批决策、工具结果、MCP 使用与网络放行/拒绝等事件	企业合规审计；个人通常无需自建导出

网络策略示例（官方片段，键名随版本以官方文档为准）：

# requirements.toml（官方示例）
allowed_web_search_modes = ["cached"]

[experimental_network]
enabled = true
allow_local_binding = true
denied_domains = ["pastebin.com"]
allowed_domains = ["login.microsoftonline.com", "*.openai.com"]

二、凭据与登录安全

• 凭据入钥匙串：CLI 与 MCP OAuth 凭据优先存于操作系统安全钥匙串（示例 cli_auth_credentials_store = "keyring"、mcp_oauth_credentials_store = "keyring"），不写入脚本、配置明文或仓库。
• 登录方式与工作空间绑定：企业可强制通过 ChatGPT 登录（示例 forced_login_method = "chatgpt"）并绑定指定工作空间（示例 forced_chatgpt_workspace_id = "<workspace-uuid>"），使活动受工作空间管控与合规日志覆盖。
• 最小暴露：运行输出、日志与提交内容中不回显真实 token；共享配置只保留结构，不携带个人密钥。

三、网络最小化原则

1. 默认收紧：不开放全量外网；先按任务需要配置允许域名与检索模式。
2. 白名单为主、黑名单补充：显式允许可信来源，同时禁止已知高风险域名；未知域名走审批而非默认放行。
3. 本地绑定按需：是否允许访问本地服务（示例 allow_local_binding）按需要开启，不长期放开。
4. 缓存优先：只读检索类任务可限制为缓存模式（示例 allowed_web_search_modes = ["cached"]），减少实时外发。
5. 定期复核：过期、不再使用的域名及时从白名单移除。

四、遥测、审计与隐私边界

• 遥测事件可覆盖用户提示、审批决策、工具执行结果、MCP 服务器使用情况，以及网络代理的放行/拒绝记录，用于解释"为什么执行了某动作"，而不仅是"发生了什么"。
• 企业可经合规平台获取活动日志，并与安全分流流程结合；示例通过 OpenTelemetry 导出（[otel] 与 [otel.exporter.otlp-http]，含 endpoint、protocol 等项）。
• 个人一般无需自建导出端点；若所在环境开启遥测，应知悉哪些内容会被记录，敏感信息不进入提示与仓库。
• 审计的价值在于事后可追溯，不能替代运行时的沙箱与审批边界。

五、FAQ

问题	处理建议
个人要不要配网络白名单和 otel 导出	otel 导出主要面向企业；网络收紧可按需使用，个人先从默认安全姿态起步，不照搬企业完整片段。
键名前的 experimental 是什么含义	表示实验性能力，可能随版本调整；启用前评估稳定性，并以官方文档当前说明为准。
示例键名在本机找不到对应项	版本差异所致；以当前官方文档与本机帮助为准，不要强行写入不存在的键。
高级配置改坏了如何恢复	回退到改动前备份；优先只保留安全基线，逐项重新开启高级项并验证。

六、动手练习

• 练习：对照四类高级配置，为自己标注"需要/可选/不需要"清单；对凭据存储写出安全做法（入钥匙串、不入仓库、不回显）；网络项先只写最小白名单思路，待官方语法确认后再落地。