Codex 接入指南
安装 Codex，填入 API Key，并通过 Starsg 开始对话。
重要开始前请先准备好在 控制台 创建的 API Key。如果还没有 Key,点击链接前往创建。
1. 环境检查
如果用下方的 npm 命令安装，先在终端运行 node --version。如果提示找不到命令，请到 Node.js 官网 下载安装，打开新终端后再运行下方两条检查命令。
node --version npm --version
官方安装指南： Codex CLI
只安装你要用的工具；已安装的可以跳过。下面是 npm 安装命令：
npm i -g @openai/codex@latest
重要:只运行已安装工具对应的 --version 命令，检查安装结果。
codex --version
终端显示版本号即安装成功。如果提示找不到命令，请重新打开终端再试。
2. 配置 Codex
编辑 ~/.codex/config.toml ,这里配置网关地址、默认模型与推理强度:
disable_response_storage = true model = "gpt-5.5" model_provider = "novamaas" model_reasoning_effort = "high" model_verbosity = "high" [features] web_search_request = true [model_providers.novamaas] base_url = "https://api.starsg.ai/v1" name = "novamaas" requires_openai_auth = true wire_api = "responses"
再把 API Key 写入 ~/.codex/auth.json :
{
"OPENAI_API_KEY": "sk-abc...xyz"
}提示 如果配置文件或其目录不存在，请手动创建，再粘贴上方内容。Windows 的用户目录为 %USERPROFILE%。
3. 测试对话
在终端运行 codex，收到对话回复即说明接入成功。