Cofin API 文档
首页
快速开始

快速总览

⚠️ IMPORTANT给阅读者的忠告！

01 📖 请你在部署使用前一定阅读“常见问题”板块；如果有时间，建议阅读全文。

02 💡我们一直提倡 "授人以鱼，不如授人以渔"

03 ✅ 这两个板块不仅能提升你的使用体验，也能解答你今后会提问的 90% 的问题

请务必认真阅读以上内容

让我们从这里开始吧！

一步步来，准没问题！

第一步：注册账号

  • 如果你在登录页，也可以点击顶部“没有账户？注册”进入注册流程。

方式：使用用户名或邮箱注册

  1. 填写邮箱或用户名、密码和确认密码。
  2. 按页面提示提交，完成注册。

密码建议使用字母、数字和特殊字符组合。请妥善保管登录凭证，避免账号被盗用。

第二步：登录账号

使用邮箱/用户名登录

  1. 输入邮箱地址或用户名。
  2. 输入账号密码。
  3. 点击“继续”完成登录。

设备登录说明浏览器会保持登录状态；在新设备需重复登录流程。

第三步：购买额度

登录控制台后，进入左侧“钱包”页面购买额度，有两种支付方式。

  1. 使用Waffo在“金额”中选择固定额度或者自定义额度，点击Waffo付款，

  2. 推荐国内用户使用卡密支付，点击下方兑换码的“点此获取”，在卡密商城购买后复制卡密到此处兑换。

支付说明目前充值比例为 1:1，即 1 元人民币等同于 1 美元额度。Waffo支付需要按照汇率换算并且附加$0.5手续费。

临时公告：

  • 目前暂时不支持开票服务，后续业务逐渐完善后，逐渐补充开票服务。

第四步：创建 API 令牌

登录后进入控制台面板，左侧选择“令牌管理”。

进入令牌管理

  1. 在左侧菜单点击“API密钥”。

  2. 点击页面上方的“创建API密钥”。

创建新令牌

在弹窗中填写令牌信息：

  • 令牌名称：用于区分不同用途，例如 Claude Code、Codex、Gemini。

  • 令牌分组：必须选择，分组决定这个令牌可以使用哪些模型。

  • 过期时间：默认“永不过期”，也可以按需要设置有效期。

  • 新建数量：一般保持 1 即可。

  • 额度设置：开启“无限额度”时，令牌实际可用额度仍受账户余额限制。

  • 访问限制：不熟悉时建议先保持默认，不要开启模型限制或 IP 白名单。

  • 填写完成后，点击右下角“提交”完成创建。

令牌分组一定要选对令牌分组会直接影响可用模型。比如 Claude Code、Codex、Gemini CLI 需要选择对应分组；如果分组选错，后续配置 CLI 时很容易出现“模型不存在”或无法调用的问题。

如果你不确定某个模型是否可用，请先查看当前账号的模型列表和 API 密钥权限。

查看分组可用模型

你可以在“模型广场”查看每个令牌分组下支持哪些模型。

  1. 点击页面上方“模型广场”。
  2. 在左侧“可用令牌分组”中选择分组。
  3. 右侧模型卡片会显示该分组可用的模型、价格和折扣倍率。

第五步：环境检查

在配置 Claude Code、Codex 或 Gemini CLI 之前，请先确认本机已经正确安装 Node.js。

在 Windows、macOS 或 Linux 终端中执行：

npm list -g --depth-0

如果命令可以正常执行，说明 Node.js 与 npm 已经可用。即使输出中没有安装任何全局包，也不影响后续配置。

如果提示“命令未找到”或类似错误，说明当前环境还没有安装 Node.js，或安装后没有正确加入系统环境变量。请先完成 Node.js 安装，再重新执行上面的命令确认。

必须先完成环境检查CLI 工具依赖 Node.js 和 npm。环境没有准备好时，后续安装 Claude Code、Codex、Gemini CLI 都可能失败。

第六步：配置 CLI 工具

Cofin AI 支持在命令行中使用 Claude Code、Codex、Gemini CLI

基础条件

开始配置 CLI 前，请先完成以下步骤：

  1. 完成 环境检查，确保 Node.js 和 npm 可以正常使用。
  2. 完成 安装 CLI，安装 Claude Code、Codex、Gemini CLI。

API 端点说明

登录控制台后，可以在“数据看板”右侧查看当前可用的 API URL。

OpenAI 兼容端点需要添加 /v1如果你使用的是 OpenAI 兼容格式的客户端或工具，例如 Codex、OpenAI SDK、Cherry Studio 的 OpenAI 兼容配置，请在 API 地址后添加 /v1：

https://api.cofinapi.top/v1

如果使用的是 Claude Code、Gemini CLI 等专用配置，请以对应教程中的示例为准。

推荐配置为了让配置过程进行轻便简单，我们极力推荐使用Github开源项目 CC-Switch来对我们的使用环境进行配置。

CC-Switch配置CC、Codex教程

如果你是老鸟，或者不愿意使用此工具，可以参考以下CLI配置教程文档，但我们还是极力推荐使用此工具，能省很多时间！

CLI 手动配置教程传送门

注意：不管你是使用哪个 CLI，请一定先完成上方基础条件，确保 Node.js、npm 和对应 CLI 都可以正常使用。