客户端接入总览

绝大多数工具接入 0x1c 时，只需要关注三个字段：

字段	填写方式
API Key	0x1c 控制台创建的 Key
Base URL	OpenAI-compatible 通常填 `https://0x1c.io/v1`
Model	控制台模型列表里的完整模型 ID

选择你的工具

OpenAI SDK

Node.js、Python 和 curl 的通用接入方式。

Codex

通过 config.toml 配置自定义 model provider。

Claude Code

使用 Anthropic 兼容变量接入 Claude 模型。

OpenClaw

配置 OpenAI-compatible provider 和本地环境变量。

Cursor

在编辑器里配置 API Key、模型和 Override Base URL。

环境变量

把 Key 和 Base URL 安全地放在本机或项目配置里。

先做连通性测试

接入任何客户端前，建议先用 curl 验证 Key 和模型可用：

curl https://0x1c.io/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "messages": [
      {
        "role": "user",
        "content": "ping"
      }
    ]
  }'

如果 curl 成功，但客户端失败，问题通常在客户端配置。重点检查：

Base URL 是否填成 https://0x1c.io/v1。
API Key 是否保存到了客户端真正读取的位置。
模型 ID 是否和控制台一致。
客户端是否使用了不兼容的接口类型。