หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
Use the Codex agent in ChatGPT desktop with models, MCP tools, and skills through Unity Gateway. ChatGPT desktop also supports bringing your own ChatGPT subscription.
Use supported open-source models in ChatGPT desktop to help reduce costs.
Prerequisites
You need your Azure Databricks workspace URL, access to the models and tools you want to use, and the latest version of ChatGPT desktop.
If your admin has already configured your device, follow your organization's launch instructions.
Connect with the Unity Gateway CLI (Recommended)
Install ug, then run this command in an interactive terminal:
ug configure --agents codex
Select your workspace and sign in. This command configures both the Codex CLI and the installed ChatGPT desktop work agent for the same workspace. If prompted, approve the system configuration update with your device password. ug configures the Unity Gateway connection and OAuth token refresh.
On Windows, run the command from an elevated terminal. ChatGPT desktop on Windows requires Codex 0.156.0 or later to apply the configuration.
Open or restart ChatGPT desktop, then start a Codex conversation. Use the model picker to change models.
Add MCP tools and skills
Use ug to add the MCP servers and skills available through your workspace:
ug mcp add --agents codex
ug skills add
Open or restart ChatGPT desktop after configuration. Enter /mcp to check MCP connections. Skills are available from ~/.agents/skills/.
For manual model, MCP, and skill configuration, see Connect Codex. Those settings apply to both the Codex CLI and ChatGPT desktop.
Bring your own ChatGPT subscription
To use your own ChatGPT subscription in ChatGPT desktop, ask your admin for a ChatGPT subscription model provider service. See ChatGPT subscription support for requirements, admin setup, how it works, and limitations.
- Run
ug configure --agents codexin an interactive terminal. Under External Models, select the ChatGPT subscription model provider service. - Restart ChatGPT desktop and sign in with ChatGPT.
ug points ChatGPT desktop's ~/.codex/config.toml at a local proxy that runs as a per-user ug login service, so running codex directly also uses your ChatGPT subscription. ug codex --provider doesn't change ChatGPT desktop. If ~/.codex/config.toml already sets model_provider, ug leaves it unchanged and prints a warning. To stop using your ChatGPT subscription, rerun ug configure --agents codex with a provider that doesn't use one, or run ug revert.
Limitations
This setup configures both the Codex CLI and ChatGPT desktop. The configuration applies to all conversations in both, and their inference routes through Unity Gateway.
ChatGPT desktop supports open models through Unity Gateway. Smart Routing isn't supported in ChatGPT desktop.
Troubleshooting
ChatGPT desktop asks for OpenAI sign-in: If you bring your own ChatGPT subscription, sign in with ChatGPT. Otherwise, rerun
ug configure --agents codexinteractively and complete the system configuration update. On Windows, run it from an elevated terminal. The CLI profile alone doesn't configure ChatGPT desktop. For manual setup, check thatmodel_provideris at the top level andrequires_openai_auth = falseis in the provider table. Don't add that flag to a provider that uses anauthtable for OAuth token refresh.ugreportsCodex ChatGPT relay cannot start: See Troubleshooting in ChatGPT subscription support.A model is missing: Check your model permissions. Set
modelto its full Unity Catalog name in the active configuration and start a new conversation.An MCP or skill connection fails: Check the URL, permissions, and connector error. For manual connections, also check token expiration. For
ugsetup problems, runug doctor.Workspace sign-in works, but a tool asks you to log in: Open the login link returned by the MCP, sign in to the external provider, then retry the call. Workspace and provider sign-in are separate steps.