Codex

Platforms and integrations

Local CLI, app, IDE, hosted services, remote connections and provider boundaries.

Codex has multiple local and hosted entry points. Local clients can read their runtime's Codex configuration; hosted integrations use their own account, workspace and environment settings.

#Choose an entry point

EntryExecutionSuitable workInherits local Passion8?
CLILocal terminalCoding, review and scriptsWhen configured in that runtime
Desktop LocalLocal appThreads, review, worktrees and device toolsWhen the client supports the selected provider
IDEEditor runtimeCode-context collaborationWhen using that runtime's configuration
Web/cloudHosted environmentRemote tasks and PRsNo automatic inheritance
Slack/LinearHosted tasksDispatch from collaboration toolsNo automatic inheritance
GitHub reviewHosted integrationTeam PR reviewNo automatic inheritance
Action/CIRunnerAutomated review/migration/checksDepends on runner setup
Remote connectionsConnected hostControl tasks from another deviceUses the host's configuration
SitesHosted publishingShare websites and prototypesSeparate hosting/account capability

#The local clients

CLI, supported local desktop workflows and IDE extensions can share configuration for the same runtime user:

SettingLocation
Provider, model, sandbox~/.codex/config.toml
Credential/sessionauth.json or configured credential store
Project rulesAGENTS.md
MCPmcp_servers tables
Skills/pluginsSupported local installation directories

Example environment-key provider:

[model_providers.passion8]
name = "Passion8"
base_url = "https://passion8.cc/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

Select it with the corresponding top-level model_provider and supply a Passion8 key in that environment variable. This is an alternative to the auth.json route, not an additional required login. Claude Code's endpoint convention differs; do not copy its URL format into Codex.

#Web and cloud

Use the current official web/cloud entry to connect a repository and configure an environment.

ScenarioBenefit
Dispatch from mobile/webDoes not require the local terminal task to remain open
Several remote tasksIsolated hosted environments
Prepare a PRRepository integration
Team collaborationWorkspace permissions, audit and review

Boundaries:

  • Hosted execution does not read your laptop's config.toml.
  • Repository connections and environments must be configured separately.
  • Private dependencies, variables and secrets need environment setup.
  • A local Passion8 provider does not automatically route hosted tasks.

#Slack and Linear

ToolTriggerPrerequisites
SlackMention @Codex in the supported contextOfficial integration and repository/environment access
LinearAssign or mention Codex where supportedConnector and repository/environment access

To read an issue from a local task, an MCP connection may be more appropriate:

codex mcp add linear --url https://mcp.linear.app/mcp
codex mcp login linear

The same distinction applies to Slack: reading through a local tool differs from creating an official hosted task.

#GitHub integration

PathExecution
Local Git/ghUses local tools and can use the configured Passion8 model
Hosted PR reviewOfficial integration, such as @codex review
Codex ActionRunner setup and Action configuration determine routing

A practical sequence:

  1. Develop locally in CLI/IDE/app.
  2. Run /review before the PR.
  3. Use hosted or CI review for the team process.
  4. Limit automatic fixes to trusted branches and scoped permissions.

#Remote connections

A remote connection uses the connected host's project, threads, files, credentials, MCP, plugins and relevant device-tool settings.

Suitable uses:

  • Monitor a long task from another device.
  • Send follow-up instructions to an office/development machine.
  • Work in an SSH host's filesystem and shell.

Keep ordinary SSH and authentication controls. The host's sandbox, approval and browser/computer permissions still apply; remote access is not a bypass.

#Sites

Sites is a hosted publishing capability, separate from configuring your own server. Check current account and service availability before using it.

QuestionApproach
Local preview only?Use a dev server and browser tool
Public/workspace sharing?Consider a supported hosting workflow
Database or storage?Identify the required persistence services
Secrets?Use the host's runtime secret settings, not source files

Treat published deployment URLs as live deployments. Verify audience, build, environment variables and migrations before publishing.

#Continue reading

#Official references

Support

Need help?

For setup, billing, or model issues, email us. Check the status page for uptime.

WeChat / QQ support is available at the bottom right.