Agent 接入

Codex CLI + 星模XModel

Codex CLI 原生支持 OpenAI 兼容的自定义 provider:改一个 TOML 配置文件即可把请求发到星模XModel 网关,无需安装插件或代理。

终端 CLI · 厂商:OpenAI

快速开始

分步接入

  1. 1前置条件:获取 API Key

    注册星模XModel 后,在控制台「API 密钥」页创建一个 Key。下文所有 YOUR_API_KEY 占位符都替换为你的 Key;Key 等同账户凭证,不要提交进仓库。

    打开 /docs/quickstart 文档

  2. 2安装 Codex CLI

    需要 Node.js 22+。

    shell
    npm install -g @openai/codex
  3. 3写入 ~/.codex/config.toml

    把 provider 指到星模XModel 的 OpenAI 兼容端点,wire_api 用 chat。

    ~/.codex/config.toml
    model = "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. 4导出 Key 并启动

    shell
    export 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),不能用展示名。