客户端接入
Codex 接入
使用 Codex CLI 或 Codex 本地配置时,把模型提供商切换到 0x1c。
Codex 类客户端通常支持自定义 model provider。你需要在本机配置里新增 0x1c provider,并让它读取 0x1c API Key。
先确认版本
Codex 的配置项会随版本变化。下面示例适合支持 model_providers、base_url、env_key 和 wire_api 的版本。如果你的配置文件字段不同,请以当前 Codex 帮助文档为准。
1. 设置 API Key
建议把 Key 放到环境变量:
export OPENAI_API_KEY="sk-..."如果你不想和官方 OpenAI Key 混用,也可以使用单独变量:
export OX1C_API_KEY="sk-..."下面的配置示例会使用 OX1C_API_KEY。
2. 编辑 Codex 配置
常见配置文件位置:
~/.codex/config.toml新增或调整:
model = "MODEL_ID"
model_provider = "0x1c"
[model_providers."0x1c"]
name = "0x1c"
base_url = "https://0x1c.io/v1"
env_key = "OX1C_API_KEY"
wire_api = "responses"把 MODEL_ID 替换成控制台里的模型 ID。
3. 如果 Responses 不兼容
部分模型或网关能力可能更适合 Chat Completions。可以尝试:
model = "MODEL_ID"
model_provider = "0x1c"
[model_providers."0x1c"]
name = "0x1c"
base_url = "https://0x1c.io/v1"
env_key = "OX1C_API_KEY"
wire_api = "chat"如果 Codex 版本不接受 wire_api = "chat",删除该字段或查看当前版本支持的值。
4. 验证
重新打开终端后运行:
codex进入后问一个简单问题:
请用一句话回复:0x1c 配置成功。如果仍然请求官方 OpenAI,通常说明配置文件没有被读取,或环境变量没有在当前 shell 生效。
常见问题
配置后还是 401
运行:
echo "$OX1C_API_KEY"如果没有输出,说明当前终端没有环境变量。把 export 写入你的 shell 配置文件,例如 ~/.zshrc。
模型不支持工具调用
coding agent 常依赖工具调用、长上下文和稳定的结构化输出。换一个更适合代码任务的模型再试。
代理或网络导致失败
先用 curl 请求 https://0x1c.io/v1/models。curl 成功后再排查 Codex 配置。