Agent 接入
Codex CLI + 星模XModel
Codex CLI 原生支持 OpenAI 兼容的自定义 provider:改一个 TOML 配置文件即可把请求发到星模XModel 网关,无需安装插件或代理。
终端 CLI · 厂商:OpenAI
快速开始
分步接入
1前置条件:获取 API Key
注册星模XModel 后,在控制台「API 密钥」页创建一个 Key。下文所有 YOUR_API_KEY 占位符都替换为你的 Key;Key 等同账户凭证,不要提交进仓库。
2安装 Codex CLI
需要 Node.js 22+。
shellnpm install -g @openai/codex3写入 ~/.codex/config.toml
把 provider 指到星模XModel 的 OpenAI 兼容端点,wire_api 用 chat。
~/.codex/config.tomlmodel = "qwen/qwen3-coder-plus" model_provider = "xmodel" [model_providers.xmodel] name = "星模XModel" base_url = "https://modelxing.com/v1" env_key = "NEXTMODEL_API_KEY" wire_api = "chat"4导出 Key 并启动
shellexport NEXTMODEL_API_KEY="YOUR_API_KEY" codex
示例提示词
配好后直接粘贴
复制任意一条发给刚配好的 Agent,验证接入是否生效。
提示词
用 qwen/qwen3-coder-plus 重构当前目录里的工具函数,保持对外签名不变,并解释取舍。提示词
阅读这个仓库的 README,给出三个能立刻提升测试覆盖率的具体改动。常见问题
FAQ
支持流式输出吗?
支持。wire_api = "chat" 走 /v1/chat/completions,SSE 流式与官方 provider 一致;上线前请在模型市场确认所选模型带 streaming 能力标注。
还能用哪些模型?
所有模型市场里生产状态的模型都可以填进 model 字段;编码场景优先看「编码」榜单。
故障排查
出问题时先看这里
请求返回 401
检查 NEXTMODEL_API_KEY 是否已在当前 shell 导出,值是否以 sk- 开头且完整粘贴(无换行)。
提示模型不存在
model 字段必须是模型市场展示的模型 ID(含 provider 前缀,如 qwen/qwen3-coder-plus),不能用展示名。