Codex + 硅基流动配置
Codex + 硅基流动配置
Section titled “Codex + 硅基流动配置”这一篇带你把 Codex 连接到硅基流动。
硅基流动和 DeepSeek、Kimi 有一个明显区别：更准确地说，它是模型平台，里面可以选择很多模型。好处是模型选择多，坏处是新手更容易选错模型名、选到未开通模型、选到不适合代码代理任务的模型。
所以本篇重点不是“填一个地址就结束”，而是教你：
先确认接口地址-> 再确认 API Key-> 再从 Models 页面选择模型名-> 再让 Codex 生成配置草稿-> 最后用只读任务验收前置教程：Codex + Kimi 配置
如果你还没有完整跑过服务商配置流程，建议先完成前置教程，再回到本篇。
依据来源：OpenAI Codex 官方手册中的 Custom model providers、
config.toml、环境变量认证说明；硅基流动官方文档中的 OpenAI 对话接口、Bearer 鉴权、模型名和 Models 页面说明。
跟着本篇做完后，你应该能做到：
- 从硅基流动官方文档确认 OpenAI 风格对话接口。
- 确认 Base URL 应该写成
https://api.siliconflow.cn/v1。 - 创建或准备硅基流动 API Key。
- 从硅基流动 Models 页面选择可用模型名。
- 把 API Key 放到 Windows 环境变量
SILICONFLOW_API_KEY。 - 让 Codex 生成配置草稿。
- 写入配置后用只读项目分析验收。
- 失败时能判断是 Key、模型名、额度、模型权限还是参数问题。
本篇不做什么
Section titled “本篇不做什么”本篇不做这些事：
- 不评测硅基流动上所有模型。
- 不推荐“唯一最佳模型”。
- 不让你把真实 API Key 发给 Codex。
- 不讲图像、语音、视频、Batch 等接口。
- 不在配置未验收前让 Codex 修改业务代码。
本篇只解决一个目标：
让 Codex 能通过硅基流动 OpenAI 风格接口正常响应，并完成一次只读项目分析。第 1 步：打开硅基流动官方文档
Section titled “第 1 步：打开硅基流动官方文档”打开官方 OpenAI 对话接口文档：
https://docs.siliconflow.cn/cn/api-reference/chat-completions/chat-completions你要确认 4 件事：
| 要确认的信息 | 官方文档示例 | 你要记下什么 |
|---|---|---|
| 接口类型 | 创建对话请求（OpenAI） | 说明它是 OpenAI 风格对话接口 |
| 请求地址 | https://api.siliconflow.cn/v1/chat/completions | Base URL 取前半段 |
| 鉴权方式 | Authorization: Bearer YOUR_API_KEY | 需要 API Key |
| 示例模型 | Pro/zai-org/GLM-4.7 | 只是示例，实际要从 Models 页面确认 |
Codex 配置里通常写 Base URL，不写完整 /chat/completions 路径。
所以本篇使用：
https://api.siliconflow.cn/v1第 2 步：打开 Models 页面选择模型
Section titled “第 2 步：打开 Models 页面选择模型”硅基流动官方文档提示，完整可用模型要看 Models 页面：
https://cloud.siliconflow.cn/models你要确认：
- 这个模型当前是否在线。
- 这个模型是否支持对话接口。
- 这个模型是否需要 Pro 版本或特殊权限。
- 你的账号是否有额度。
- 模型名要完整复制，不要自己简写。
本篇为了和官方示例保持一致，先用：
Pro/zai-org/GLM-4.7但这只是示例模型。你实际配置时，可以换成自己在 Models 页面确认可用的模型。
第 3 步：理解模型名为什么容易错
Section titled “第 3 步：理解模型名为什么容易错”硅基流动上的模型名可能长这样：
Pro/zai-org/GLM-4.7deepseek-ai/DeepSeek-V3.2Qwen/Qwen3-32B不要把它们改短。
比如不要把：
Pro/zai-org/GLM-4.7随手改成：
GLM-4.7模型名必须完整复制官方 Models 页面或接口文档里的值。
如果模型名错了，常见结果是：
- 模型不存在。
- 无权限。
- 请求失败。
- 切到了你没预期的模型。
第 4 步：准备硅基流动 API Key
Section titled “第 4 步：准备硅基流动 API Key”进入硅基流动控制台：
https://cloud.siliconflow.cn/你要做：
- 登录账号。
- 找到 API Key 管理入口。
- 创建一个新的 API Key。
- 复制 API Key。
- 保存到安全位置。
- 确认账号有可用额度。
不要把 API Key 放到这些地方：
- 不要发给 Codex。
- 不要写进 Markdown。
- 不要发到微信。
- 不要截图露出完整 Key。
- 不要提交到 Git。
第 5 步：设置 Windows 环境变量
Section titled “第 5 步：设置 Windows 环境变量”本篇建议环境变量名：
SILICONFLOW_API_KEY方法 A：用 Windows 图形界面设置
Section titled “方法 A：用 Windows 图形界面设置”适合新手。
操作步骤：
- 按
Win键。 - 搜索
环境变量。 - 打开“编辑系统环境变量”。
- 点击“环境变量”。
- 在“用户变量”区域点击“新建”。
- 变量名填写：
SILICONFLOW_API_KEY- 变量值填写你的真实硅基流动 API Key。
- 点击确定。
- 关闭所有设置窗口。
- 关闭当前 PowerShell。
- 重新打开一个新的 PowerShell。
方法 B：用 PowerShell 设置
Section titled “方法 B：用 PowerShell 设置”适合熟悉 PowerShell 的用户。
打开 PowerShell，运行：
setx SILICONFLOW_API_KEY "你的真实硅基流动 API Key"注意：
- 引号里替换成你的真实 Key。
- 执行后关闭当前 PowerShell。
- 重新打开 PowerShell 才能读到新变量。
第 6 步：验证环境变量能读取
Section titled “第 6 步：验证环境变量能读取”重新打开 PowerShell 后运行：
$env:SILICONFLOW_API_KEY如果能看到一串 Key，说明环境变量能读到。
截图时一定要遮住输出。
如果没有输出，先不要继续配置 Codex。
按顺序检查：
- 变量名是不是
SILICONFLOW_API_KEY。 - 设置后有没有重开 PowerShell。
- API Key 有没有复制完整。
- 你是不是在另一个 Windows 用户里启动了 Codex。
第 7 步：让 Codex 生成配置草稿
Section titled “第 7 步：让 Codex 生成配置草稿”打开 Codex。
先不要让它直接写文件。
把下面这段复制给 Codex：
我准备把 Codex 连接到硅基流动的 OpenAI 风格对话接口。
我已经从硅基流动官方文档确认：- 请求地址：https://api.siliconflow.cn/v1/chat/completions- base_url 应写成：https://api.siliconflow.cn/v1- model：Pro/zai-org/GLM-4.7- API Key 环境变量名：SILICONFLOW_API_KEY
要求：1. 先不要修改任何文件。2. 不要让我把真实 API Key 发给你。3. 请根据当前 Codex 官方配置方式，给出 config.toml 配置草稿。4. provider_id 使用 siliconflow。5. 配置里只能写环境变量名，不能写真实 API Key。6. 请解释每一行配置是什么意思。7. 请特别说明是否需要 wire_api 字段；如果你不确定，请写“不确定”，不要编。8. 请提醒我模型名必须从硅基流动 Models 页面完整复制。你希望 Codex 给出的草稿大概像这样：
model = "Pro/zai-org/GLM-4.7"model_provider = "siliconflow"
[model_providers.siliconflow]name = "SiliconFlow"base_url = "https://api.siliconflow.cn/v1"env_key = "SILICONFLOW_API_KEY"重点检查：
model是你从 Models 页面确认的完整模型名。model_provider是siliconflow。[model_providers.siliconflow]和model_provider对得上。base_url是https://api.siliconflow.cn/v1，不是完整/chat/completions。env_key是SILICONFLOW_API_KEY，不是你的真实 Key。- 没有乱加你看不懂的字段。
关于 wire_api 的说明
Section titled “关于 wire_api 的说明”硅基流动官方文档提供的是 OpenAI 风格 Chat Completions 接口。
OpenAI Codex 官方手册说明自定义 provider 涉及 Base URL、wire API、认证和可选请求头；当前手册示例里的 wire_api 注释为 responses，并标注这是支持值。
所以本篇继续采用保守做法：
不要自己随便加 wire_api。先让 Codex 根据当前版本解释是否需要。最终用只读任务验收能不能跑通。如果 Codex 要加 wire_api = "chat"，你要追问：
请说明你添加 wire_api = "chat" 的依据来自哪里。当前 Codex 官方手册是否支持这个值？如果没有明确依据，请不要添加。第 8 步：让 Codex 写入配置
Section titled “第 8 步：让 Codex 写入配置”确认配置草稿没问题后，再发：
我确认硅基流动配置草稿可以继续。
请把 siliconflow provider 写入 Codex 用户级配置文件。
要求：1. 修改前先告诉我目标配置文件路径。2. 只修改 Codex 配置文件。3. 不要写入真实 API Key。4. 只写入 env_key = "SILICONFLOW_API_KEY"。5. 如果配置文件不存在，请先说明将创建哪个文件。6. 修改后展示 diff。7. 用中文解释每一处变化。8. 不要修改业务项目文件。Windows 上 Codex 用户级配置一般位于：
C:\Users\你的用户名\.codex\config.toml也可以理解成：
~\.codex\config.toml如果你设置过 CODEX_HOME，让 Codex 先解释实际路径。
第 9 步：重启 Codex
Section titled “第 9 步：重启 Codex”配置文件和环境变量改完后，建议重新启动。
操作顺序：
- 退出当前 Codex。
- 关闭当前 PowerShell。
- 重新打开 PowerShell。
- 进入练习项目目录。
- 重新启动 Codex。
这样可以确保新环境变量和新配置都被读取。
第 10 步：做最小对话验证
Section titled “第 10 步：做最小对话验证”进入 Codex 后，先发：
请只用一句中文回复：硅基流动配置验证开始。如果能正常回复，说明模型调用链路有机会是通的。
如果这里失败，不要继续项目操作，先看错误信息。
第 11 步：做只读项目验证
Section titled “第 11 步：做只读项目验证”最小对话能回复后，再做项目只读验证。
复制这段给 Codex：
请只读分析当前项目，不要修改任何文件，不要创建文件，不要删除文件。
请按下面格式输出：
## 1. 响应状态- 你是否能正常响应：- 如果你能判断，本次使用的模型/provider 是什么：- 如果不能判断，请写“不能判断”：
## 2. 当前项目- 当前目录：- 是否像项目根目录：- 判断依据：
## 3. 只读检查- 你查看了哪些文件或目录：- 有没有运行只读命令：- 有没有修改文件：
## 4. 硅基流动配置提醒- 当前模型名是否像从 Models 页面完整复制：- 如果模型不存在，应该先查哪里：- 如果账号无额度或模型未开通，应该先查哪里：
## 5. 下一步建议- 如果配置正常，下一篇应该做什么：- 如果配置异常，先查哪 3 件事：你希望看到：
- Codex 能正常输出。
- 它能读到当前项目路径。
- 它没有修改文件。
- 它能提醒模型名必须完整复制。
- 它能说明不确定的地方。
第 12 步：确认没有改业务文件
Section titled “第 12 步：确认没有改业务文件”继续让 Codex 检查：
请检查当前 Git 状态，确认这次硅基流动配置验证有没有修改业务项目文件。
要求：1. 只运行只读检查。2. 不要修改任何文件。3. 如果工作区噪音较多，请列出变化文件，并说明这些变化是否和本次配置有关。如果工作区干净，本篇验收更稳。
如果有变化，先截图，再让 Codex 解释 diff，先不要提交。
问题 1：API Key 无效或 401
Section titled “问题 1：API Key 无效或 401”优先检查：
SILICONFLOW_API_KEY是否存在。- Key 是否复制完整。
- Key 是否属于当前硅基流动账号。
- 账号是否有额度。
- 是否设置后没有重开 PowerShell。
可以问 Codex：
Codex 提示 SILICONFLOW_API_KEY 相关错误。请只读检查当前环境是否能读取这个环境变量。不要显示完整 Key，只告诉我是否存在，以及长度是否大于 0。问题 2：模型不存在
Section titled “问题 2：模型不存在”优先检查：
- 模型名是否从 Models 页面完整复制。
- 是否少了
Pro/、组织名或模型名前缀。 - 模型是否下线。
- 模型是否需要额外权限。
- 当前账号是否有额度。
可以问 Codex：
硅基流动返回模型不存在或无权限。请不要修改配置，先列出我应该去硅基流动 Models 页面和控制台确认的 5 个位置。问题 3：Base URL 写成了完整接口
Section titled “问题 3：Base URL 写成了完整接口”Codex 配置里建议写：
https://api.siliconflow.cn/v1不要写成：
https://api.siliconflow.cn/v1/chat/completions如果你写了完整接口，Codex 后续再拼接路径时可能会出错。
问题 4：能聊天，但代码任务效果不稳定
Section titled “问题 4：能聊天，但代码任务效果不稳定”这不一定是配置错误。
可能原因：
- 当前模型不适合代码代理任务。
- 选的是轻量模型。
- 项目上下文太长。
- 提示词太模糊。
- 任务范围太大。
- Codex 权限范围不够。
先用只读项目分析和单文件小改动验证，不要一上来重构。
本篇验收结果
Section titled “本篇验收结果”做到这里，如果满足下面 8 条，就说明硅基流动配置教程完成：
- 你从硅基流动官方文档确认了 OpenAI 风格对话接口。
- 你确认 Base URL 使用
https://api.siliconflow.cn/v1。 - 你从 Models 页面完整复制了模型名。
- 你把 API Key 放进了
SILICONFLOW_API_KEY环境变量。 - Codex 配置文件没有出现真实 API Key。
- Codex 能正常回复一句中文验证消息。
- Codex 能完成一次只读项目分析。
- Git 状态确认没有意外业务文件变化。
下一篇学什么
Section titled “下一篇学什么”下一篇看：第一次让 Codex 阅读项目。
如果你想继续补齐国内模型系列，下一篇服务商教程可以写：Codex + 智谱 GLM 配置。
- OpenAI Codex 官方手册：
https://developers.openai.com/codex/codex-manual.md - 硅基流动创建对话请求 OpenAI 文档：
https://docs.siliconflow.cn/cn/api-reference/chat-completions/chat-completions - 硅基流动模型列表：
https://cloud.siliconflow.cn/models