Codex CLI 简介1.1 什么是 Codex CLI?定位与 Claude Code 一样。Codex CLI是由 OpenAI 开发的开源系统级 AI 助手使用 Rust 语言编写具有极高的性能和效率。它可以在终端中读取、修改和运行代码是一个真正意义上的 AI Agent。核心特性:特性说明Rust 原生构建极速启动和响应内存占用极低开源完全开源社区驱动代码透明可审计多模型支持原生支持 OpenAI、Ollama、LM Studio、Amazon Bedrock也可自定义接入任意兼容 APIChatGPT 认证支持 ChatGPT Plus/Pro/Business/Edu/Enterprise OAuth 登录不一定要 API Key多级 SandboxmacOS Seatbelt、Linux bubblewrap、Windows 原生沙箱平台级安全保障MCP 协议通过 Model Context Protocol 连接任意外部工具和服务多 Agent 协作内置 Subagent 系统支持并行任务委派Skills Plugins可复用的工作流技能包和可分发的插件系统内置记忆系统跨会话的 Memory 机制自动提取和整合项目知识二、安装与配置2.1 系统要求平台要求macOS12 (Monterey 及以上)LinuxUbuntu 20.04 / Debian 10WindowsWindows 10/11 (原生 PowerShell 沙箱或 WSL2)RAM最低 4 GB推荐 8 GBGit2.23 (可选用于版本控制功能)2.2 安装 Codex CLI方式一npm 全局安装推荐:npm i -g openai/codex方式二Homebrew 安装macOS:brew install --cask codex方式三从 GitHub Releases 下载二进制文件:前往 openai/codex 的 Releases 页面下载对应平台的预编译二进制文件。方式四从源码构建Rust/Cargo:git clone https://github.com/openai/codex.git cd codex cargo build --release 仓库中还提供了justfile包含构建和测试的辅助命令。验证安装:codex --version # 或 codex -V # 查看帮助 codex --help升级 Codex CLI:npm i -g openai/codexlatest # 或 codex update2.3 认证配置Codex CLI 支持三种认证方式方式一ChatGPT OAuth 登录默认最简单这是最推荐的方式不需要 API Key只要有 ChatGPT 订阅即可。# 首次运行 codex 时自动触发 OAuth 登录流程 # 也可以手动登录 codex login # 支持的订阅类型 # - ChatGPT Plus # - ChatGPT Pro # - ChatGPT Business # - ChatGPT Edu # - ChatGPT Enterprise登录后凭证保存在本地后续使用无需重复登录。登出:codex logout # 或在交互式会话中 /logout凭证存储方式配置cli_auth_credentials_store:存储方式说明file存储在本地文件keyring使用系统密钥链macOS Keychain/Linux Secret Service/Windows Credential Managerauto自动选择默认方式二API Key# Linux/macOS export OPENAI_API_KEYsk-your-api-key # 永久配置 echo export OPENAI_API_KEYsk-your-api-key ~/.bashrc source ~/.bashrc# Windows PowerShell永久配置 [System.Environment]::SetEnvironmentVariable(OPENAI_API_KEY, sk-your-api-key, User)方式三通过 stdin 传入 Access Tokenecho your-access-token | codex2.4 配置第三方模型供应商Codex CLI 原生支持多种模型供应商。内置供应商这部分我没这么用过内容只做参考这里只做资料收集整理供应商 ID说明认证方式openaiOpenAI API默认OPENAI_API_KEY环境变量ollama本地模型Ollama无需 Key自动连接本地 Ollama 服务lmstudio本地模型LM Studio无需 Key自动连接本地 LM Studio 服务amazon-bedrockAWS Bedrock 托管模型AWS Profile Region快速接入本地开源模型使用--oss标志可以一键配置本地开源模型# 自动检测并连接本地 Ollama 或 LM Studio codex --oss在配置文件中指定默认本地供应商# ~/.codex/config.toml oss_provider ollama # 或 lmstudio自定义第三方供应商注关于第三方模型兼容性限制有一点需要强调的是Codex CLI 使用的 API 协议规范与 OpenAI 的行业标准 API 协议规范不一样Codex CLI 使用的是 Responses API 协议而非行业标准的 Chat Completions API。所以会有小伙伴发现将 DeepSeek、Kimi 等第三方模型的官方提供 OpenAI 标准规范的接口接入 Codex CLI 仍然无法正常工作就是这个原因API 在协议层面不兼容。维度Chat Completions行业标准Responses API仅 Codex 支持端点POST /v1/chat/completionsPOST /v1/responses请求格式messages: [...]input: [...]toolsinstructions行业支持几乎所有供应商都实现OpenAI 支持从时间线上看 2026 年 2 月起 Codex CLI 就完全移除 Chat Completions 支持wire_api仅支持responses。所以无论怎么配置base_urlCodex 发出的请求都是 Responses API 格式而 DeepSeek、Kimi、GLM、Qwen 等第三方供应商官方支持的 API 只有 Chat Completions 端点无法理解和处理这种请求。另一方面Claude Code 使用的是 Anthropic Messages API第三方供应商已经实现了对该协议的兼容例如直接提供https://api.deepseek.com/anthropic端点所以 cc-switch 换个 URL 就能生效。而 Codex CLI 的问题在于协议格式对不上供应商未支持所以换 Chat Completions 协议的地址依旧无法使用。邪修方案如果确实需要 Codex CLI 第三方模型可以使用本地代理GitHub 上有类似的开源项目比如 codeproxy-ai/cli但该项目我未实际试用过仅作参考在中间做协议转换将 Codex 发出的 Responses API 请求转换为 Chat Completions 格式再转发给第三方供应商。通过这种方式配置model_providers配置块可以接入任意兼容 OpenAI Responses API 的服务。# 启动本地代理 npx codeproxy/cli --upstream-format openai-chat \ --base-url https://api.deepseek.com/v1 \ --apikey sk-your-deepseek-key# 然后在 Codex 配置中指向本地代理 [model_providers.deepseek] name DeepSeek base_url http://127.0.0.1:8787/v1 # 指向本地代理而非 DeepSeek 官方地址 env_key DEEPSEEK_API_KEY wire_api responses自定义供应商完整参数:参数说明base_urlAPI 基础地址env_key存放 API Key 的环境变量名name供应商显示名称wire_api协议类型目前仅支持responseshttp_headers静态 HTTP 请求头env_http_headers从环境变量读取的 HTTP 请求头query_params额外查询参数request_max_retriesHTTP 重试次数默认 4stream_idle_timeout_msSSE 空闲超时默认 300000msstream_max_retriesSSE 重试次数默认 5supports_websockets是否支持 WebSocket 传输配置示例一个比较完整的~/.codex/config.toml配置示例展示如何同时配置多个供应商并使用自定义供应商作为默认#:schema https://developers.openai.com/codex/config-schema.json
