← Back to learning path
Chapter · Published

Codex desktop app workspace overview

Learn how chats, projects, local folders, permissions, Skills, plugins, Automations, and settings fit together in Codex.

Source: start/05-app-overview.md快速上手 (original language)
Chapter progress 0%Learning path progress 0% · 0/46 chapters completedContinue learning path →

Tip · Last checked

Official references were checked on 2026-10-12: desktop app, projects and chats, settings, Skills and plugins, Automations, and agent approvals and security.

Tip · Screenshot orientation

Codex changes quickly. If a button name or position differs from a screenshot, follow the current client and OpenAI official documentation.

Warning · Start with smaller permissions

Keep the default permissions for a first run. Open network, files outside the workspace, or computer-control access only when the task needs it. Full access removes limits but increases the risk of mistakes and sensitive-data exposure.

Warning · Limit unattended tasks

Scheduled tasks run with the default sandbox settings. Use the smallest permission set that completes the task and open network or broader file access only when necessary. Running background tasks with full access carries more risk.

Tip · Settings suggestion

Keep the defaults while learning. If a local task must run for a long time, enable “Prevent sleep while running”; adjust other options to your workflow.

Warning · Do not store sensitive information

Do not put passwords, API keys, identity numbers, or other sensitive data in personal instructions or memory.

Warning · Grant computer access carefully

Codex may see web accounts and files on the computer. Grant only the access needed for the current task and turn it off when it is no longer needed.

Tip · New user suggestion

Choose Local when starting out. After you understand Git branches, use Worktree to handle multiple tasks at once. See the official Worktrees documentation for more detail.

Codex desktop app workspace overview

ChatGPT and Codex

The desktop app can switch between ordinary ChatGPT conversations and Codex tasks. ChatGPT is useful for discussion; Codex is designed to inspect, create, and change files in a workspace.

Chats, projects, and local folders

  • A chat is a focused conversation without shared project context.
  • A ChatGPT project groups chats, files, instructions, and connected sources.
  • A local project gives Codex access to one or more folders on this computer.

Choose a local project when several tasks need the same files and conventions. Use a one-off chat for a small, disposable question. Confirm the folder before granting access.

Task controls and permissions

Before sending a task, review the selected model, attached context, workspace, and permission mode. Start with the smallest permission that can complete the job. Keep destructive commands, credentials, production data, and network access behind an explicit review step.

Skills, plugins, and MCP

Skills package repeatable instructions. Plugins and MCP connections add external tools or data sources. Read the tool scope before enabling one and avoid sending private files to an unrelated service.

Automations and settings

Scheduled tasks should have a narrow scope, a bounded runtime, and a clear failure path. In Settings, review notifications, instructions, memories, browser or computer access, Git configuration, and worktree behavior. Store no secrets in reusable instructions.

A safe first setup

  1. Open a local folder with a disposable change.
  2. Ask Codex to read the repository and explain the test command.
  3. Use read-only or approval-required permissions first.
  4. Inspect the diff and command output before accepting a change.

Next step

Continue with the first Codex task.

Reference screenshots

Reference screenshot

Reference screenshot

Reference screenshot

Reference screenshot

Reference screenshot

Reference screenshot

Reference screenshot

Reference screenshot

Reference screenshot

Reference screenshot

Reference screenshot

Reference screenshot

Reference screenshot

Reference screenshot

Reference screenshot

Reference screenshot

Reference screenshot

Reference screenshot

Reference screenshot

Reference screenshot

Reference screenshot

Reference screenshot

Reference screenshot

Reference screenshot

  • ../advanced/03-skills-plugins-mcp.md

  • ../advanced/12-memories.md

  • ../advanced/13-computer-history.md

Further reading

KnowledgeAI Agents: From Core Concepts to ProductionKnowledgeRAG for Enterprise Knowledge: Architecture and Practice
Product Hub Demo · V0.3