【AI 大模型】Codex CLI 基本用法 ② ( Codex 接入第三方大模型 | config.toml 配置 | 环境变量写入与生效 | 模型切换与连通性验证 | 交互式终端命令行界面 )

文章目录前言一、方案总览与账号准备1、三源模型清单2、需要准备的三个 API Key二、config.toml 全量配置1、配置文件位置与生效规则2、完整配置内容三、环境变量写入与生效1、写入三个 API Key2、重开终端并确认变量四、模型切换与连通性验证1、15 个 Profile 速查表2、按 Profile 启动3、curl 连通性自测4、Codex CLI 交互式终端命令行界面五、注意事项与避坑指南总结前言前文已经把 Codex CLI 完整安装到D:\001_Develop\000_Codex, 并通过CODEX_HOME把配置与会话历史全部重定向到 D 盘 ;本文在其基础上做一次 全量模型配置 :火山方舟 Coding Plan 当前可用的 12 个语言模型全部建立 Profile ,另外单独接入智谱 BigModel 按量付费的glm-5.3与glm-5.3-flash,以及 DeepSeek 官方按量付费的deepseek-v4-flash,三源合计 15 个可一键切换的模型 ; 全文配置即拷即用 , 替换成自己的 API Key 即可落地 ;一、方案总览与账号准备1、三源模型清单接入架构 :三个 API 源对应三个供应商定义 , 火山方舟走套餐 , 智谱与 DeepSeek 走按量 , 各源模型明细如下 ;火山方舟 Coding Plan ( 12 个模型共用一个 Key ) :套餐额度内调用 , 性价比最高 ;doubao-seed-2.1-pro :豆包旗舰通用 , 256k 上下文 , 适合复杂推理与长链路任务 ;doubao-seed-2.1-lite :豆包标准档 , 256k 上下文 , 质量与速度均衡 ;doubao-seed-2.0-mini :豆包极速低价档 , 256k 上下文 , 适合批量轻任务 ;doubao-seed-evolving :豆包进阶档 , 1M 上下文 , 高频持续迭代 ;deepseek-v4-pro :DeepSeek 旗舰 , 1M 上下文 , 强推理与 Agent 能力 ;deepseek-v4-flash :DeepSeek 标准档 , 1M 上下文 ;deepseek-v4.1-flash :DeepSeek 新一代标准档 , 1M 上下文 ;kimi-k2.8-preview :Moonshot 编程预览版 , 1M 上下文 , 强思考与多步工具调用 ;kimi-k2.7-code :Kimi 编程特化版 , 前端代码质量强化 ;minimax-m3 :MiniMax 旗舰 , 1M 上下文 , 编程与工具调用表现强 ;glm-5.3 :智谱旗舰 , 1M 上下文 , 默认开启思考且不可关闭 ;glm-5.3-flash :智谱极速档 , 1M 上下文 , 原生多模态 , 支持图片输入 ;智谱 BigModel 按量付费 ( 独立 Key ) :不依赖任何套餐 , 用多少付多少 ;glm-5.3 :与方舟同名模型 , 走 BigModel 开放平台官方计费 ;glm-5.3-flash :同上 , 极速档 ;DeepSeek 官方按量付费 ( 独立 Key ) :直连深度求索开放平台 ;deepseek-v4-flash :标准档 , 官方直连 , 计费与稳定性独立可控 ;2、需要准备的三个 API KeyARK_CODING_API_KEY :火山引擎 → 火山方舟控制台 https://console.volcengine.com/ark/region:cn-beijing/subscription/agent-plan → API Key 管理 → 创建 ; 需先订阅 Coding Plan 套餐 ;BIGMODEL_API_KEY :智谱开放平台 bigmodel.cn → 控制台 https://bigmodel.cn/apikey/platform → API Keys → 创建 ; 账户充值后按量扣费 ;DEEPSEEK_API_KEY :DeepSeek 开放平台 platform.deepseek.com → API Keys https://platform.deepseek.com/api_keys → 创建 ; 充值后按量扣费 ;注意 : 各平台配置文件中的模型名一律写小写 , 与控制台页面展示的大小写无关 ;二、config.toml 全量配置1、配置文件位置与生效规则配置文件路径为CODEX_HOME\config.toml, 按前文安装即D:\001_Develop\000_Codex\.codex\config.toml;Codex 仅在启动时读取一次配置 , 修改后必须重开终端会话 ;三个供应商与 15 个 Profile 全部共存于同一文件 , 互不冲突 ;2、完整配置内容直接整份替换或追加到config.toml即可 ;注意三点 :方舟 Coding Plan 的base_url是api/plan/v3而非api/v3;兼容 OpenAI 接口协议工具接口 : https://ark.cn-beijing.volces.com/api/plan/v3兼容 Anthropic 接口协议工具接口 : https://ark.cn-beijing.volces.com/api/plan智谱与 DeepSeek 走各自官方按量端点 ;智谱 : https://open.bigmodel.cn/api/paas/v4DeepSeek : https://api.deepseek.com本文全部使用env_key引用环境变量 , 配置文件内不落明文 Key ;#全局默认# 默认模型与默认供应商:缺省启动走火山方舟 GLM-5.3-Flashmodelglm-5.3-flashmodel_providerark-coding# 强制 APIKey鉴权,跳过ChatGPT账号登录 preferred_auth_methodapikeyforced_login_methodapi#供应商一:火山方舟CodingPlan[model_providers.ark-coding]nameVolcengine Ark Coding Planbase_urlhttps://ark.cn-beijing.volces.com/api/plan/v3#CodingPlan专用端点 wire_apiresponses# 新版Codex仅支持 responses env_keyARK_CODING_API_KEY# 从用户环境变量读取Key#供应商二:智谱BigModel按量付费[model_providers.bigmodel-payg]nameZhipu BigModel PayGbase_urlhttps://open.bigmodel.cn/api/paas/v4#BigModel开放平台按量端点 wire_apiresponsesenv_keyBIGMODEL_API_KEY#供应商三:DeepSeek官方按量付费[model_providers.deepseek-payg]nameDeepSeek Official PayGbase_urlhttps://api.deepseek.com#DeepSeek开放平台端点 wire_apiresponsesenv_keyDEEPSEEK_API_KEY#方舟Profile:豆包系[profiles.doubao-pro]#Doubao-Seed-2.1-pro 旗舰通用 modeldoubao-seed-2.1-promodel_providerark-coding[profiles.doubao-lite]#Doubao-Seed-2.1-lite 标准档 modeldoubao-seed-2.1-litemodel_providerark-coding[profiles.doubao-mini]#Doubao-Seed-2.0-mini 极速低价 modeldoubao-seed-2.0-minimodel_providerark-coding[profiles.doubao-evolving]#Doubao-Seed-Evolving进阶长上下文 modeldoubao-seed-evolvingmodel_providerark-coding#方舟Profile:DeepSeek系[profiles.ds41-flash]#DeepSeek-V4.1-Flashmodeldeepseek-v4.1-flashmodel_providerark-coding[profiles.ds4-flash]#DeepSeek-V4-Flashmodeldeepseek-v4-flashmodel_providerark-coding[profiles.ds4-pro]#DeepSeek-V4-Pro旗舰 modeldeepseek-v4-promodel_providerark-coding#方舟Profile:Kimi系[profiles.kimi-preview]#Kimi-K2.8-Preview预览版 modelkimi-k2.8-previewmodel_providerark-coding[profiles.kimi-code]#Kimi-K2.7-Code编程特化 modelkimi-k2.7-codemodel_providerark-coding#方舟Profile:MiniMax[profiles.minimax]#MiniMax-M3 旗舰 modelminimax-m3model_providerark-coding#方舟Profile:GLM 系[profiles.glm]# GLM-5.3旗舰,默认开启思考 modelglm-5.3model_providerark-coding[profiles.glm-flash]# GLM-5.3-Flash多模态极速 modelglm-5.3-flashmodel_providerark-coding#BigModel按量Profile[profiles.bigmodel-glm]#BigModelGLM-5.3按量 modelglm-5.3model_providerbigmodel-payg[profiles.bigmodel-glm-flash]#BigModelGLM-5.3-Flash按量 modelglm-5.3-flashmodel_providerbigmodel-payg#DeepSeek官方按量Profile[profiles.official-ds-flash]#DeepSeek官方 V4-Flash按量 modeldeepseek-flashmodel_providerdeepseek-payg[tui]screen_reader_detection_donetrue[projects.y:\000_operate\codex]trust_leveltrusted[projects.y:\000_operate\codex\001_hello]trust_leveltrusted[windows]sandboxelevated各平台的 API-KEY 需要设置到环境变量 中 ;三、环境变量写入与生效1、写入三个 API Key在 PowerShell 中执行以下命令 , 把三个 Key 写入用户级环境变量 ;引号内替换为各自平台的真实 Key ;# 三个 Key 全部走用户级环境变量 , 配置文件内不落明文[Environment]::SetEnvironmentVariable(ARK_CODING_API_KEY,填方舟CodingPlan的Key,User)[Environment]::SetEnvironmentVariable(BIGMODEL_API_KEY,填BigModel的Key,User)[Environment]::SetEnvironmentVariable(DEEPSEEK_API_KEY,填DeepSeek的Key,User)2、重开终端并确认变量环境变量写入后必须重开终端才会加载 ; 逐个确认输出非空 ;echo$env:ARK_CODING_API_KEY# 方舟 Coding Planecho$env:BIGMODEL_API_KEY# 智谱 BigModelecho$env:DEEPSEEK_API_KEY# DeepSeek 官方四、模型切换与连通性验证1、15 个 Profile 速查表Profile 名模型来源doubao-prodoubao-seed-2.1-pro火山方舟 Coding Plandoubao-litedoubao-seed-2.1-lite火山方舟 Coding Plandoubao-minidoubao-seed-2.0-mini火山方舟 Coding Plandoubao-evolvingdoubao-seed-evolving火山方舟 Coding Plands41-flashdeepseek-v4.1-flash火山方舟 Coding Plands4-flashdeepseek-v4-flash火山方舟 Coding Plands4-prodeepseek-v4-pro火山方舟 Coding Plankimi-previewkimi-k2.8-preview火山方舟 Coding Plankimi-codekimi-k2.7-code火山方舟 Coding Planminimaxminimax-m3火山方舟 Coding Planglmglm-5.3火山方舟 Coding Planglm-flashglm-5.3-flash火山方舟 Coding Planbigmodel-glmglm-5.3智谱 BigModel 按量bigmodel-glm-flashglm-5.3-flash智谱 BigModel 按量official-ds-flashdeepseek-flashDeepSeek 官方按量2、按 Profile 启动进入任意项目目录 , 用--profile参数启动对应模型 ;启动横幅中model字段显示目标模型即配置生效 ; 会话内输入/model可查看与切换 ;cd D:\你的项目目录 codex--profile glm# 方舟 GLM-5.3 旗舰codex--profile ds4-pro# 方舟 DeepSeek-V4-Procodex--profile kimi-code# 方舟 Kimi-K2.7-Codecodex--profile bigmodel-glm# BigModel GLM-5.3 按量codex--profile official-ds-flash# DeepSeek 官方 V4-Flash 按量3、curl 连通性自测在 Git Bash 中先自测两个按量源 , 返回 JSON 且含choices字段即链路正常 ;火山方舟 :Token Plan 的专用端点 , 记得带 /v3 ;curl.exe-s https://ark.cn-beijing.volces.com/api/plan/v3/chat/completions-HContent-Type: application/json-HAuthorization: Bearer$env:ARK_CODING_API_KEY-d{\model\:\glm-5.3-flash\,\messages\:[{\role\:\user\,\content\:\hi\}]}# 各参数独立成行,最后一行统一发起请求 $urlhttps://ark.cn-beijing.volces.com/api/plan/v3/chat/completions$headers{Content-Typeapplication/json;AuthorizationBearer$env:ARK_CODING_API_KEY}$body{model:glm-5.3-flash,messages:[{role:user,content:hi}]}Invoke-RestMethod-Uri$url-MethodPost-Headers$headers-Body$body智谱 BigModel :模型名按你实际开通的换 , glm-4.5-flash 是免费款 ;curl.exe-s https://open.bigmodel.cn/api/paas/v4/chat/completions-HContent-Type: application/json-HAuthorization: Bearer$env:BIGMODEL_API_KEY-d{\model\:\glm-5.3-flash\,\messages\:[{\role\:\user\,\content\:\hi\}]}# 各参数独立成行,最后一行统一发起请求 $urlhttps://open.bigmodel.cn/api/paas/v4/chat/completions$headers{Content-Typeapplication/json;AuthorizationBearer$env:BIGMODEL_API_KEY}$body{model:glm-5.3-flash,messages:[{role:user,content:hi}]}Invoke-RestMethod-Uri$url-MethodPost-Headers$headers-Body$bodyDeepSeek :curl.exe-s https://api.deepseek.com/chat/completions-HContent-Type: application/json-HAuthorization: Bearer$env:DEEPSEEK_API_KEY-d{\model\:\deepseek-flash\,\messages\:[{\role\:\user\,\content\:\hi\}]}# 各参数独立成行,最后一行统一发起请求 $urlhttps://api.deepseek.com/chat/completions$headers{Content-Typeapplication/json;AuthorizationBearer$env:DEEPSEEK_API_KEY}$body{model:deepseek-flash,messages:[{role:user,content:hi}]}Invoke-RestMethod-Uri$url-MethodPost-Headers$headers-Body$body4、Codex CLI 交互式终端命令行界面进入到 Agent 任务操作目录 , 打开 Powershell , 执行codex命令 , 进入交互式命令界面 ;输入 如下内容 :帮我在当前目录写一个 hello.py,输出当前时间点击回车 , 开始执行代码编写工作 , 等待 Codex CLI 工具执行 Agent 任务 ;执行完毕后 , 查看生成的代码如下 :五、注意事项与避坑指南现象原因处理方式401 UnauthorizedKey 错误 , 或方舟侧未订阅 Coding Plan核对环境变量名与 Key 内容 , 确认套餐已生效model not found模型名拼写或大小写不对全部改为控制台同名小写启动即报错退出wire_api被写成chat新版 Codex 仅支持responses修改配置后无变化Codex 只在启动时读一次配置重开终端会话再启动glm-5.3响应偏慢该模型默认开启思考且不可关闭追求速度切换glm-5.3-flash按量源报协议类错误供应商端 Responses 协议能力变化升级 Codex 至最新版 , 或临时改用方舟同名模型Key 泄露风险Key 属敏感凭证本文已用环境变量隔离 , 切勿把配置目录提交进代码仓库补充说明 : 方舟 12 个模型共用ark-coding一个供应商定义 , 无需为每个模型单独建供应商 ; 若后续在方舟开通按量推理 (ep-接入点 ) , 另建一个base_url为https://ark.cn-beijing.volces.com/api/v3的供应商并新增对应 Profile 即可 ;总结本文把 Codex CLI 的模型配置从单源升级为三源 15 模型 :火山方舟 Coding Plan 覆盖豆包 , DeepSeek , Kimi , MiniMax , GLM 五大系共 12 个模型 ,智谱 BigModel 与 DeepSeek 官方两个按量源单独兜底 ;核心思路是 一个供应商定义加 N 个 Profile ,三个环境变量隔离三个 Key ,一条codex --profile xxx命令完成切换 ;后续方舟模型列表更新时 , 只需按同样套路追加 Profile 即可平滑扩容 ;