678APIdocs
https://www.678api.com/v1
Codex CLI

在 Codex CLI 中使用 678API

在 Codex 的 config.toml 中添加 678API 自定义模型供应商，并通过环境变量提供 API Key。

获取 Codex CLI

OpenAI 官方工具

Codex CLI

在终端中运行的编码智能体，可通过 npm 安装，并在配置文件中添加 678API 自定义模型供应商。

支持平台
macOS / Linux / Windows
安装方式
npm install -g @openai/codex
官方安装文档查看安装命令

安装或更新

text
npm install -g @openai/codex
codex --version

配置 API Key

text
export API678_API_KEY="YOUR_API_KEY"

如需长期使用，可将这行加入 ~/.zshrc 或 ~/.bashrc，然后重新打开终端。

配置自定义供应商

编辑 ~/.codex/config.toml：

text
model = "MODEL_ID_FROM_CONSOLE"
model_provider = "api678"

[model_providers.api678]
name = "678API"
base_url = "https://www.678api.com/v1"
env_key = "API678_API_KEY"
wire_api = "responses"
模型名称

将 MODEL_ID_FROM_CONSOLE 替换为 678API 控制台展示的完整模型 ID。Codex 自定义供应商使用 Responses 协议。

启动与验证

text
cd /path/to/your/project
codex
  • 启动后确认顶部模型名称与配置一致。
  • 出现 401 时检查 echo $API678_API_KEY 是否为空。
  • 出现 model not found 时复制控制台中的完整模型 ID。
  • 如果当前线路不支持 Responses API，请在控制台更换支持 Codex 的模型或线路。
安全建议

不要把真实 API Key 直接写进 config.toml 或项目仓库；使用 env_key 从环境变量读取。

需要退出 ChatGPT 账号吗？

不需要。model_provider = "api678" 会让当前配置使用 678API。恢复官方服务时改回原来的 model_provider 和模型，或使用备份配置，并重启 Codex。

© 2026 678API · AI API Gateway Documentation