客户端示例
Codex
在 Codex CLI 中新增 AsterMesh model provider。
Codex 类客户端通常支持自定义 model provider。在本机配置里新增 AsterMesh，并让它读取 AsterMesh API Key。
先确认版本
Codex 的配置项会随版本变化。下面示例适合支持 model_providers、base_url、env_key 和 wire_api 的版本。如果你的配置文件字段不同，请以当前 Codex 帮助文档为准。
1. 设置 API Key
export ASTERMESH_API_KEY="sk-..."也可以使用 OPENAI_API_KEY，但单独变量更不容易和官方 OpenAI Key 混用。
2. 编辑配置文件
常见路径：
~/.codex/config.toml新增：
model = "MODEL_ID"
model_provider = "astermesh"
[model_providers."astermesh"]
name = "astermesh"
base_url = "https://console.astermesh.cn/v1"
env_key = "ASTERMESH_API_KEY"
wire_api = "responses"把 MODEL_ID 换成控制台里的完整模型 ID。
3. 如果 Responses 不兼容
部分模型更适合 Chat Completions，可改为：
wire_api = "chat"若当前 Codex 版本不接受该字段，删除后重试，或以官方帮助文档为准。
4. 验证
codex进入后问：
请用一句话回复：AsterMesh 配置成功。常见问题
- 配置后还是 401：先确认
echo "$ASTERMESH_API_KEY"有输出；没有则把 export 写入 shell 配置文件（如~/.zshrc）。 - 代理或网络导致失败：先用 curl 请求
https://console.astermesh.cn/v1/models，成功后再排查 Codex 配置。 - 模型不支持工具调用：coding agent 依赖工具调用、长上下文和稳定的结构化输出，换一个更适合代码任务的模型再试。
- 仍然请求官方 OpenAI：说明配置文件没有被读取，或环境变量没有在当前 shell 生效。