openai-codex

openai-codex

OpenAI Codex 是 OpenAI 官方的编码 Agent 产品，由 codex CLI、IDE 扩展、ChatGPT 桌面应用（官方名称为 Codex in the ChatGPT desktop app）和 cloud 组成。 内容基于 2026-10-16 获取的 learn.chatgpt.com/docs（URL 未标注版本）。适用的模型世代为 GPT-6 系列：gpt-6-astra / gpt-6.1-sol / gpt-6-sol / gpt-6-luna。 涵盖 CLI、IDE、桌面应用和 cloud 的安装；CLI / IDE / 桌面应用的命令和设置；通过 AGENTS.md/rules/subagents/memories 配置 Agent； Fast / Ultrafast mode、config.toml/MCP 设置；通过 approvals、sandbox、GitHub Action、Codex SDK、App Server 实现自动化； 通过 plugins、创建 Codex skills、scheduled tasks、Browser、Computer Use、web search 扩展功能； 工作区 administration（包括 LLM gateway、service accounts、Agent Security）； 使用 Codex Security 扫描和修复漏洞；切换 cloud/local/worktree 环境和 Record & Replay； 以及与 GitHub、GitLab、Linear、Slack 的集成和 code review。

codex mcp-server 已删除，后继方案为 App Server（JSON-RPC）。references/security-automation/agents-sdk-mcp-server.md 总结了删除 codex mcp-server 并迁移到 App Server 的步骤（旧版 Agents SDK 集成示例已停止支持）。

本技能提炼自 OpenAI Codex 官方文档，与本仓库所面向的 Claude Code 的 .claude/ 体系是两回事。尽管 AGENTS.md / rules / subagents 等术语有重叠之处， 但配置文件的格式、位置和含义与 Claude Code 的 CLAUDE.md / .claude/rules/ / .claude/agents/ 不兼容 （有关 AGENTS.md、rules、subagents 的详情，请从 references/agent-configuration/README.md 索引查阅各页面）。

目录结构

skills/openai-codex/
  SKILL.md
  references/
    getting-started/
      README.md
      cli.md
      cli-customization.md
      ide.md
      desktop-app.md
      windows-app.md
      linux-app.md
      cloud.md
      cloud-internet-access.md
      remote.md
      remote-connections.md
      models.md
      model-selection.md
      codex-micro.md
      best-practices.md
      troubleshooting.md
    commands/
      README.md
      cli-global-flags.md
      cli-subcommands.md
      cli-slash-commands.md
      ide-commands.md
      ide-slash-commands.md
      ide-settings.md
      app-commands.md
      app-settings.md
    agent-configuration/
      README.md
      agents-md.md
      rules.md
      hooks.md
      speed.md
      subagents.md
      prompting.md
      memories.md
      import.md
    config/
      README.md
      config-basics.md
      config-advanced.md
      config-reference.md
      config-sample.md
      environment-variables.md
      mcp-config.md
      amazon-bedrock.md
    security-automation/
      README.md
      agent-approvals-security.md
      sandbox.md
      permission-profiles.md
      permission-modes.md
      auto-review.md
      windows-sandbox.md
      windows-wsl.md
      non-interactive-mode.md
      github-action.md
      codex-sdk.md
      app-server.md
      agents-sdk-mcp-server.md
    administration/
      README.md
      administration.md
      admin-rollout-guide.md
      work-admin-faq.md
      usage-limits.md
      groups-and-provisioning.md
      roles-and-workspace-permissions.md
      access-tokens.md
      service-accounts.md
      analytics-api.md
      compliance-api.md
      governance.md
      agent-security.md
      workspace-analytics.md
      workspace-model-availability.md
      plugin-controls.md
      plugin-management.md
      skill-controls.md
      managed-configuration.md
      manage-app-updates.md
      windows-deployment.md
      authentication.md
      connect-to-a-gateway.md
      roll-out-a-gateway.md
      gateway-compatibility.md
      sign-in-with-chatgpt-through-a-gateway.md
      bedrock-through-litellm.md
    security/
      README.md
      overview.md
      cloud-setup.md
      cloud-faq.md
      threat-model.md
      plugin-quickstart.md
      workbench.md
      scans.md
      deep-scans.md
      code-changes.md
      security-review.md
      triage-backlog.md
      fix-findings.md
      export-findings.md
      vulnerability-reports.md
      security-hardening.md
      plugin-changelog.md
      cli-quickstart.md
      cli-reference.md
      cli-faq.md
      cli-bulk-scans.md
      cli-ci.md
      cli-ci-gitlab.md
      sdk.md
    environments/
      README.md
      cloud-environments.md
      cloud-environment.md
      git-worktrees.md
      local-environment.md
      modes.md
    extend/
      README.md
      plugins.md
      build-skills.md
      automations.md
      browser.md
      computer-use.md
      web-search.md
      record-and-replay.md
    third-party/
      README.md
      github.md
      gitlab.md
      code-review.md
      linear.md
      slack.md
  samples/
    README.md
    follow-goals.md
    github-code-reviews.md
    codebase-onboarding.md
    automation-bug-triage.md
    slack-coding-tasks.md
    reusable-codex-skills.md
    refactor-your-codebase.md
    code-migrations.md
    update-documentation.md
    agent-friendly-clis.md
    verified-operations-workflows.md
    ai-app-evals.md
    scan-code-changes-for-security.md
    deep-security-scan.md
    remediate-vulnerability-backlog.md
    dependency-incident-audits.md
    ios-simulator-bug-debugging.md
  scripts/
    README.md
    install.md
    auth.md
    cli-basics.md
    automation.md
    config.md

探索步骤

根据任务查找类别，再从类别的 README.md 中确定目标页面：

1. 在下方映射表中查找与任务对应的类别
2. 参阅该类别的 references/{category}/README.md，确定目标页面
3. Read 对应的 .md 页面，查看详情

タスク → カテゴリ マッピング

タスク	カテゴリ	参照 README
Codex CLI / IDE 拡張 / desktop app / cloud の導入・違いを知りたい	getting-started	references/getting-started/README.md
CLI の出力・エイリアスをカスタマイズしたい、desktop app（Windows / Linux）・リモート接続から使いたい	getting-started	references/getting-started/README.md
モデル選択（GPT-6 系・Codex Micro 含む）・reasoning effort・ベストプラクティス・トラブルシュートを知りたい	getting-started	references/getting-started/README.md
CLI のフラグ・サブコマンド・スラッシュコマンド、IDE / desktop app のコマンドと設定を引きたい	commands	references/commands/README.md
AGENTS.md / prompting / subagents / memories ワークフローを設定したい	agent-configuration	references/agent-configuration/README.md
サンドボックス外で実行するコマンドを rules（.rules / Starlark prefix_rule）で許可したい、hooks でエージェントのライフサイクルにフックしたい	agent-configuration	references/agent-configuration/README.md
Fast / Ultrafast mode で速度を切り替えたい、Claude Code / Cursor の設定を取り込みたい（import）	agent-configuration	references/agent-configuration/README.md
config.toml のキー・プロファイル・MCP サーバー設定、Amazon Bedrock 経由の利用を知りたい	config	references/config/README.md
環境変数の一覧を知りたい	config	references/config/README.md
approvals / sandbox / permission profiles / permission modes を設計したい	security-automation	references/security-automation/README.md
codex exec を CI/GitHub Action/Codex SDK から自動実行したい、Windows/WSL 上のサンドボックスを設定したい	security-automation	references/security-automation/README.md
App Server でカスタムクライアントを作りたい（旧 MCP server からの移行）	security-automation	references/security-automation/README.md
ワークスペースの roles / provisioning / analytics / compliance を管理したい	administration	references/administration/README.md
Enterprise ロールアウト・アクセストークン運用を知りたい	administration	references/administration/README.md
LLM gateway 経由の利用・service accounts・Agent Security・plugin 管理を設定したい	administration	references/administration/README.md
リポジトリの脆弱性スキャン・トリアージ・修復（Codex Security）を行いたい、PR/差分のセキュリティレビューをしたい	security	references/security/README.md
検出結果の SARIF/CSV/JSON エクスポート・CI（GitLab 含む）連携・threat model 調整をしたい	security	references/security/README.md
Cloud / Local / Worktree 環境の設定・切り替え、git worktree でチャットを分離したい	environments	references/environments/README.md
新 Cloud environments と Legacy の違いを知りたい	environments	references/environments/README.md
plugins・Codex skills 作成（.agents/skills）・scheduled tasks（automations）・Browser・Computer Use・web search を使いたい	extend	references/extend/README.md
ワークフローを録画してスキル化したい（Record & Replay）	extend	references/extend/README.md
GitHub / GitLab / Linear / Slack（ChatGPT in Slack）から Codex を呼び出したい	third-party	references/third-party/README.md
GitLab MR レビュー・code review 全般を設定したい	third-party	references/third-party/README.md
典型的な使い方を知りたい	samples	samples/README.md
インストール・CLI コマンドを知りたい	scripts	scripts/README.md