# Codex 总览 > Codex 接入 Passion8 全流程:先按 macOS / Windows 安装 CLI、桌面端和官方 IDE 插件,再用手动配置或 CC-Switch 固定接入 Passion8。 URL: https://docs.passion8.cc/docs/codex Language: zh-CN Publisher: Passion8 Codex 是 OpenAI 的编程工具，提供 CLI、桌面客户端和 IDE 扩展。支持自定义 provider 的客户端可按本文配置接入 Passion8。这一栏按「**先安装 → 再配置 → 用核心功能**」的顺序整理。 Codex 的 `base_url` 是 `https://passion8.cc/v1`,**带** `/v1`。这点和 Claude Code 不同。 ## 接入步骤 第一优先级是先安装,再配置。配置只保留两条路:手动写配置,或用 CC-Switch 固定填写 Passion8。 - [安装教程](https://docs.passion8.cc/docs/codex/install): macOS / Windows 安装 CLI、桌面端和官方 IDE 插件。 - [配置教程](https://docs.passion8.cc/docs/codex/config): 手动配置或用 CC-Switch 接入 Passion8。Base URL 带 /v1。 - [CC-Switch 配置](https://docs.passion8.cc/docs/codex/cc-switch): 固定填写 Passion8 Codex 供应商、Base URL、API Key 和模型。 - [配置参考](https://docs.passion8.cc/docs/codex/config-reference): config.toml、auth.json、Profile、Provider、环境变量和项目级配置。 ## 日常使用 接入之后,把 Codex 的能力用起来。 - [桌面 App](https://docs.passion8.cc/docs/codex/app): 图形界面管理项目、线程、diff、权限和多 agent 工作流。 - [IDE 扩展](https://docs.passion8.cc/docs/codex/ide): 在 VS Code、Cursor、Windsurf、JetBrains 里使用 Codex。 - [命令大全](https://docs.passion8.cc/docs/codex/commands): 启动与子命令、斜杠命令、会话恢复与权限开关。 - [CLI 与终端参考](https://docs.passion8.cc/docs/codex/cli-terminal-reference): exec、resume、app-server、远程连接、诊断和 stdin 管道。 - [记忆与 AGENTS.md](https://docs.passion8.cc/docs/codex/memory): 用 AGENTS.md 让 Codex 记住项目规则与个人偏好。 ## 权限与扩展 - [权限、沙箱与安全](https://docs.passion8.cc/docs/codex/permissions-sandboxing): approval_policy、sandbox_mode、网络访问、Rules 和危险模式。 - [功能可用性与 Provider 差异](https://docs.passion8.cc/docs/codex/feature-availability): 本地、云端、App、IDE、Chrome、Computer Use 和 Passion8 边界。 - [MCP:连接外部工具](https://docs.passion8.cc/docs/codex/mcp): 让 Codex 连文档、数据库、Figma、GitHub 等外部工具。 - [Skill 与插件](https://docs.passion8.cc/docs/codex/skills): 把重复流程固化成 Skill,用插件扩展能力。 - [Hooks、Rules 与自定义](https://docs.passion8.cc/docs/codex/customization-hooks-rules): AGENTS.md、custom prompts、memories、hooks、rules、import 和 subagents。 ## 工作流与进阶 - [标准工作流](https://docs.passion8.cc/docs/codex/workflow): 需求拆解 → 计划 → 小步实现 → 测试 → 审查 → 交付。 - [代码管理:Git 与 GitHub](https://docs.passion8.cc/docs/codex/git): commit / 分支 / diff / worktree,让 Codex 放心改。 - [多代理、Subagents 与 Worktrees](https://docs.passion8.cc/docs/codex/subagents-worktrees): 把探索、审查、测试和后台实现拆到独立代理或 worktree。 - [Review、GitHub 与 PR 工作流](https://docs.passion8.cc/docs/codex/review-github): 本地 /review、App Review pane、GitHub PR review 和 CI review。 - [高阶玩法](https://docs.passion8.cc/docs/codex/tips): Profile、非交互 exec、审批沙箱进阶。 ## 平台、自动化与企业 - [自动化与云端运行](https://docs.passion8.cc/docs/codex/automation): 定期巡查项目;了解云端运行接不了 Passion8 的边界。 - [非交互、CI 与 SDK](https://docs.passion8.cc/docs/codex/noninteractive-ci-sdk): codex exec、GitHub Actions、App Server、SDK 和自动化密钥。 - [平台与集成](https://docs.passion8.cc/docs/codex/platforms-integrations): CLI、App、IDE、Web、Slack、Linear、GitHub、Sites 和远程连接。 - [Browser 与 Computer Use](https://docs.passion8.cc/docs/codex/browser-computer-use): in-app browser、Chrome、桌面控制、Record & Replay 和安全边界。 - [企业与治理](https://docs.passion8.cc/docs/codex/enterprise-governance): RBAC、managed config、access tokens、审计、Windows 和网关治理。 - [官方覆盖地图](https://docs.passion8.cc/docs/codex/official-coverage-map): Codex 官方 manual 在本站的中文聚合映射和维护口径。 - [常见问题](https://docs.passion8.cc/docs/codex/troubleshooting): 认证、/v1、Responses 接口排查。 还没注册或没余额?先看 [快速开始](https://docs.passion8.cc/docs/quickstart) 与 [充值与账单](https://docs.passion8.cc/docs/billing)。 ## 主题与外观 想调整 Codex 桌面客户端的外观，可以浏览 [DreamSkin 主题库与创作社区](https://dreamskin.cc/gallery?utm_source=passion8&utm_medium=referral&utm_campaign=community&utm_content=codex_guide)。在浏览器预览作品后，按 DreamSkin 的说明安装兼容主题，也可以制作和分享自己的作品。Passion8 是项目赞助商；主题功能与 API 接入互相独立，使用主题不要求注册 Passion8。 首次接入请先完成 [快速开始](https://docs.passion8.cc/docs/quickstart)，费用口径见 [充值与账单](https://docs.passion8.cc/docs/billing)。遇到鉴权或模型错误，先看 [常见问题](https://docs.passion8.cc/docs/faq) 与 [Codex 故障排查](https://docs.passion8.cc/docs/codex/troubleshooting)。