2 2
3> For the complete documentation index, see [llms.txt](https://learn.chatgpt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to the page URL.3> For the complete documentation index, see [llms.txt](https://learn.chatgpt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to the page URL.
4 4
5Codex Security is an application security agent that helps security and5Codex Security reviews code for vulnerabilities and reports evidence you can
6engineering teams find, confirm, and fix vulnerabilities. Use it in6use to investigate and fix them. Choose how to run it based on where your code
7Codex, from your terminal, through the TypeScript SDK, or with connected GitHub7lives and how you want to review the results.
8repositories.
9 8
10<CtaPillLink9## Choose where to start
11 href="https://chatgpt.com/plugins/share/676aca3811d54fa7bcdef5255236b3c4"
12 label="Install local Security plugin"
13 icon="external"
14 class="mb-8 mt-2"
15/>
16 10
17For your first local scan, start with the [Codex Security plugin11| Use | When you want to | Start here |
18quickstart](https://learn.chatgpt.com/docs/security/plugin).12| --------------------- | ------------------------------------------------------------------------- | --------------------------------------------------- |
13| Codex Security Cloud | Scan connected GitHub repositories in Codex cloud or monitor new commits. | [Cloud setup](https://learn.chatgpt.com/docs/security/setup) |
14| Codex Security plugin | Scan a local repository in Codex and work through findings interactively. | [Run your first local scan](https://learn.chatgpt.com/docs/security/plugin) |
15| Codex Security CLI | Run repeatable terminal scans or add checks to CI. | [CLI quickstart](https://learn.chatgpt.com/docs/security/cli) |
16| Codex Security SDK | Run scans and handle results in an application or developer tool. | [SDK guide](https://learn.chatgpt.com/docs/security/sdk) |
19 17
20## Use Codex Security in the desktop app18For your first local scan, use the plugin. In the ChatGPT desktop app, select
19**Codex**, install **Codex Security**, and open **Security** in the sidebar.
20The [Security workbench](https://learn.chatgpt.com/docs/security/plugin/workbench) keeps saved scans
21and findings available for review. You can also use the plugin in Codex CLI.
21 22
22In the ChatGPT desktop app, open the ChatGPT dropdown and select **Codex**.23The Codex Security CLI and SDK are distributed in the public [@openai/codex-security package](https://github.com/openai/codex-security). Scans using OpenAI inference require Codex Security access. See each quickstart for its
23Install and enable the Codex Security plugin to open **Security** in the24runtime and authentication requirements.
24sidebar. The Security workbench keeps your scans, findings, and repositories in
25one place while Codex runs each scan in a task.
26 25
27- Use **Scans** to start scans, follow their progress, and review saved results.26Codex Security Cloud is a separate plugin, available in research preview on
28- Use **Findings** to inspect issues and evidence across completed scans.27the web and in the desktop app. It requires workspace access, a GitHub
29- Use **Repositories** to review repository history and open findings.28connection, and a compatible Codex cloud environment. You can connect the
30 29repository and create an environment during setup.
31See [Use the Security workbench](https://learn.chatgpt.com/docs/security/plugin/workbench) for the
32complete desktop-app workflow.
33
34### Explore plugin use cases
35
36- [Run a security scan](https://learn.chatgpt.com/docs/security/plugin/scans) for a repository or one scoped folder.
37- [Run a deep security scan](https://learn.chatgpt.com/docs/security/plugin/deep-scans) when you need broader review and can wait longer for it to finish.
38- [Review code changes](https://learn.chatgpt.com/docs/security/plugin/code-changes) before you merge a pull request or branch.
39- [Triage a backlog](https://learn.chatgpt.com/docs/security/plugin/triage-backlog) when you have existing security findings to review.
40- [Fix and verify findings](https://learn.chatgpt.com/docs/security/plugin/fix-findings) with bounded patches for approved findings.
41- [Export or track findings](https://learn.chatgpt.com/docs/security/plugin/export-findings) as portable artifacts or approval-gated tracking destinations.
42- [Write vulnerability reports](https://learn.chatgpt.com/docs/security/plugin/vulnerability-reports) from supplied findings, disclosure notes, source, and PoCs.
43- [Propose security hardening](https://learn.chatgpt.com/docs/security/plugin/security-hardening) from scan results or other security evidence.
44- [See what's new](https://learn.chatgpt.com/docs/security/plugin/changelog) in the Codex Security plugin.
45
46The desktop Security workbench and Codex CLI use the Codex Security plugin.
47 The separate Codex Security Cloud plugin scans connected GitHub repositories
48 in Codex cloud. For Codex sandboxing, approvals, network controls, and admin
49 settings, see [Agent approvals & security](https://learn.chatgpt.com/docs/agent-approvals-security).
50
51## Codex Security CLI and SDK
52
53The CLI and TypeScript SDK are available as the public
54[`@openai/codex-security`](https://github.com/openai/codex-security) package.
55Run the CLI with `npx`:
56
57```bash
58npx @openai/codex-security --help
59```
60
61Running scans requires Codex Security access. For best results, use an account
62verified for [Trusted Access for Cyber](https://chatgpt.com/cyber).
63
64Use the same scanner as the plugin across repositories and over time. The CLI
65discovers GitHub repositories, resumes bulk scans, tracks findings across
66scans, and records false-positive feedback. Add your architecture and security
67policies, set an estimated cost limit, or run checks in CI and before commits.
68Use the TypeScript SDK to build scanning, progress reporting, and cost controls
69into an application or developer tool.
70
71- [Start with the CLI quickstart](https://learn.chatgpt.com/docs/security/cli) to set up the CLI,
72 preflight a repository, and run a local scan.
73- [Run bulk security scans](https://learn.chatgpt.com/docs/security/cli/bulk-scans) to discover GitHub
74 repositories or run a resumable campaign from a CSV inventory.
75- [Run scans in CI](https://learn.chatgpt.com/docs/security/cli/ci) to review pull-request changes,
76 preserve artifacts, upload SARIF, and set a severity policy.
77- [Read the CLI FAQ](https://learn.chatgpt.com/docs/security/cli/faq) for answers about scan history,
78 false-positive feedback, coverage, and fix verification.
79- [Use the CLI reference](https://learn.chatgpt.com/docs/security/cli/reference) to check supported
80 commands, flags, output formats, artifacts, and exit codes.
81- [Integrate the TypeScript SDK](https://learn.chatgpt.com/docs/security/sdk) to select targets,
82 inspect results, track progress, and cancel scans from code.
83
84## Codex Security Cloud
85
86Codex Security Cloud is a plugin for scanning connected GitHub repositories
87in Codex cloud. It's available in research preview on the web and in the
88desktop app.
89
90Open **Plugins** to find and install **Codex Security Cloud**. Follow
91[Cloud setup](https://learn.chatgpt.com/docs/security/setup) to connect GitHub and start your first scan.
92
93<CtaPillLink
94 href="https://chatgpt.com/plugins/plugin_connector_1p_6317a32dbf5c81919acd66de6722daf5"
95 label="Find Codex Security Cloud"
96 target="_blank"
97 rel="noopener noreferrer"
98 icon="external"
99 class="my-8"
100/>
101 30
102<figure className="not-prose my-8">31<figure className="not-prose my-8">
103 <CodexScreenshot32 <CodexScreenshot
115 </figcaption>44 </figcaption>
116</figure>45</figure>
117 46
118## How Codex Security Cloud works47For security reviews posted to GitHub pull requests, see
119 48[Security Review](https://learn.chatgpt.com/docs/security/security-review).
120Choose **One-Time Scan** to review a repository once, or **Continuous Scanning**
121to monitor new commits. Codex uses repository context to identify likely
122vulnerabilities and validates issues in an isolated environment when possible.
123
124Use **Scans** to follow progress, **Findings** to review issues, and
125**Repositories** to manage monitoring. Review proposed patches before
126creating a pull request.
127 49
128## Codex Security Cloud access and prerequisites50## Choose the next task
129 51
130Use a workspace with Codex Security Cloud access, a connected GitHub52After a local scan, review its scope and findings before deciding what to do next.
131repository, and a compatible Codex cloud environment. You can connect GitHub
132and create an environment during scan setup.
133 53
134If access is unavailable, check with your workspace administrator.54| Task | Guide |
55| ----------------------------------------------------- | ------------------------------------------------------------------- |
56| Focus a scan on a service or add security context | [Run a security scan](https://learn.chatgpt.com/docs/security/plugin/scans) |
57| Run repeated reviews of the same repository or folder | [Run a deep scan](https://learn.chatgpt.com/docs/security/plugin/deep-scans) |
58| Check a pull request, commit, or local diff | [Review code changes](https://learn.chatgpt.com/docs/security/plugin/code-changes) |
59| Assess findings from another scanner or issue tracker | [Triage a backlog](https://learn.chatgpt.com/docs/security/plugin/triage-backlog) |
60| Generate a patch and check whether it fixes the issue | [Fix and verify findings](https://learn.chatgpt.com/docs/security/plugin/fix-findings) |
61| Share results or assign remediation work | [Export and track findings](https://learn.chatgpt.com/docs/security/plugin/export-findings) |
135 62
136## Related docs63For automation, use the CLI guides to [scan repositories in
64bulk](https://learn.chatgpt.com/docs/security/cli/bulk-scans) or [run scans in
65CI](https://learn.chatgpt.com/docs/security/cli/ci). Look up commands and defaults in the
66[CLI reference](https://learn.chatgpt.com/docs/security/cli/reference).
137 67
138- [Codex Security plugin quickstart](https://learn.chatgpt.com/docs/security/plugin) walks through installation and a first local scan.68Codex Security scans application code. For permissions and sandbox controls
139- [Security workbench](https://learn.chatgpt.com/docs/security/plugin/workbench) explains saved scans, findings, repositories, and scan activity in the desktop app.69that govern Codex itself, see [Agent approvals and
140- [Codex Security CLI quickstart](https://learn.chatgpt.com/docs/security/cli) walks through setup, preflight, and a first terminal scan.70security](https://learn.chatgpt.com/docs/agent-approvals-security).
141- [Run bulk security scans](https://learn.chatgpt.com/docs/security/cli/bulk-scans) explains GitHub discovery, CSV inventories, campaign results, and resume behavior.
142- [Codex Security CLI FAQ](https://learn.chatgpt.com/docs/security/cli/faq) answers common questions about scans, findings, coverage, and costs.
143- [Codex Security TypeScript SDK](https://learn.chatgpt.com/docs/security/sdk) explains how to run scans from an application or developer tool.
144- [Codex Security Cloud setup](https://learn.chatgpt.com/docs/security/setup) details setup, scanning, and findings review.
145- [Security Review](https://learn.chatgpt.com/docs/security/security-review) explains how to run in-depth security reviews on GitHub pull requests.
146- [Improving the threat model](https://learn.chatgpt.com/docs/security/threat-model) explains how to tune scope, entry points, and criticality assumptions.
147- [Codex Security Cloud FAQ](https://learn.chatgpt.com/docs/security/faq) covers common cloud product questions.