桌面应用使用
桌面客户端概述
Codex 提供跨平台的桌面客户端，为用户提供更丰富的图形界面体验。桌面客户端本质上是终端应用的 GUI 封装，提供更直观的操作方式和更好的视觉体验。
macOS 桌面客户端
系统要求
- macOS 14.0（Sonoma）或更高版本
- Apple Silicon（M1/M2/M3/M4）或 Intel 芯片
- 8 GB 内存以上
安装方法
方式一：官网下载
从 Anthropic 官方网站下载最新的 .dmg 安装文件：
# 安装完成后，将应用拖入 Applications 文件夹
# 首次启动需要通过安全验证
xattr -d com.apple.quarantine /Applications/Claude Code.app
方式二：Homebrew 安装
brew install --cask claude-code
界面布局
macOS 客户端界面从上到下分为：
- 标题栏：显示当前项目名称和工作区状态
- 对话区域：主对话面板，显示与 Codex 的所有交互内容
- 输入栏：底部输入框，支持多行输入和快捷键
- 侧边栏：可隐藏的文件浏览器和对话历史面板
- 状态栏：显示连接状态、模型信息和 Token 使用量
Windows 桌面客户端
系统要求
- Windows 10 版本 1909 或更高版本
- Windows 11 支持
- 需要 WSL2 集成（推荐）
安装方法
- 从官网下载 Windows 安装程序（
.exe） - 运行安装程序，按照向导完成安装
- 启动应用后，按照引导完成首次配置
WSL2 集成
Windows 客户端需要 WSL2 支持才能充分发挥功能：
# 安装 WSL2
wsl --install -d Ubuntu
# 在 WSL2 中安装 Codex
npm install -g @anthropic-ai/claude-code
快捷键
通用快捷键
| 快捷键 | 功能说明 |
|---|---|
Cmd/Ctrl + Enter | 发送消息 |
Shift + Enter | 换行（输入框中） |
Cmd/Ctrl + K | 清除对话 |
Cmd/Ctrl + P | 打开项目文件 |
Cmd/Ctrl + , | 打开设置 |
Cmd/Ctrl + B | 切换侧边栏 |
Cmd/Ctrl + W | 关闭当前标签 |
编辑快捷键
| 快捷键 | 功能说明 |
|---|---|
Cmd/Ctrl + Z | 撤销修改 |
Cmd/Ctrl + Shift + Z | 重做修改 |
Cmd/Ctrl + S | 保存文件 |
Cmd/Ctrl + F | 搜索 |
Cmd/Ctrl + D | 选择下一个匹配项 |
主题设置
内置主题
Codex 桌面客户端内置了多种主题方案：
- Light（明亮） — 适合白天使用
- Dark（暗色） — 默认主题，护眼
- System（跟随系统） — 根据系统设置自动切换
- High Contrast（高对比度） — 辅助功能优化
自定义主题
可以在设置面板中自定义主题颜色：
{
"theme": {
"mode": "dark",
"primaryColor": "#6C5CE7",
"fontSize": 14,
"fontFamily": "JetBrains Mono, Fira Code, monospace",
"lineHeight": 1.6
}
}
更新管理
自动更新
桌面客户端默认启用自动更新，当有新版本时会：
- 在状态栏显示更新提示标记
- 点击标记查看更新内容
- 选择"立即更新"或"稍后提醒"
- 更新完成后自动重启应用
手动更新
# 检查更新
claude --version
# 更新到最新版本
npm update -g @anthropic-ai/claude-code
# 或者使用 Homebrew
brew upgrade claude-code
版本回退
如果新版本出现问题，可以回退到之前的版本：
npm install -g @anthropic-ai/claude-code@版本号
多窗口管理
桌面客户端支持多窗口操作：
- 使用
Cmd/Ctrl + N打开新窗口 - 每个窗口可独立连接不同项目
- 窗口间拖拽文件内容
- 标签页管理，一个窗口内多个对话