用 API Key 创建可复用认证配置
在新建 Agent 向导里填写配置名称、OPENAI_API_KEY 与 OPENAI_BASE_URL;多个对话可复用同一配置。
开始前
- 目标机器已在线,且第 1 步环境检测(codex CLI 等)通过
操作步骤
第 1 步 机器与目录
“类型”选 Codex,选好在线机器和工作目录。环境检测(codex CLI、守护进程、SQLite 等)必须全部通过才能进入下一步。
第 2 步 选模型
可选“预设模型”(下拉,来自后端 catalog)或“自定义模型”(手填第三方 / 自定义模型 ID)。这里只决定模型,凭据在第 4 步。
第 3 步 新建 API 配置
切到“新建 API 配置”,先填写便于复用的配置名称,再填写 OPENAI_API_KEY 与 OPENAI_BASE_URL。可先点“测试可达性”;保存时 Key 只写入认证配置,对话仅保存配置 ID。
创建并验证
点“创建 Codex Agent”。若没填 Key 会报“请输入 API Key”;若 Base URL 返回不像 LLM API,会提示检查地址。创建后进入对话,确认首条状态消息和模型正常。
注意事项
- 没有“供应商预设”下拉,Base URL 是自由输入(例如 https://openrouter.ai/api/v1)。
- 批量创建多个对话时只创建一个认证配置,所有新对话共同绑定它。
- daemon 只向平台上报指纹和非敏感元数据,不会上报原始 API Key。