AI Agents & Sessions
Set Up Codex
By TermSquad · Last reviewed
Connect Codex from Settings → AI tools to use it on your TermSquad computer. The managed connection flow uses device-code authentication, which is suited to a remote terminal.
Connect Codex
- Select a running computer and open Settings → AI tools.
- Choose Connect beside Codex.
- Wait for installation if needed.
- In the login terminal, follow the link and one-time code.
- Sign in to the intended OpenAI account in your browser.
- Return to TermSquad and wait for authentication to complete.
If you need to restart the login manually in the agent terminal, the managed command is:
codex login --device-authDevice-code login may need to be enabled in personal security settings or by a workspace administrator. OpenAI’s Codex authentication guide explains supported account and API-key options.
Start your first session
Enter your project folder and choose Codex from the terminal’s Agents menu, or run codex. Start with a request to explain the repository before asking for edits. Keep normal approvals while you learn the workflow.
Check codex --version when reporting a setup issue. A successful version check confirms installation, not provider access.
If sign-in or model access fails
Finish the current login before starting another. Check the account’s access, organization policy, and quota. For Squad, choose a model shown after Refresh models; do not assume another account’s catalog applies.