访问令牌

Codex access tokens are ChatGPT access tokens scoped to Codex permissions that let trusted automation run Codex local with a ChatGPT workspace identity. Use them when a script, scheduled job, or CI runner needs repeatable, non-interactive Codex access.

Codex access tokens are currently supported for ChatGPT Business and Enterprise workspaces.

访问令牌是在 ChatGPT 管理控制台的访问令牌中创建的。它们与创建它们的 ChatGPT 用户和工作区相关联，Codex 将它们用作编程本地工作流程的代理身份。

使用工作区代理访问令牌进行身份验证

如果平台 API 密钥适用于您的自动化，请继续使用 API 密钥身份验证。当工作流特别需要 ChatGPT 工作区访问权限、ChatGPT-managed Codex 权利或企业工作区控件时，请使用 Codex 访问令牌。

需要从您自己的系统触发已发布的 ChatGPT 工作区代理？请改用工作区代理 API 的工作区代理访问令牌。 Codex 访问令牌对 Codex 本地工作流程进行身份验证；它们不验证工作区代理触发调用。请参阅使用工作区代理访问令牌进行身份验证。

访问令牌如何工作

当 Codex 需要在用户未完成浏览器 sign-in 的情况下运行时，请使用访问令牌。该令牌代表创建它的 ChatGPT 工作区用户，因此运行可以使用该用户的 Codex 访问权限并显示在工作区治理数据中。

Codex checks the token when a run starts and ties the run to that workspace identity. Treat the token like any other automation secret: store it in a secret manager, keep it out of logs, and rotate it regularly.

将访问令牌用于：

codex exec jobs that run from trusted automation.

需要可重复运行的本地脚本，non-interactive Codex。

使用情况应与 ChatGPT 工作区用户而不是 API 组织密钥关联的企业工作流程。

应避免的主要风险：

泄露秘密：任何拥有该令牌的人都可以作为令牌创建者启动 Codex 运行。将令牌存储在秘密管理器中，使它们远离日志，并定期轮换它们。

不受信任的运行者：公共 CI、分叉拉取请求或共享计算机可能会将令牌暴露给工作区之外的人员。仅在受信任的运行者上使用访问令牌。

共享身份：一个人的令牌在不相关的团队中重复使用，使得所有权和审计跟踪更难以解释。为特定工作流程所有者创建令牌。

过时的凭证：long-lived 令牌在工作流程更改后可以保持活动状态。优先选择有限的过期时间并撤销不再使用的令牌。

错误的凭证类型：Codex 访问令牌用于 Codex 本地工作流程。使用工作区代理访问令牌触发已发布的 ChatGPT 工作区代理，并使用平台 API 密钥进行常规 OpenAI API 调用。

启用访问令牌创建

使用工作区设置中的访问令牌权限为允许的成员启用访问令牌创建。

工作区设置 > 权限和角色

转至工作区设置 > 权限和角色。

在“访问令牌”部分中，如果所有允许的成员都应该能够创建访问令牌，请启用“允许用户创建访问令牌”。

如果成员需要将这些令牌与 Codex app、CLI 或 IDE 扩展一起使用，请确保在 Codex 本地部分中也打开允许成员使用 Codex 本地。

将访问令牌的创建仅限于了解令牌存储位置、哪个自动化将使用它以及如何轮换的人员或服务所有者。

设置访问令牌过期限制

工作区所有者和管理员可以设置成员在创建 Codex 访问令牌时可以选择的最长过期时间。转至工作区设置 > 权限和角色，然后在 Codex 本地部分中设置访问令牌过期限制。

该限制适用于新的访问令牌。现有令牌保持其当前有效期。

创建访问令牌

使用“访问令牌”页面命名令牌并选择其过期时间。

转到访问令牌。

选择创建。

输入描述性名称，例如 release-ci 或 nightly-docs-check。

选择一个到期时间。优先选择有限的到期日，例如 7、30、60 或 90 天。如果您选择无过期，请定期轮换令牌。

选择创建。

立即复制生成的访问令牌。关闭模态框后您将无法再次查看它。

将令牌存储在您的秘密管理器或 CI 秘密存储中。

最短的自定义有效期为一天。已撤销和过期的令牌不能用于启动新的 Codex 运行。

将访问令牌与 Codex CLI 结合使用

对于临时自动化，请将令牌存储在 CODEX_ACCESS_TOKEN 中并正常运行 Codex：

export CODEX_ACCESS_TOKEN="<access-token>" codex exec --json "review this repository and summarize the top risks"

对于持久本地登录，将令牌通过管道传输到 Codex 登录 --with-access-token：

printf '%s' "$CODEX_ACCESS_TOKEN" | codex login --with-access-token codex exec "summarize the last release diff"

codex login --with-access-token stores an agent identity credential in Codex auth storage. If you prefer not to persist credentials on the machine, use the CODEX_ACCESS_TOKEN environment variable instead.