Entropic Echo

主题

Codex CLI 与 App 使用指南 ​

同一页完成 Codex CLI 或 Windows Codex App 的安装、配置与启动。

步骤一：安装 ​

安装 Git ​

Codex CLI 依赖 Git。Windows 用户建议安装 Git for Windows，其他系统确保终端里可直接使用 git 即可。

下载地址 ：Git for Windows

bash
git --version

安装 Node.js ​

Codex CLI 依赖 Node.js 18+ 和 npm。

下载地址 ：Node.js LTS — 选 LTS 长期支持版。

bash
node -v && npm -v

安装 Codex CLI ​

bash
npm install -g @openai/codex

验证：

bash
codex --version

步骤二：配置 API ​

只使用 GPT 官方模型：用 CC Switch ​

当你在 Codex 中只使用 GPT 官方模型（gpt-*）时，完整配置见 CC Switch 统一配置。Codex 页面只需要确认两个特有选择：

  1. 框架选 Codex，不要选 Claude Code。
  2. 配置格式选 Codex / OpenAI，地址规则因此是 /v1；具体以 CC Switch 格式表 为准。

Codex App 配第三方模型遇到问题？

CC Switch 与 Codex++ 是两款独立软件。若要在 Codex 桌面 App 使用 DeepSeek、Claude、Gemini 等第三方模型，或任何非 GPT 官方模型，不要用 CC Switch 配置 Codex；请直接使用 Codex++ 配置 Entropic Echo。该方案只针对桌面 App。

Codex 的 Base URL 需要 /v1 后缀，与 Claude Code 不同；不要把 Claude 配置里的地址直接复制过来。

手动配置（config.toml / auth.json）仅在排障或高级自定义时使用，见 手动配置与排错。

步骤三：启动 ​

bash
codex

推理深度 ​

通过 model_reasoning_effort 控制推理深度（在 ~/.codex/config.toml 中设置）：

深度速度适用场景
low快简单代码生成、快速问答
medium中日常开发任务（推荐）
high慢复杂算法、架构设计

Codex App（Windows） ​

不想使用命令行时，可以直接通过 Windows 桌面应用接入。根据模型类型选择入口：

模型类型配置入口
GPT 官方模型（gpt-*）CC Switch 统一配置
第三方模型Codex++ 配置第三方模型

两种方案都需要先安装官方 Codex / ChatGPT App。不要把 CC Switch 的 Codex 配置与 Codex++ 混用。

深入使用 ​

页面内容
CC Switch 统一配置默认配置入口
Codex++ 配置 Entropic EchoCodex App 使用第三方模型的独立配置方案
手动配置与排错config.toml 详解、1M 上下文、常见问题
推荐工具CC Switch、AI Session Viewer