Codex

在 Codex CLI 配置文件中新增 AnyStarX 模型提供商。

Codex 类命令行客户端支持自定义模型提供商(Model Provider)。通过在本地配置文件中声明目标端点,并绑定对应的环境变量,即可将底层模型路由切换至 AnyStarX。

客户端版本兼容性

Codex 的具体字段名称随版本迭代可能有所调整。下文示例适用于支持 model_providersbase_urlenv_keywire_api 字段的版本。如果所使用的版本字段不同,请以其官方帮助手册为准。

1. 配置环境变量

在本地终端中导出 API Key:

export ANYSTARX_API_KEY="sk-..."

也可以使用通用的 OPENAI_API_KEY,但设置独立的环境变量能有效避免与官方凭据发生冲突。

2. 编辑配置文件

打开本地的用户配置文件:

~/.codex/config.toml

添加服务商声明并将默认模型指向该提供商:

model = "MODEL_ID"
model_provider = "anystarx"

[model_providers."anystarx"]
name = "anystarx"
base_url = "https://console.anystarx.com/v1"
env_key = "ANYSTARX_API_KEY"
wire_api = "responses"

将配置中的 MODEL_ID 替换为控制台模型列表中复制的完整标识符。

3. 协议模式调整

部分模型可能更适配传统的 Chat Completions 协议。若在调用中遇到协议解析异常,可将通信模式调整为:

wire_api = "chat"

如果所使用的客户端版本不包含该字段,直接移除该行即可。

4. 连通性测试

启动 Codex 交互程序:

codex

在交互会话中发送测试请求:

请用一句话确认:AnyStarX 配置成功。

常见问题排查

  • 提示 401 Unauthorized:在终端执行 echo "$ANYSTARX_API_KEY" 确认变量值有效。若输出为空,需将 export 命令写入 Shell 配置文件(如 ~/.zshrc)并重新加载。
  • 网络连接超时:在终端中使用基础 curl 命令请求 https://console.anystarx.com/v1/models,确认本地网络能否正常访问接口。
  • 模型未执行工具调用:coding agent 高度依赖模型的函数调用与结构化推理能力,建议在控制台中切换为代码能力更强的模型。
  • 请求仍发往官方 OpenAI 端点:检查配置文件路径是否正确,并确认当前终端会话已读取到最新配置。

本页内容