0x1c Wiki
客户端接入

Codex 接入

使用 Codex CLI 或 Codex 本地配置时,把模型提供商切换到 0x1c。

Codex 类客户端通常支持自定义 model provider。你需要在本机配置里新增 0x1c provider,并让它读取 0x1c API Key。

先确认版本

Codex 的配置项会随版本变化。下面示例适合支持 model_providersbase_urlenv_keywire_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 配置。

On this page