Codex CLI 安装与配置

什么是 CC Switch

CC Switch 是面向 Claude Code、Codex 等命令行工具的 Provider 切换器：把接口地址、密钥和模型统一保存在本机，一键启用或切换。

• 同时用多个模型、多个工具时，比手改环境变量和配置文件省事。
• 从控制台“API 密钥”页点“导入 CC Switch”，浏览器会直接把配置交给它。
• 不是必须的：不想安装也可以按下面的“手动配置”接入。

不用 CC Switch 也能接入

把接口地址和密钥直接写进工具自己的配置即可。密钥在控制台“API 密钥”页复制，下面的 YOUR_API_KEY 要替换成它。

环境要求

• macOS 12 及以上，Terminal 或 iTerm2
• Node.js 18 及以上

安装与接入步骤

1. 1确认 Node.js 版本

   node -v

   复制

2. 2安装 Codex CLI

   使用官方 npm 包。

   npm install -g @openai/codex

   复制

3. 3用 CC Switch 导入（推荐）

   先按“CC Switch 安装与导入”安装它，再在“API 密钥”页点“导入 CC Switch”，工具选 Codex。

不用 CC Switch 的手动配置

1. 1保存密钥到专用环境变量

   用专用变量名，不占用其他工具读取的 OPENAI_API_KEY。追加到 shell 配置里长期保存；用 bash 的话把 ~/.zshrc 换成 ~/.bashrc。

   printf '\nexport LATTICEHUB_API_KEY="YOUR_API_KEY"\n' >> ~/.zshrc
   source ~/.zshrc

   复制

2. 2追加 provider 与 profile

   先备份已有配置，再追加到 ~/.codex/config.toml（不会覆盖你原来的内容）；把 YOUR_MODEL 换成模型广场里的模型名。之后用 codex --profile latticehub 启动，不影响你原来的默认配置。

   mkdir -p ~/.codex
   cp -n ~/.codex/config.toml ~/.codex/config.toml.bak 2>/dev/null || true
   cat >> ~/.codex/config.toml <<'EOF'
   
   # LatticeHub
   [profiles.latticehub]
   model = "YOUR_MODEL"
   model_provider = "latticehub"
   
   [model_providers.latticehub]
   name = "LatticeHub"
   base_url = "https://api.latticehub.top/v1"
   env_key = "LATTICEHUB_API_KEY"
   wire_api = "responses"
   EOF

   复制