Codex Local HIPAA 配置指南

适用对象

如果你的工作流可能处理受保护健康信息（PHI），请使用本指南妥善配置 Codex Local。Codex Local 包括在用户电脑上运行的 Codex App、IDE 扩展和 CLI。

如果你使用 ChatGPT for Healthcare、ChatGPT for Clinicians 或 Regulated 工作区，并且已签署适用的 OpenAI Business Associate Agreement（BAA），OpenAI 会按照 BAA 处理从 Codex Local 收到的 PHI。OpenAI 会安全处理你通过 Codex 提交的提示词、文件和其他输入，并安全返回输出。

OpenAI 与你的组织共同承担保护 OpenAI 服务的责任。你需要安全配置本地工作站、源代码仓库、本地保留、本地 MCP servers、Browser Use 与 Computer Use 活动、桌面 Apps，以及 Codex 可以访问的 Google Drive 或 GitHub 等第三方服务。本指南说明如何配置这些工具。

共同责任

与大多数云解决方案一样，云服务提供商与客户共同承担合规责任。ChatGPT Enterprise 在 OpenAI 云端存储输入与输出；用户工作站则保留 Codex Local 的输入与输出。Codex 会把提示词、文件等输入发送给 OpenAI 进行推理，OpenAI 再返回输出。对于通过 ChatGPT 认证的使用，OpenAI 最多保留 30 天审计记录，以便你通过 Compliance API 获取。OpenAI 不会使用 ChatGPT Enterprise 数据或 Codex Local 数据训练模型。

本地工作站配置，尤其是其中的 TOML 策略文件，决定 Codex 可以在用户电脑上执行什么。它会影响 Codex 能否读写文件、运行命令、访问网络、调用 Apps 或连接器、调用 MCP 工具、打开浏览器界面以及保留本地对话记录。这些设置不会改变 OpenAI 在 BAA 下的义务，但却是 HIPAA 防护措施的核心。本指南介绍如何通过相关设置，让 Codex Local 符合组织内部关于 PHI 使用与保护的政策。

OpenAI 安全计划

OpenAI 维护一套企业安全计划，旨在保护 OpenAI 服务处理的数据，并支持受监管组织履行合规义务。

OpenAI 实施 **Enterprise Risk Management（企业风险管理）**计划，并建立包含董事会委员会报告机制的正式风险治理结构。产品保障活动帮助确保产品发布继续保留加密、最小权限访问和细粒度日志等防护措施，以支持 HIPAA 合规。产品风险评估、控制监控与合规评审有助于识别数据面临的合理可预见风险、评估防护措施的有效性，并持续改进 ChatGPT Enterprise、API Platform 和 Codex 相关服务使用的控制。

安全开发与 CI/CD 防护措施有助于降低 Codex 相关服务的改动引入未授权访问、数据泄漏或完整性问题的风险。这些措施包括受控源码访问、同行评审、自动化测试、构建与部署工作流中的安全检查、secret 处理控制以及受监控的部署流程。受控软件交付流程为 OpenAI 服务层提供支持；你仍需负责本地仓库卫生、工作站安全，以及本地策略文件允许的行为。

OpenAI 漏洞管理计划包括持续扫描、依赖项与基础设施评审、基于严重程度的分诊、修复跟踪和修复验证。OpenAI 还通过内部与外部红队、独立安全测试和负责任披露渠道，在安全弱点影响数据之前识别并处理它们。

数据保护控制包括传输中和静态数据加密、身份与访问控制、基于角色的管理、日志记录，以及遵循相应 ChatGPT Enterprise 或 API 组织设置的保留控制。

Codex Local 登录

使用 OpenAI 模型时，Codex 支持两种 OpenAI 登录方式：通过 ChatGPT 登录使用订阅访问，或通过 API key 登录使用按量计费访问。在适用的 OpenAI BAA 下，两种方式都支持 HIPAA 合规。

使用 ChatGPT 登录时，Codex 的使用会遵循用户的 ChatGPT 工作区权限、基于角色的访问控制（RBAC）以及 ChatGPT Enterprise 的保留和数据驻留设置。使用 API key 登录时，Codex 的使用会遵循 OpenAI API 组织的保留、数据共享和管理设置，而不是 ChatGPT 工作区设置。API key 登录常用于程序化 Codex CLI 工作流，例如可信 CI/CD 作业；但不应在公开或不可信的执行环境中暴露 API key。

你的责任

你仍需负责运行 Codex Local 的工作站。请针对本地 Codex 使用完成自己的风险分析，包括工作站配置、操作系统安全、磁盘加密、恶意软件防护、设备管理、补丁、用户访问、安全凭据存储和本地保留等控制。

由你决定哪些用户可以使用 Codex Local、允许哪些登录方式、他们能访问哪些工作区、能否使用 API key 登录、哪些仓库与文件夹可以包含 PHI，以及 Codex 能否使用外部服务。

你还需要对已启用的第三方服务及其可访问用户负责。如果组织在包含 PHI 的环境中为 Microsoft SharePoint、Google Drive、GitHub 或其他服务启用浏览器目标、App、连接器或 MCP server，请确认组织已批准该服务处理 PHI，并已签署适当的 BAA 或同等 healthcare addendum。OpenAI 的 BAA 不会使另一家供应商自动成为符合 HIPAA 要求的目标。

以下章节介绍如何使用 requirements.toml 策略配置文件和相关设置管理 HIPAA 合规。请同时评审其他 OpenAI 文档中的设置，并随着 Codex 能力变化重新评审。

启用 Codex

按照管理员设置说明为工作区启用 Codex Local。请联系 OpenAI Account Director，为工作区启用 Codex HIPAA 支持。

BAA 不涵盖 Codex 云端。请勿使用 Codex 云端处理 PHI。

配置基于角色的访问控制

你可以使用 RBAC 自定义 Codex Local 及其配置的访问权限。例如，不接触 PHI 的用户可以获得更宽松的配置，而会接触 PHI 的用户可以使用本指南中的配置。请从 ChatGPT 管理员权限与角色页面控制整个组织对 Codex Local 的访问。要控制特定用户的访问，请创建组并编辑这些组的权限。

评审 Apps 与插件

Codex Local 支持可包含 Apps 和 skills 的插件。Apps 可以与第三方数据源交换数据。启用 App 前，请判断是否需要与该 App 向其发送数据的第三方签署 BAA。Skills 是在策略配置范围内运行的指令；应像评审其他脚本一样，确认 skills 适合预期用途。

工作区管理员必须先启用包含 Apps 的插件，用户才能在连接器设置中安装分配给自己的 Apps。

配置托管要求与默认值

TOML 配置文件中的 requirements 和 managed defaults 用于管理 Codex 行为。本地工作站把用户级配置保存在 ~/.codex/config.toml。CLI 与 IDE 扩展共享相同配置层。要设置用户无法覆盖的管理员强制约束，请在 requirements.toml 中使用 managed requirements。OpenAI 建议通过托管配置强制执行 PHI 数据处理要求。

管理员可以在 Codex Policies 页面使用兼容 requirements.toml 的语法配置 cloud-managed requirements，也可以通过 macOS MDM 等设备管理方式分发 requirements。Codex 按以下顺序应用 requirements 层：cloud-managed requirements、macOS MDM requirements、系统 requirements.toml。更早的 requirements 对其设置的字段拥有更高优先级。

Managed defaults 与 requirements 相互独立。它们设置 Codex 启动时的初始配置，但用户可以在会话期间更改这些设置；Codex 下次启动时会重新应用 defaults。Managed defaults 适合标准化，不适合严格合规强制。例如，可以设置默认模型、权限配置档案或其他偏好的本地行为。如果某项设置在 PHI 工作流中必须不可绕过，请把它放入 requirements。对于 managed defaults，macOS MDM managed preferences 优先级最高，其次是系统 managed_config.toml，最后是用户本地 config.toml。

下表汇总了配置 Codex Local 时可用的部分设置。请结合这些设置和参考资料，以符合自身合规要求的方式配置 Codex Local。

Starter requirements.toml

OpenAI 为 ChatGPT Enterprise 和 Regulated 工作区提供 starter 配置，使用上表中的部分设置。如果采用 cloud-managed requirements 作为配置分发机制，请在 Codex Policies 页面找到该 starter 配置，并针对特定 RBAC 组覆盖它。

该配置在允许正常、受监督的 Codex Local 工作的同时，减少未经授权的数据外流。发布前请先评审并按需调整。下面两个示例展示如何调整配置以支持常见工作流。

权限配置档案的允许列表功能要求 Codex 0.138.0 或更高版本。所有受管客户端都运行受支持版本后，才能部署此示例。

# Starter requirements.toml for Codex Local use with PHI.
# Review and adapt this policy before rollout.

allowed_approval_policies = ["on-request", "untrusted"]
allowed_approvals_reviewers = ["user"]
allowed_web_search_modes = ["cached"]

default_permissions = ":workspace"

[allowed_permission_profiles]
":read-only" = true
":workspace" = true

[features]
computer_use = false
browser_use = false
browser_use_full_cdp_access = false
in_app_browser = false

[mcp_servers]
# None allowed by default.

示例 1：启用 Google Drive App

只有在确认数据流、OAuth 作用域（scopes）、访问控制和第三方 BAA 状态后，才为经过批准的组启用 Google Drive。OpenAI 的 BAA 管理 OpenAI 对 PHI 的处理，不会自动涵盖作为 PHI 接收方或持有方的 Google。

# Example config.toml change for a group approved to use
# the Google Drive app with PHI, after legal and security review.

[features]
apps = true

[apps.google_drive]
enabled = true
destructive_enabled = false
default_tools_enabled = true
default_tools_approval_mode = "prompt"

[apps.google_drive.tools."files/delete"]
enabled = false

默认关闭破坏性操作，在使用 App 工具前要求提示确认，通过 RBAC 组限制访问，并在可用时评审 Google Workspace 审计日志中的 App 活动。

示例 2：在本地使用 GitHub

本地开发时，许多团队会从开发者工作站使用 Git 或 GitHub CLI。这与 Codex 云端不同。如果仓库、issues、pull requests 或评论可能包含 PHI，请在启用这条路径前确认组织允许 GitHub 环境处理这些数据。

# Example requirements.toml addition for local GitHub use.
# This doesn't enable Codex cloud. It keeps repository actions reviewable.

[rules]
prefix_rules = [
  { pattern = [{ token = "git" }, { any_of = ["push", "commit"] }], decision = "prompt", justification = "Require review before changing repository history." },
  { pattern = [{ token = "gh" }], decision = "prompt", justification = "Require review before using GitHub CLI." },
]

该策略不会阻止使用 GitHub，而是在 Codex 更改仓库历史或运行 GitHub CLI 命令前创建评审点。

可选：使用经过评审的 GitHub MCP server

如果团队使用 GitHub MCP server，而不是只使用本地 Git 命令，请只将精确匹配且经过批准的 server 身份加入允许列表，并把工具限制为最小的已批准集合。

# Optional: allow a vetted GitHub MCP server.
# Use the exact approved server identity for your environment.

# requirements.toml
[mcp_servers.github]
identity = { url = "https://github-mcp.example.com/mcp" }

# config.toml
[mcp_servers.github]
url = "https://github-mcp.example.com/mcp"
enabled = true
default_tools_approval_mode = "prompt"
enabled_tools = ["<approved-read-tools>", "<approved-pr-tools>"]

实际发布步骤

1. 选择获批的登录路径。 决定用户是通过 ChatGPT 认证 Codex Local、使用 API key，还是为不同工作流同时使用两者。
2. 确认与 OpenAI 的 BAA。 确认已针对获批登录路径与 OpenAI 签署 BAA。请联系 OpenAI Account Director，为 ChatGPT 工作区启用 Codex HIPAA 支持。
3. 启用 Codex Local 并定义 RBAC 组。 使用 Codex Enterprise 管理员设置启用 Codex Local，创建小规模 Codex Admin 组，并通过 Codex Users、Codex PHI Users 等 RBAC 组分配 Codex 访问权限。
4. 部署管理员强制的 requirements.toml 与托管默认值（managed defaults）。 使用云端托管要求（cloud-managed requirements）、MDM 或系统配置，为 PHI 用户强制执行起始策略。配置权限配置档案、审批策略、Web 搜索模式、功能固定、网络要求、命令规则和 MCP 允许列表。
5. 培训用户理解审批与沙箱边界。 使用智能体审批与安全说明 Codex 何时可以在沙箱内行动、何时请求审批，以及用户为何需要评审网络、文件传输、仓库写入和第三方 App 操作。
6. 在处理 PHI 前评审第三方 Apps。 启用包含 Google Drive、GitHub 等 Apps 的插件、浏览器目标或 MCP servers 前，请确认组织批准接收 PHI 的第三方，并已与其签署适当 BAA。
7. 跟踪、评审并刷新部署。 使用 Compliance API 导出、工作区分析、端点日志、App 审计日志和仓库审计日志，确认已部署状态持续符合内部政策。

参考资料

• Codex 身份认证
• Codex 配置基础
• Codex Enterprise 管理员设置
• Codex 托管配置
• 智能体审批与安全
• Codex Model Context Protocol
• Codex 治理
• Codex 权限
• ChatGPT Healthcare 与 Regulated Workspace 功能
• ChatGPT for Clinicians
• OpenAI API 服务的 Business Associate Agreement
• Codex 白皮书