配置索引

先选客户端，再打开对应最小配置

本页只负责选择路径。Codex、Claude Code、SDK 和图形客户端的完整步骤放在各自专页，避免同一配置在多处漂移。

适用版本：以各工具专页标注为准 最后核对：2026-07-20

返回文档首页打开 1A1API 控制台查看错误码排查

客户端选择

只复制当前工具需要的配置

先选择工具，再到对应专页复制。示例模型只用于最小测试；实际可用模型以当前 API 密钥所属分组的控制台模型列表或 /v1/models 返回结果为准。

Codex CLI

根地址 https://1a1api.top，走 Responses。打开 Codex 教程 →

OpenAI SDK

Base URL 使用 https://1a1api.top/v1。打开 SDK 教程 →

Claude Code（环境变量）

根地址 https://api.1a1api.top。打开 Claude Code 教程 →

Cursor / Cherry Studio

分别核对界面字段，不要混填 root 与 /v1。打开双工具教程 →

OpenCode

使用自定义提供商（Provider）配置。打开图文教程 →

WorkBuddy

选择 Custom 提供商并填写 OpenAI 兼容地址。打开图文教程 →

CC Switch / CCS

基础导入与高级深链分开操作。打开 CC Switch 教程 →

OpenClaw 与 Hermes 暂无独立专页；仅在下方保留兼容模板。不要整文件覆盖已有配置，也不要把真实 API 密钥放进截图或分享链接。

展开 OpenClaw、Hermes 与旧客户端兼容模板

模板最后核对：2026-07-20。字段仍应以当前 OpenClaw 官方版本为准。

~/.openclaw/openclaw.json

{
  "models": {
    "mode": "merge",
    "providers": {
      "1a1api-openai": {
        "baseUrl": "https://1a1api.top/v1",
        "apiKey": "sk-your-api-key",
        "api": "openai-completions",
        "authHeader": true,
        "models": [
          {
            "id": "YOUR_MODEL_ID",
            "name": "1A1API model",
            "api": "openai-completions",
            "reasoning": true
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "1a1api-openai/YOUR_MODEL_ID"
      }
    }
  }
}

先把两处 YOUR_MODEL_ID 替换成当前 API 密钥实际可用的模型 ID。如果 openclaw.json 已存在，只合并 models.providers 和 agents.defaults.model 相关片段，不要整文件覆盖。模板不写死上下文窗口和本地成本；能力看模型页，实际费用看调用日志。

模板最后核对：2026-07-20。字段仍应以当前 Hermes 官方版本为准。

~/.hermes/config.yaml

model:
  default: "YOUR_MODEL_ID"
  provider: "custom"
  base_url: "https://1a1api.top/v1"

~/.hermes/.env

OPENAI_API_KEY="sk-your-api-key"

把 YOUR_MODEL_ID 替换成当前 API 密钥可用模型 ID。Hermes 官方目前不支持原生 Windows，建议在 macOS、Linux 或 WSL2 中使用。