📝 Codex Desktop 桌面端完全指南：安装、中文设置与 cc-switch 使用教程

15 次浏览次阅读

📝 Codex Desktop 桌面端完全指南：安装、中文设置与 cc-switch 使用教程

前言

2026 年，OpenAI 正式推出了 Codex Desktop App（桌面客户端），这是一款面向开发者的 AI 编程桌面工具。与此同时，cc-switch 作为一款管理多款 AI CLI 工具配置的神器，也备受关注。

本文将为你详细介绍：

Codex Desktop 的下载与安装（Windows / macOS）
配置 API Key
中文界面设置方法
基本使用方法
cc-switch 的安装与使用

一、Codex Desktop App 是什么？

Codex Desktop App 是 OpenAI 推出的 AI 编程桌面工具。官方将其定义为：「一个用于管理 AI 编程代理（agents）的开发工作中心」。

它的核心特点：

支持多个 AI Agent 同时工作 — 你可以同时运行多个编程代理
独立 Workspace — 每个任务拥有独立的工作空间
代码 Diff 查看 — 清晰看到 AI 修改了哪些代码
自动化任务执行 — AI 可以像开发代理一样自动完成开发流程
Computer Use 功能 — 通过 AI 控制你的电脑执行操作（如打开浏览器、读取文档等）

简单理解：AI + IDE + 自动化开发助手 三位一体。

截止目前，Codex Desktop 已支持 macOS 和 Windows 平台。

二、Codex Desktop 下载与安装

macOS 用户

macOS 用户可以通过 App Store 下载安装：

1. 打开 Mac App Store

2. 搜索「Codex」

3. 点击下载并安装

系统要求：

macOS 14.0+（Sonoma 或更新版本）
需要 Apple Silicon 芯片（M1/M2/M3/M4），Intel Mac 暂不支持

Windows 用户

Windows 版于 2026 年 3 月正式发布，可通过 Microsoft Store 下载：

官方下载地址：https://apps.microsoft.com/detail/9plm9xgg6vks
打开后点击「获取 / 下载」
按照提示完成安装

系统要求：

Windows 10 19041+ 版本
需要网络连接

CLI 版本安装

如果你偏好命令行操作，也可以使用 Codex CLI：

npm i -g @openai/codex

三、API Key 配置

安装完成后，打开 Codex Desktop，你可能会发现无法直接使用——因为需要配置 API Key。

方法一：官方 API Key

1. 登录 OpenAI 平台：https://platform.openai.com

2. 进入 API Keys 页面创建一个新的 API Key

3. 复制生成的 Key（以 sk- 开头）

方法二：第三方 API 平台

对于国内用户，也可以使用第三方代理平台提供的 API（例如 https://codex.dakeai.cc 等）

配置方式

Windows 用户（通过 PowerShell）：

setx OPENAI_API_KEY " 你的 API_KEY"

macOS / Linux 用户：

export OPENAI_API_KEY=" 你的 API_KEY"

配置完成后，重新打开 Codex App，输入一句「hello」，如果能正常回复则说明配置成功。

四、中文界面设置

Codex Desktop 默认界面为英文。如需切换为中文，请按以下步骤操作：

1. 打开 Codex Desktop

2. 点击左上角 File → Settings

3. 进入 General 标签页

4. 找到 Language for the app UI 选项

5. 选择 Chinese (China)

设置后界面应自动切换为中文。如果选择后未生效，原因可能是：

软件需要联网下载语言包
可以尝试重启软件
或者在网络工具开启后再切换一次

⚠️ 已知问题：部分版本存在 UI 本地化不完全的 Bug（GitHub Issue #19518、#17309），切换中文后顶部菜单栏和侧边栏可能仍显示英文。OpenAI 正在逐步完善本地化覆盖，预计后续版本会修复。

五、Codex Desktop 基本使用方法

核心操作流程

使用 Codex Desktop 非常简单——你只需要给它一个 任务目标：

1. 打开 Codex Desktop

2. 输入你要完成的任务描述

3. Codex 会自动分析并开始执行

4. 你可以查看代码 diff，接受或拒绝修改

常见使用场景

🖥️ 写代码

写函数、脚本、前端页面
写后端 API 接口
从零搭建项目框架

🔧 修改项目代码

新增功能
代码重构
性能优化

🐛 查 Bug

把报错信息、日志或代码发给 Codex，它会分析问题并给出修复方案。

✅ 写测试

单元测试
集成测试
端到端测试

📄 写技术文档

README
接口文档
设计文档
中英文翻译

🤖 自动化开发任务

Codex 可以像 AI Agent 一样工作，自动完成：

Bug 整理
日报生成
项目部署

💻 Computer Use 功能

Codex 支持 Computer Use（电脑操控），可以让 AI 直接操控你的电脑——打开浏览器查询信息、读取本地文档、操作文件系统等。详细信息可查看官方文档：

https://developers.openai.com/codex/app/computer-use

六、cc-switch 使用教程

cc-switch 是什么？

cc-switch 是一款跨平台桌面应用 / CLI 工具，用于 统一管理多款 AI CLI 工具的配置，包括：

Claude Code（Anthropic）
Codex CLI（OpenAI）
Gemini CLI（Google）
OpenCode（开源）
OpenClaw（开源）

一句话总结：想在 CLI 里极致玩转多模型、多 API 提供商的朋友，cc-switch 几乎是必装工具。

项目地址：https://github.com/SaladDay/cc-switch-cli

当前版本：v5.7.0+（持续更新中）

GitHub Star 数：14.5K+

核心功能

功能	说明
Provider 管理	一键切换 API 地址和 Key，内置 50+ 预设提供商
MCP Server 管理	统一管理各 CLI 工具的 MCP 服务器
Skills 管理	安装社区技能扩展 CLI 能力
系统提示词管理	Markdown 编辑器 + 跨应用同步
会话浏览器	查看和恢复对话历史
云端同步	支持 Dropbox、OneDrive、iCloud、WebDAV
本地代理	热切换、自动故障转移、熔断保护
配置备份	自动保留最近 10 个版本

安装方法

桌面版安装

macOS：

brew install --cask cc-switch

或从 GitHub Releases 下载 DMG 安装包。

Windows：

从 GitHub Releases 下载 MSI 安装包或 Portable ZIP 版本。

Linux：

# Debian/Ubuntu
sudo dpkg -i cc-switch_*.deb

# Arch Linux
paru -S cc-switch-bin

AppImage 和 Flatpak 也支持。

CLI 版安装

cc-switch 提供了功能更加丰富的 CLI 版本（支持 TUI 界面）：

macOS / Linux（推荐使用 Homebrew）：

brew install SaladDay/tap/cc-switch-cli

所有平台通用安装：

从 GitHub Releases 页面下载对应平台的压缩包：

macOS Universal: cc-switch-cli-v5.7.0-darwin-universal.tar.gz
Windows x64: cc-switch-cli-v5.7.0-windows-x64.zip
Linux x64: cc-switch-cli-v5.7.0-linux-x64.tar.gz

💡 macOS 提示：如遇「无法验证开发者」，执行：xattr -cr ~/.local/bin/cc-switch

百度网盘下载

docs.apiyi.com 等平台也提供了百度网盘下载链接，方便国内用户。

快速上手

第一步：打开 cc-switch

安装后启动 cc-switch，打开桌面应用程序。

第二步：添加 Provider

1. 进入 Provider 管理页面

2. 点击 Add Provider

3. 选择或自定义 API 提供商

4. 填写：名称、API 地址、API Key、 模型名称

5. 点击「Enable」启用

启用后，cc-switch 会自动将配置写入对应 CLI 工具的配置文件（如 ~/.codex/、~/.claude/ 等）。

cc-switch 内置了 50+ 预设提供商，包括：

OpenAI 官方
Anthropic 官方
Google Gemini 官方
AWS Bedrock
NVIDIA NIM
以及各类第三方中转平台

第三步：一键切换

配置好多个 Provider 后，你可以：

桌面版：右键系统托盘图标，一键切换
CLI 版：cc-switch switch 命令切换
CLI TUI 模式：cc-switch tui 进入交互式界面

切换后，所有关联的 CLI 工具（Claude Code、Codex 等）会自动使用新配置，无需手动改文件。

CLI 版本常用命令

# 列出所有 Provider
cc-switch provider list

# 切换 Provider
cc-switch provider set <provider-name>

# 针对特定应用（如 Codex）管理
cc-switch --app codex provider list

# 进入 TUI 交互模式
cc-switch tui

# 导出一个 Provider 为独立配置
cc-switch provider export <provider-name>

# 健康检查（测试 API 连通性）cc-switch provider check <provider-name>

# 同步 MCP 服务器配置
cc-switch mcp sync --app codex

# 启用本地代理路由
cc-switch proxy enable

重要提示

1. 环境变量冲突：如果你在系统环境变量中设置了 ANTHROPIC_API_KEY、OPENAI_API_KEY 等，它们会覆盖 cc-switch 的配置

2. CLI 更新：如果通过 Homebrew 安装了 cc-switch-cli，请避免使用内置的更新功能，以免影响 Homebrew 自身

3. macOS 权限：如果系统提示「无法验证开发者」，执行 xattr -cr 命令解除隔离

七、总结

Codex Desktop 快速上手三步骤

1. 下载安装 — 通过 App Store（Mac）/ Microsoft Store（Win）安装

2. 配置 API Key — 设置 OPENAI_API_KEY 环境变量

3. 设置中文 — File → Settings → General → 选择 Chinese (China)

cc-switch 的定位

cc-switch 是 AI CLI 工具的「瑞士军刀」，它可以让你摆脱频繁手动修改配置文件的痛苦，实现：

一套配置多处使用
一键切换不同模型和提供商
统一管理 MCP 服务器和技能

📝 Codex Desktop 桌面端完全指南：安装、中文设置与 cc-switch 使用教程

📝 Codex Desktop 桌面端完全指南：安装、中文设置与 cc-switch 使用教程

前言

一、Codex Desktop App 是什么？

二、Codex Desktop 下载与安装

macOS 用户

Windows 用户

CLI 版本安装

三、API Key 配置

方法一：官方 API Key

方法二：第三方 API 平台

配置方式

四、中文界面设置

五、Codex Desktop 基本使用方法

核心操作流程

常见使用场景

🖥️ 写代码

🔧 修改项目代码

🐛 查 Bug

✅ 写测试

📄 写技术文档

🤖 自动化开发任务

💻 Computer Use 功能

六、cc-switch 使用教程

cc-switch 是什么？

核心功能

安装方法

桌面版安装

CLI 版安装

百度网盘下载

快速上手

第一步：打开 cc-switch

第二步：添加 Provider

第三步：一键切换

CLI 版本常用命令

重要提示

七、总结

Codex Desktop 快速上手三步骤

cc-switch 的定位

推荐组合

相关资源