项目愿景 ​

aicentos 是一个 AI Coding 中转站，支持 Codex、Codex 等主流 AI 模型在多种平台使用。本仓库包含两个核心部分：

1. 文档站 (VitePress) -- 面向用户的多语言文档门户，部署于 https://www.aicentos.com/
2. Landing Page (Deno) -- 独立的单文件 Deno 服务器，服务于 https://www.aicentos.com/ 主站着陆页

架构总览 ​

• 技术栈: VitePress 1.x + Vue 3 + TypeScript + Deno
• 构建工具: pnpm + Vite (VitePress 内置)
• 部署: GitHub Pages (文档站，通过 GitHub Actions) + Vercel (额外部署配置) + Deno Deploy (Landing Page)
• 国际化: 5 种语言 -- 简体中文 (默认)、English、Francais、Espanol、Portugues
• 功能增强: PWA (workbox)、RSS/Atom Feed 生成、Sitemap、图片缩放 (medium-zoom)、代码块分组图标

模块结构图 ​

graph TD
    A["(根) https://www.aicentos.com/"] --> B[".vitepress/"];
    A --> C["deno/"];
    A --> D["内容目录 (*.md)"];
    A --> E["public/"];
    A --> F[".github/workflows/"];

    B --> B1["config.mts"];
    B --> B2["theme/"];
    B2 --> B2a["index.ts"];
    B2 --> B2b["components/"];
    B2b --> B2b1["AnnouncementBar.vue"];
    B2b --> B2b2["BackToTop.vue"];
    B2b --> B2b3["ModelCards.vue"];
    B2b --> B2b4["ToolWizard.vue"];
    B2b --> B2b5["Timeline.vue"];
    B2 --> B2c["NotFound.vue"];
    B2 --> B2d["style.css + dark-mode.css"];

    D --> D1["/ (zh-CN 默认)"];
    D --> D2["en/"];
    D --> D3["fr/"];
    D --> D4["es/"];
    D --> D5["pt/"];

    C --> C1["landing.deno.ts"];
    C --> C2["deno.json"];

    click C "./deno/AGENTS.md" "查看 deno 模块文档"

模块索引 ​

| 模块 | 路径 | 语言/框架 | 职责 | |

已有账号？直接查看 快速开始 配置工具。 想了解平台全貌？请查看 平台导航。

一、获取 API Key ​

1. 注册账号 ​

访问 aicentos，点击注册：

选择注册方式（GitHub、LinuxDO 或用户名注册）：

填写用户名、密码和确认密码完成注册：

2. 登录 ​

注册完成后使用用户名和密码登录：

登录后进入控制台：

3. 创建令牌 ​

进入控制台 → 令牌管理 → 添加令牌，填写表单：

• 令牌分组建议选择 官渠，该分组包含全系列 Claude 模型，会根据任务复杂度自动选择，无需手动切换。具体渠道和模型以官网实际为准，请前往 定价页 查看最新信息。

创建完成后在令牌列表点击复制按钮获取 API Key（格式为 sk-xxx）：

4. 充值 ​

进入控制台 → 钱包管理，支持支付宝、微信或兑换码：

| 方式 | 操作路径 | |

适用范围 ​

本文适用于 Claude Desktop 新版的 Cowork / Code 第三方推理接入 模式，也就是 Anthropic 官方文档中的 third-party inference。

如果你想要的是：

• 在桌面端使用 Claude 的 Cowork
• 在桌面端使用 Claude 的 Code
• 通过自定义 API / 网关把请求转到 aicentos

那么走的就是这套配置方式。

前置准备 ​

开始前请先准备：

1. 安装最新版 Claude Desktop
2. 准备一个 aicentos Token
3. 确认你的 Token 可访问 Claude 模型

Token 获取地址：

• aicentos

建议优先准备这些模型作为候选：

• claude-sonnet-4-5-20250929
• claude-opus-4-5-20251101
• claude-haiku-4-5-20251001

方式一：在 Claude Desktop 里直接配置（推荐） ​

Anthropic 官方推荐优先通过桌面端内置的第三方推理配置界面完成设置。

1. 启用 Developer mode ​

在 Claude Desktop 顶部菜单中依次进入：

Help → Troubleshooting → Enable Developer mode

启用后，应用菜单里会出现 Developer 相关入口。

2. 打开第三方推理配置 ​

继续进入：

Developer → Configure third-party inference

这里会打开一套 Anthropic 官方提供的第三方推理配置流程。

3. 选择 Gateway 模式 ​

在提供商类型里，选择：

Gateway

aicentos 这类自定义 API / 中转服务，对应的就是 gateway 模式。

4. 填写 aicentos 配置 ​

核心信息按下面填写：

• Gateway URL：https://www.aicentos.com/
• Authentication：x-api-key
• API Key：你的 aicentos Token

如果界面要求填写模型列表，建议先填：

claude-sonnet-4-5-20250929
claude-opus-4-5-20251101
claude-haiku-4-5-20251001

如果界面支持启用 Code，保持开启即可。

5. 应用到本地 ​

完成配置后，优先选择：

Apply locally

这会把第三方推理配置写入当前用户的本地 Claude Desktop 配置中。

配置成功后，重新打开 Claude Desktop，通常就能看到可用的 Cowork / Code 工作界面。

方式二：通过本地配置文件管理（进阶） ​

如果你想备份、迁移或排查配置，可以查看 Claude Desktop 本地写入的位置。

常见路径如下：

macOS ​

~/Library/Application Support/Claude-3p/claude_desktop_config.json

Windows ​

%APPDATA%\Claude-3p\claude_desktop_config.json

Linux ​

~/.config/Claude-3p/claude_desktop_config.json

aicentos 推荐配置 ​

如果你要手动核对字段，重点关注下面几项：

| 字段 | 建议值 | |

选择适合你的 AI 编程工具。以下是 aicentos 平台支持的各工具全面对比。

基本信息 ​

| 工具 | 开发者 | 类型 | |

错误日志用于定位单次请求失败的具体原因。排查时建议先查看 分组健康状态 判断影响范围，再用错误日志里的 request_id 定位单条请求。

入口：控制台 → 使用日志。将日志类型切换为 错误日志 后，可按时间、模型、Token、分组、请求 ID、错误消息和状态码筛选。

字段说明 ​

| 字段 | 含义 | 排查价值 | |

通用 ​

aicentos 是什么？ ​

aicentos 是一个 AI Coding 中转站，支持 Claude、Codex 模型在多种平台使用。

支持哪些工具？ ​

目前支持以下工具：

• Claude Code — Anthropic 官方 CLI
• OpenAI Codex — OpenAI 官方编程助手
• RooCode — VS Code AI 编程插件
• Qwen Code — 阿里通义千问编程工具
• Droid CLI — 轻量级 AI 编程 CLI
• OpenCode — 开源 AI 编程终端工具

数据隐私如何保障？ ​

aicentos 仅作为 API 中转服务，不存储你的代码和对话内容。所有请求直接转发至对应的模型提供商。

账户与 Token ​

如何注册？ ​

访问 aicentos，按提示完成注册即可。

如何获取 API Token？ ​

注册后登录控制台，前往 Token 管理页 创建新的 Token。

Token 有效期多长？ ​

Token 在手动删除或重新生成前持续有效。建议定期轮换以确保安全。

用量额度是多少？ ​

aicentos 为每个用户提供用量额度，具体数量根据平台资源动态调整。请关注控制台中的用量信息。

工具配置 ​

环境变量设置后不生效怎么办？ ​

检查以下常见原因：

1. 未重启终端 — 修改 .bashrc / .zshrc 后需要执行 source ~/.bashrc 或新开终端
2. 变量名拼写错误 — 注意区分大小写，如 ANTHROPIC_BASE_URL 不能写成 Anthropic_Base_Url
3. 多余的引号或空格 — export KEY="value" 中 value 前后不要有多余空格

# 检查变量是否已设置
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

# 如果为空，说明变量未生效

配置文件路径在哪里？ ​

| 工具 | 配置文件路径 | |

前置准备 ​

在开始前，你需要先准备好：

1. 一个 aicentos 账号
2. 一个可用的 API Token
3. 确认当前 Token 可以访问 gpt-image-2

获取 Token：

• 控制台地址：aicentos

开源可视化工具 ​

如果你不想先写代码，可以直接使用 aicentos 提供的开源 GPT-Image-2 工具进行测试和出图：

• 在线体验：aicentos
• 开源仓库：aicentos

方式一：使用 Images API 生成图片 ​

这是最直接的方式，对应 OpenAI 兼容的图片生成接口。

• 请求地址：https://www.aicentos.com/v1/images/generations
• 模型名称：gpt-image-2

Python 示例 ​

import base64
from openai import OpenAI

client = OpenAI(
    api_key="sk-你的Aicentos-Token",
    base_url="https://www.aicentos.com/v1"
)

result = client.images.generate(
    model="gpt-image-2",
    prompt="一只戴着宇航员头盔的橘猫，坐在月球表面，电影级光影，超清细节",
    size="1024x1024"
)

image_base64 = result.data[0].b64_json

with open("gpt-image-2-output.png", "wb") as f:
    f.write(base64.b64decode(image_base64))

Node.js 示例 ​

import fs from "node:fs";
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-你的Aicentos-Token",
  baseURL: "https://www.aicentos.com/v1",
});

const result = await client.images.generate({
  model: "gpt-image-2",
  prompt: "一座漂浮在云海上的未来城市，赛博朋克霓虹风格，超高细节",
  size: "1024x1024",
});

const imageBase64 = result.data[0].b64_json;
fs.writeFileSync("gpt-image-2-output.png", Buffer.from(imageBase64, "base64"));

curl 示例 ​

curl --request POST \
  --url https://www.aicentos.com/v1/images/generations \
  --header "Authorization: Bearer sk-你的Aicentos-Token" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "gpt-image-2",
    "prompt": "一张极简产品海报，白色背景，中央是一枚悬浮的透明玻璃键盘，商业摄影风格",
    "size": "1024x1024"
  }'

方式二：通过 Chat Completions 调用图片生成 ​

如果你的工作流已经基于 /v1/chat/completions，也可以直接在对话接口里调用 gpt-image-2。

• 请求地址：https://www.aicentos.com/v1/chat/completions
• 模型名称：gpt-image-2

Python 示例 ​

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的Aicentos-Token",
    base_url="https://www.aicentos.com/v1"
)

response = client.chat.completions.create(
    model="gpt-image-2",
    messages=[
        {
            "role": "user",
            "content": "画一只戴墨镜的柴犬，坐在复古红色敞篷车里，公路旅行风格"
        }
    ]
)

print(response)

curl 示例 ​

curl --request POST \
  --url https://www.aicentos.com/v1/chat/completions \
  --header "Authorization: Bearer sk-你的Aicentos-Token" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "gpt-image-2",
    "messages": [
      {
        "role": "user",
        "content": "画一间日落时分的日式咖啡馆，暖色电影感构图"
      }
    ]
  }'

常用参数说明 ​

gpt-image-2 常见可用参数如下：

| 参数 | 含义 | 示例 | |

分组健康状态用于判断调用异常是单个请求问题，还是某个套餐、模型、上游分组或团队成员的集中问题。企业和团队管理员可以用它快速回答三个问题：

• 哪个分组在指定时间范围内成功率下降
• 哪个用户或令牌贡献了主要请求量、消耗或错误
• 错误是集中在单个 Token，还是已经影响整个分组

排查接口异常时，先看分组健康状态，再进入单条使用日志定位具体 request_id。

如果上方状态页未正常加载，可直接打开 aicentos 分组健康状态。

控制台入口：控制台 → 使用日志。在错误日志或统计视图中，按时间范围、模型、Token、分组、错误消息和状态码筛选。

控制台示例 ​

下面是控制台 使用日志 → 分组健康状态 的示例截图，展示分组的成功率、请求数、消耗、缓存命中、平均耗时、最近请求时间和失败原因。

需要解释单条错误消息时，请查看 错误日志说明。

列表展示字段 ​

控制台列表和 CSV 导出的展示列保持一致。列表同时展示两类行：

• 分组行：汇总一个分组在当前时间范围内的整体健康状态。
• 令牌行：展示某个分组下的用户和令牌明细，便于企业、团队管理员定位成员、项目或服务。

| 展示字段 | 适用行 | 字段说明 | 使用建议 | |

前提条件 ​

• 已安装 OpenClaw（参考下方安装章节）
• 已获取 aicentos API Key（控制台获取）

核心特性 ​

多渠道集成 ​

• 全平台覆盖：支持飞书（Lark）、Discord、Slack、Microsoft Teams 等
• 单一网关：通过单个 Gateway 进程管理所有渠道
• 语音支持：支持 macOS/iOS/Android 语音交互
• 画布界面：可渲染交互式 Canvas 界面

自托管与数据安全 ​

• 完全自托管：运行在你自己的机器或服务器上
• 开源：MIT 协议，代码完全透明
• 本地数据存储：上下文与技能存储在本地，不上传云端

智能 Agent 能力 ​

• 持久运行：支持后台持久运行与持久记忆
• 定时任务：支持 cron 定时任务
• 会话隔离：按 Agent/工作区/发送者隔离会话
• 多 Agent 路由：支持多 Agent 协作
• 工具调用：原生支持工具调用与代码执行

安装 ​

curl -fsSL https://openclaw.ai/install.sh | bash

npm install -g openclaw@latest

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

git clone https://github.com/openclaw/openclaw.git
cd openclaw && pnpm install && pnpm run build
pnpm run openclaw onboard

安装完成后运行引导向导（手动克隆方式已在上方命令中包含）：

openclaw onboard

配置 ​

配置文件位置 ​

OpenClaw 配置文件位于 ~/.openclaw/openclaw.json：

• macOS: /Users/你的用户名/.openclaw/openclaw.json
• Linux: /home/你的用户名/.openclaw/openclaw.json
• Windows: C:\Users\你的用户名\.openclaw\openclaw.json

如果文件不存在，请先创建：

mkdir -p ~/.openclaw
touch ~/.openclaw/openclaw.json

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.openclaw"
New-Item -ItemType File -Force -Path "$env:USERPROFILE\.openclaw\openclaw.json"

配置文件结构 ​

openclaw.json 的整体结构分为两大部分：

{
  "models": {
    "mode": "merge",
    "providers": {
      // 配置 AI 模型提供商
    }
  },
  "agents": {
    "defaults": {
      // 配置默认模型、工作目录等
    }
  }
}

• models.providers — 定义服务提供商，包括地址、Key、模型列表
• models.mode — 设为 "merge" 时，自定义配置会与内置默认配置合并，强烈建议始终加上
• agents.defaults.model.primary — 默认使用的模型，格式为 provider名称/模型ID
• api — API 协议类型，Anthropic 模型用 "anthropic-messages"，OpenAI 兼容模型用 "openai-responses"

配置方式 ​

配置 Anthropic（Claude）模型 ​

将以下内容写入 openclaw.json：

{
  "models": {
    "mode": "merge",
    "providers": {
      "aicentos-anthropic": {
        "baseUrl": "https://www.aicentos.com/",
        "apiKey": "sk-你的Aicentos-Token",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-opus-4-6",
            "name": "Claude Opus 4.6",
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 8192,
            "reasoning": false
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "aicentos-anthropic/claude-opus-4-6"
      }
    }
  }
}

配置 OpenAI（GPT）模型 ​

通过 aicentos 调用 OpenAI 模型时，api 字段须设为 openai-responses：

{
  "models": {
    "mode": "merge",
    "providers": {
      "aicentos-openai": {
        "baseUrl": "https://www.aicentos.com/v1",
        "apiKey": "sk-你的Aicentos-Token",
        "api": "openai-responses",
        "models": [
          {
            "id": "gpt-5",
            "name": "GPT-5",
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 16384,
            "reasoning": true
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "aicentos-openai/gpt-5"
      }
    }
  }
}

同时配置 Anthropic + OpenAI（推荐） ​

在 models.providers 下并列添加两个 provider，即可同时使用两家模型：

{
  "models": {
    "mode": "merge",
    "providers": {
      "aicentos-anthropic": {
        "baseUrl": "https://www.aicentos.com/",
        "apiKey": "sk-你的Aicentos-Token",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-opus-4-6",
            "name": "Claude Opus 4.6",
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 8192,
            "reasoning": false
          },
          {
            "id": "claude-sonnet-4-5-20250929",
            "name": "Claude Sonnet 4.5",
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 8192,
            "reasoning": false
          }
        ]
      },
      "aicentos-openai": {
        "baseUrl": "https://www.aicentos.com/v1",
        "apiKey": "sk-你的Aicentos-Token",
        "api": "openai-responses",
        "models": [
          {
            "id": "gpt-5",
            "name": "GPT-5",
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 16384,
            "reasoning": true
          },
          {
            "id": "gpt-5-codex",
            "name": "GPT-5 Codex",
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 16384,
            "reasoning": true
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "aicentos-anthropic/claude-opus-4-6",
        "fallbacks": [
          "aicentos-anthropic/claude-sonnet-4-5-20250929",
          "aicentos-openai/gpt-5"
        ]
      }
    }
  }
}

切换默认模型时，只需修改 model.primary 的值：

• "aicentos-anthropic/claude-opus-4-6" → Claude Opus 4.6
• "aicentos-anthropic/claude-sonnet-4-5-20250929" → Claude Sonnet 4.5
• "aicentos-openai/gpt-5" → GPT-5
• "aicentos-openai/gpt-5-codex" → GPT-5 Codex

关键字段说明 ​

| 字段 | 含义 | Anthropic（Claude） | OpenAI（GPT） | |

本页面介绍 aicentos 的整体平台结构，帮助你快速定位所需功能。 需要注册账号？请查看 账户注册与管理。

一、平台概述 ​

aicentos 是一个面向开发者和团队使用的 АI 接入平台。你可以把它理解成一个统一入口：前面是官网、定价和文档，后面是控制台、令牌、充值、发票和使用记录。

平台围绕主流 AI 模型提供中转服务，具体渠道和模型以官网实际为准，请前往 定价页 查看。用户从注册开始，到创建令牌、选择套餐、接入工具、查看消耗，整套流程都在同一个系统里完成。

生效日期：2026年2月11日

aicentos 严格遵守《中华人民共和国个人信息保护法》、《网络安全法》、《数据安全法》及相关法律法规。

一、我们收集哪些信息及用途 ​

| 场景 | 收集内容 | 用途 | |

在 VSCode 中安装 RooCode ​

1. 在 VSCode 中搜索 RooCode 并安装
2. 访问 aicentos 获取你的 API Key

新增提供商 ​

完成 RooCode 安装后，打开 RooCode，选择配置提供商，新增一个 OpenAI Compatible 的供应商：

| 配置项 | 值 | |

首次使用？请先完成 账户注册与充值。

一、环境准备 ​

安装 Node.js ​

Claude Code 通过 npm 安装，需先确认 Node.js 已就绪。

node -v
npm -v

brew install node

node -v
npm -v

若未安装，前往 nodejs.org/zh-cn/download 下载对应平台安装包，安装完成后 Windows 需重启。

Windows 额外：安装 Git Bash ​

Claude Code 依赖 bash 运行环境，Windows 用户需安装 Git Bash：

1. 下载地址：git-scm.com/install/windows，选择对应版本安装。
2. 验证：右键桌面，出现 Open Git Bash here 选项即安装成功。

生效日期：2026年2月11日

1. 总则 ​

本协议由使用 aicentos API 聚合平台（以下简称"提供方"、"aicentos"或"公司"）服务的实体或个人（以下简称"用户"或"您"）与 aicentos 共同缔结。本协议包括协议正文、隐私政策及其他相关政策和公告。您承诺具备完全民事行为能力（年满十八周岁）以订立本协议。若您代表某一法律实体，须保证拥有充分授权。

2. 定义 ​

| 术语 | 含义 | |

ZCF 是 Claude Code / Codex 的零配置增强工具，zcf init 一条命令完成 API 配置、工作流导入、MCP 服务集成等全部初始化。

没有账号？先完成 账户注册 获取 API Key。