# Codex Overview

> Install Codex on macOS or Windows, configure Passion8 manually or with CC Switch, then use its workflows.

URL: https://docs.passion8.cc/en/docs/codex
Language: en
Publisher: Passion8

Codex provides CLI, desktop and IDE entry points for coding work. Supported custom-provider clients can connect to Passion8. This collection follows **install → configure → use core capabilities**.




Codex uses `https://passion8.cc/v1`, including `/v1`. Its endpoint convention differs from Claude Code.




## Connect to Passion8

Install first, then choose manual configuration or CC Switch:



- [Installation](https://docs.passion8.cc/en/docs/codex/install): macOS/Windows CLI, desktop and official IDE setup.
- [Configuration](https://docs.passion8.cc/en/docs/codex/config): Manual files or CC Switch, with the /v1 endpoint.
- [CC Switch](https://docs.passion8.cc/en/docs/codex/cc-switch): Provider, base URL, key and model fields.
- [Configuration reference](https://docs.passion8.cc/en/docs/codex/config-reference): Files, profiles, providers, variables and project overrides.



## Everyday use



- [Desktop app](https://docs.passion8.cc/en/docs/codex/app): Projects, threads, diffs, permissions and agents.
- [IDE extension](https://docs.passion8.cc/en/docs/codex/ide): Use Codex alongside your code.
- [Commands](https://docs.passion8.cc/en/docs/codex/commands): Subcommands, slash commands, resume and permissions.
- [Terminal reference](https://docs.passion8.cc/en/docs/codex/cli-terminal-reference): exec, app-server, remote access, diagnostics and pipes.
- [Memory and AGENTS.md](https://docs.passion8.cc/en/docs/codex/memory): Persist project rules and personal preferences.



## Permissions and extensions



- [Permissions and sandbox](https://docs.passion8.cc/en/docs/codex/permissions-sandboxing): Approvals, network, rules and unrestricted modes.
- [Feature availability](https://docs.passion8.cc/en/docs/codex/feature-availability): Local, cloud, browser and provider differences.
- [MCP](https://docs.passion8.cc/en/docs/codex/mcp): Connect documentation, databases and design tools.
- [Skills and plugins](https://docs.passion8.cc/en/docs/codex/skills): Package workflows and install capabilities.
- [Hooks and customization](https://docs.passion8.cc/en/docs/codex/customization-hooks-rules): Instructions, memories, hooks, rules and imports.



## Workflows and advanced use



- [Standard workflow](https://docs.passion8.cc/en/docs/codex/workflow): Requirements, plan, implement, test, review and deliver.
- [Git and GitHub](https://docs.passion8.cc/en/docs/codex/git): Commits, branches, diffs, worktrees and recovery.
- [Subagents and worktrees](https://docs.passion8.cc/en/docs/codex/subagents-worktrees): Separate independent exploration and implementation.
- [Review and PRs](https://docs.passion8.cc/en/docs/codex/review-github): Local reviews, GitHub integration and CI.
- [Advanced usage](https://docs.passion8.cc/en/docs/codex/tips): Profiles, non-interactive execution and sandbox.



## Platforms, automation and enterprise



- [Automation and cloud](https://docs.passion8.cc/en/docs/codex/automation): Recurring tasks and hosted-provider boundaries.
- [CI and SDKs](https://docs.passion8.cc/en/docs/codex/noninteractive-ci-sdk): exec, Actions, app-server and automation credentials.
- [Platforms and integrations](https://docs.passion8.cc/en/docs/codex/platforms-integrations): Local clients, cloud, connectors, Sites and remote access.
- [Browser and Computer Use](https://docs.passion8.cc/en/docs/codex/browser-computer-use): Browser, Chrome, desktop control and recording.
- [Enterprise governance](https://docs.passion8.cc/en/docs/codex/enterprise-governance): RBAC, managed policy, tokens, audit and rollout.
- [Official coverage map](https://docs.passion8.cc/en/docs/codex/official-coverage-map): How local guides map to upstream documentation.
- [Troubleshooting](https://docs.passion8.cc/en/docs/codex/troubleshooting): Authentication, /v1 and Responses failures.



For registration and balance, see [Quickstart](https://docs.passion8.cc/en/docs/quickstart) and [Billing](https://docs.passion8.cc/en/docs/billing).

## Themes and appearance

Explore compatible desktop themes in the [DreamSkin gallery](https://dreamskin.cc/gallery?utm_source=passion8&utm_medium=referral&utm_campaign=community&utm_content=codex_guide). Preview a theme, then follow that project's installation instructions; you can also create and share themes. Passion8 sponsors the project. Themes are independent of API access and do not require a Passion8 account.

Start with [Quickstart](https://docs.passion8.cc/en/docs/quickstart), consult [Billing](https://docs.passion8.cc/en/docs/billing) for costs, and use the [FAQ](https://docs.passion8.cc/en/docs/faq) or [Codex troubleshooting](https://docs.passion8.cc/en/docs/codex/troubleshooting) for connection errors.
