金山云-文档中心-星流API接入Codex

星流平台

查看更多结果

未找到含当前关键字的文档标题

页面目录

全部展开全部收起

产品更新动态

未找到含该关键词的产品

文档中心

星流平台

模型API服务

最佳实践

星流API接入Codex

最近更新时间：2026-10-14 15:40:56



适用范围：在 macOS 或 Windows 上，让本地 Codex 使用金山云星流 API，同时尽量保留Skills、插件市场等能力。

总览

三种方案	特点
配置 `config.toml`	稳定；需配置环境变量；需保证使用支持 Responses API的星流模型
CC Switch配置工具	支持Response/Chat两种协议的转发
Codex++管理器	同上，同时提供强大的桌面管理功能（模型、插件、会话、诊断等）

账号问题
- 本地skill/带MCP手动配置的插件，不需要chatgpt官方账号，正常配置星流API即可
- 官方插件市场（依赖 ChatGPT 工作区、OpenAI 云服务或特定 OAuth 的插件）依赖chatgpt官方账号，如需要使用，则需按本教程“保留账号”部分配置
  - 模型请求走星流key，但官方skill和插件扣除原gpt账号额度
  - 官方登录只能提高可用概率，不能保证每个插件都与第三方模型兼容。
  - 接入外部 API 后，Codex 里可能仍显示原来的 ChatGPT 账号，这是正常的
接入前准备
- API Key
- 调用地址https://kspmas.ksyun.com/v1
- 准确模型 ID
- 确认模型是否支持response协议

方案 A：使用 Codex 原生配置

介绍

直接修改 Codex 自带的 config.toml，把默认供应商从 OpenAI 改为星流，并通过环境变量提供星流 API Key。之后 Codex 会直接把请求发送到星流地址。

不支持协议转换
原来登录了chatgpt账号则自动保存登录状态

配置步骤

写入配置

打开用户级配置文件：

macOS：~/.codex/config.toml
Windows：%USERPROFILE%\.codex\config.toml

把以下内容替换文件顶部的已有配置。

model = "mog-8-t"
model_provider = "starflow"

[model_providers.starflow]
name = "Kingsoft StarFlow"
base_url = "https://kspmas.ksyun.com/v1"
env_key = "KSC_API_KEY"  # 不明文写入key，要先设置环境变量，然后将环境变量名称传入此处
wire_api = "responses"   # 需保证

⚠️注意：

供应商配置必须放在用户级 ~/.codex/config.toml，不能放到项目里的 .codex/config.tomlOpenAI：配置参考
Codex 原生只会发送 responses 格式请求；只能配置支持 Responses的星流模型。
不要设置 requires_openai_auth = true。该项会让 Codex 使用 OpenAI 登录凭证，并忽略 env_key。

macOS 设置环境变量

仅使用 Codex CLI 时，把下面一行加入 ~/.zshrc：

export KSC_API_KEY="星流API Key"

执行：

source ~/.zshrc
test -n "$KSC_API_KEY" && echo "KSC_API_KEY 已生效"

重启 Codex

Windows 设置环境变量

只对当前 PowerShell 窗口生效：

$env:KSC_API_KEY = "星流API Key"

长期写入当前 Windows 用户环境：

[Environment]::SetEnvironmentVariable("KSC_API_KEY", "星流API Key", "User")

重启 Codex。OpenAI：环境变量

方案 B：使用 CC Switch

介绍

CC Switch 是一个第三方配置切换工具。可自动修改 Codex 的供应商配置。

如果模型只支持 Chat Completions，CC Switch 可启动本地代理，把 Codex 的 Responses 请求转换成 Chat 请求后再转发给星流。
保留原 ChatGPT 登录状态：可将官方登录留在 auth.json，把第三方供应商写入 config.toml。CC Switch：保留官方登录指南