SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场codex-auth

codex-auth

编程与开发

查看项目

更新于 10-15 10:01

技能介绍

Codex Authentication Management 是面向 OpenAI Codex CLI 的认证设置与管理技能，支持 ChatGPT OAuth 与 API Key 两种方式。资料标注最后更新于 2025 年 12 月（GPT-5.2 发布）。以下按用途、主要能力、使用方式、适用场景和限制整理。

一、用途 该技能用于为 Codex CLI 配置和管理认证信息，包括首次登录、登出、查看当前身份、在多账号之间切换，以及在 CI/CD、Docker 等自动化环境中注入凭据。

二、认证方式

  1. ChatGPT Plus/Pro（资料标记为推荐）：优点包括无需管理 API Key、包含 GPT-5.1-Codex-Max 与 GPT-5.2 访问、使用 Codex-Mini 有 4 倍用量、浏览器无缝认证、自动刷新令牌、可访问 GPT-5.2 Pro 以获得最高准确度。 相关命令（资料原文）：
  • 初始登录：codex login（打开浏览器进行 ChatGPT 认证）
  • 检查登录状态：codex exec "Am I authenticated? What account am I using?"
  • 登出：codex logout
  1. API Key 设置：优点是可用于编程访问、无需浏览器、可脚本化流程、可集成 CI/CD。 三种设置方式（资料原文）：
  • 环境变量：export OPENAI_API_KEY="sk-your-api-key-here"，再用 codex exec "Test authentication" 验证
  • 配置文件：mkdir -p ~/.codex；cat > ~/.codex/config.toml << 'EOF' 写入 api_key = "sk-your-api-key-here"，随后 chmod 600 ~/.codex/config.toml
  • 项目级配置：mkdir -p .codex；echo 'api_key = "sk-project-specific-key"' > .codex/config.toml；echo '.codex/' >> .gitignore

三、认证优先级 Codex 按以下顺序检查认证（资料原文）：

  1. 命令行配置覆盖（-c api_key="..."）
  2. 环境变量 OPENAI_API_KEY
  3. 项目配置 .codex/config.toml
  4. 用户配置 ~/.codex/config.toml
  5. OAuth 凭据（来自 codex login）

四、配置文件示例（~/.codex/config.toml） 资料给出的示例包含：api_key、model（默认 gpt-5.1-codex-max，可选 gpt-5.2、gpt-5.2-pro）、ask_for_approval（如 never）、sandbox（如 workspace-write）、search、organization、reasoning_effort（medium/high/xhigh，资料注明 xhigh 仅 Pro 可用）、compact，以及 [features] 下的 web_search、multimodal、mcp。

五、主要能力

  • 多账号管理：资料提供 switch_codex_account 脚本示例，可在 personal、work、project、ci 之间切换，并在切换后用 codex exec 验证当前账号与可用模型。
  • 自动化账号测试：test_all_accounts 脚本示例，遍历账号并运行简单请求判断是否可用。
  • 安全密钥存储：pass（Password Store）与 macOS Keychain 的存储与读取示例；gpg --gen-key、pass init、pass insert openai/...，以及 security add-generic-password 与 security find-generic-password。
  • 环境差异化密钥：按 development、staging、production 使用不同环境变量密钥。
  • CI/CD 集成：GitHub Actions 工作流示例（npm install -g @openai/codex，通过 secrets.OPENAI_API_KEY 注入，codex exec --dangerously-bypass-approvals-and-sandbox --json 输出 analysis.json 并上传制品）；Dockerfile 示例；GitLab CI 示例（image: node:20，script 中安装 Codex 并执行分析，artifacts 输出 analysis.json，变量从 GitLab CI/CD 设置读取）。
  • 故障排查：认证失败（codex logout、rm -rf ~/.codex/credentials、重新登录或设置 API Key）、API Key 无效（检查 sk- 前缀、用 curl 调 /v1/models 验证、到平台重新生成）、速率限制（查看响应头、使用组织 API Key）、账号错误（查询当前账号后登出并重新登录）。
  • 安全实践：将 .codex/、.env、*.key 加入 .gitignore；chmod 600 配置文件；生产环境使用环境变量；定期轮换密钥（rotate_api_key 示例）；审计日志（audit_codex 示例，记录时间、用户、认证方式与命令）；最小权限（为不同用途使用不同密钥）。
  • 配置档（profiles）：示例包含 safe、dev、auto、ci、gpt52、gpt52-pro、long-context 等档位，每个档位可设置 model、ask_for_approval、sandbox、search、reasoning_effort、compact 等。使用方式如 codex exec -p dev "Develop new feature"、codex exec -p auto -m o3 "Complex task with reasoning"，以及项目级 profiles.project。
  • 相关技能：资料列出 codex-cli、codex-chat、codex-tools、codex-review、codex-git。
  • 更新方式：npm update -g @openai/codex；codex --version；更新后执行认证测试。

六、适用场景 需要在本地为 Codex CLI 配置账号、在多套账号或密钥之间切换、在 CI/CD 与 Docker 中自动注入凭据、或进行密钥安全存储与审计的开发者。

七、限制与缺失事实 资料未提供独立的定价或收费说明（仅提及不同订阅/档位对应的用量与模型差异）；未提供 codex-auth 自身的版本、许可证、平台支持范围或安装包信息；部分模型名称、命令参数与行为来自资料原文，未在本页做额外验证。