From 53b2259f9ab6d880065345166e134b01b4536b3f Mon Sep 17 00:00:00 2001 From: Jesus Gonzalez Date: Thu, 26 Mar 2026 18:29:52 +0000 Subject: [PATCH] [DCV-3774] Document OpenAI Codex integration --- .../vs-code/external-ai-tools/_category_.yaml | 6 +++ .../vs-code/external-ai-tools/openai-codex.md | 49 +++++++++++++++++++ 2 files changed, 55 insertions(+) create mode 100644 docs/how-tos/vs-code/external-ai-tools/_category_.yaml create mode 100644 docs/how-tos/vs-code/external-ai-tools/openai-codex.md diff --git a/docs/how-tos/vs-code/external-ai-tools/_category_.yaml b/docs/how-tos/vs-code/external-ai-tools/_category_.yaml new file mode 100644 index 0000000..a313acb --- /dev/null +++ b/docs/how-tos/vs-code/external-ai-tools/_category_.yaml @@ -0,0 +1,6 @@ +label: External AI Tools +position: 45 +link: + type: generated-index + title: External AI Tools + description: Configure and use external AI coding assistants in Datacoves. diff --git a/docs/how-tos/vs-code/external-ai-tools/openai-codex.md b/docs/how-tos/vs-code/external-ai-tools/openai-codex.md new file mode 100644 index 0000000..f8e4ac5 --- /dev/null +++ b/docs/how-tos/vs-code/external-ai-tools/openai-codex.md @@ -0,0 +1,49 @@ +--- +title: OpenAI Codex +sidebar_position: 1 +--- + +# OpenAI Codex + +[OpenAI Codex](https://openai.com/codex/) is an AI coding assistant available as both a CLI tool and a VS Code extension in Datacoves. + +## Prerequisites + +- A [ChatGPT](https://chatgpt.com) account +- Codex enabled in your Datacoves environment. Contact [Datacoves support](mailto:support@datacoves.com) to enable it. + +## Enable device code login + +Before logging in from Datacoves, enable device code login in your ChatGPT account. + +**Personal accounts:** go to your [ChatGPT security settings](https://chatgpt.com/security-settings) and enable device code login. + +**Workspace / Enterprise accounts:** a workspace admin must enable device code authentication in the [admin permissions](https://chatgpt.com/admin/permissions) page. + +For more details, see [OpenAI's authentication docs](https://developers.openai.com/codex/auth). + +## Login + +1. Open a terminal in your Datacoves VS Code workspace + +2. Run: + + ```bash + codex login --device-auth + ``` + +3. The CLI will display a URL and a one-time code + +4. Open the URL in any browser, enter the code, and sign in with your ChatGPT account + +Both the CLI and the VS Code extension are now authenticated. + +:::note +You may need to reload your browser tab after CLI login for the VS Code extension to pick up the credentials. +::: + +## Learn more + +- [OpenAI Codex documentation](https://developers.openai.com/codex) +- [Codex authentication](https://developers.openai.com/codex/auth) +- [Codex CLI reference](https://developers.openai.com/codex/cli/reference)