ChatEasy API 快速开始

ChatEasy API 是一个 AI API 管理与中转平台。用户登录后可以在控制台中查看账户余额、创建 API 密钥、充值或订阅、查看请求记录、观察 Token 与费用变化，并通过渠道状态判断模型服务是否正常。

建议严格按以下顺序完成配置。不要一上来就把 API Key 接进正式项目，先用简单测试请求确认配置无误，再切换到生产场景。

1. 注册 ChatEasy API 账号。 打开官网注册入口，填写邮箱、用户名、密码等信息；如果页面支持第三方登录，也可以按页面提示授权注册。
2. 登录控制台。 登录后进入仪表盘，确认左侧菜单包含“仪表盘、API 密钥、使用记录、渠道状态、充值/订阅”等入口。
3. 充值或订阅。 进入“充值/订阅”页面，选择额度、套餐或兑换码。付款前务必确认账号、金额和支付方式。
4. 创建 API 密钥。 进入“API 密钥”页面，点击创建密钥，填写用途名称，创建后立即复制保存。不要公开展示真实 Key。
5. 配置 Base URL 与 API Key。 在 OpenAI 兼容客户端或 SDK 中填写接口地址、API Key 和模型名称。字段名可能叫 Endpoint、API Host、Base URL 或 API 地址。
6. 测试调用。 使用一个简单问题或低成本模型发起请求，确认客户端没有认证失败、模型不存在或余额不足等报错。
7. 查看使用记录。 回到 ChatEasy 控制台，查看是否产生对应请求记录，并核对模型、Token、费用和状态。

首次使用时，先打开 ChatEasy API 的注册页面。注册信息通常包括邮箱、用户名和密码。请使用自己能长期接收通知的邮箱，并保存好登录信息。

注册完成后，使用账号密码登录。登录成功后通常会进入仪表盘页面。仪表盘是后续所有操作的起点，左侧菜单可以进入 API 密钥、使用记录、渠道状态、充值/订阅、订单和个人资料等页面。

在调用 API 之前，需要确认账户有可用余额或订阅套餐。进入左侧菜单的“充值/订阅”，选择合适的额度、套餐或兑换码方式。

API 密钥是客户端调用 ChatEasy API 的凭证。建议按项目、工具或环境分别创建 Key，例如“codex-local”“cherrystudio-test”“production-server”。这样一旦某个项目出现异常消费，可以单独停用对应 Key。

1. 分组名称： 用于区分不同用途，例如 Claude Code、Codex。
2. 选择分组： 必须选择，分组决定这个密钥可以使用哪些模型。
3. 过期时间： 默认“永不过期”，也可以按需要设置有效期。
4. 额度设置： 开启“无限额度”时，令牌实际可用额度仍受账户余额限制。
5. 访问限制： 不熟悉时建议先保持默认。

在 OpenAI 兼容客户端、SDK 或命令行工具里，通常需要填写三个字段：Base URL、API Key、Model。不同软件的字段名可能不同，但配置逻辑基本一致。

Base URL: https://chateasy.cc/v1
API Key: 你的 ChatEasy API 密钥
Model: 按 ChatEasy 支持的模型名称填写

CC-Switch 是 Claude Code 和 Codex 的配置管理工具，可以统一管理供应商配置、MCP、Skills、系统提示词等内容。ChatEasy API 的“API 密钥”页面已经提供“导入到 CCS”入口，推荐优先使用这个入口完成配置，避免手动填写 Base URL、API Key 和模型分组时出错。

通用步骤

Claude Code 配置

1. 打开 CC-Switch。进入主界面后，在顶部或侧边的分组中切换到 Claude / Claude Code 相关分组。
2. 创建 ChatEasy 专用密钥。回到 ChatEasy 的“API 密钥”页面，创建一个给 Claude Code 使用的密钥，建议命名为 claude-code。
3. 选择 Claude 对应分组。创建密钥时选择 Claude Code 可用的分组，分组选错会导致模型不可用或请求失败。
4. 导入到 CCS。在密钥列表右侧点击“导入到 CCS”，按 CC-Switch 提示完成导入。
5. 启用配置。在 CC-Switch 主界面找到刚导入的 ChatEasy 配置，点击启用，确认状态变成使用中。
6. 勾选 Claude Code 初次安装确认。如果 CC-Switch 设置中有“跳过 Claude Code 初次安装确认”之类选项，建议按工具提示开启，减少首次运行拦截。
7. 终端测试。打开终端运行 claude，进入对话界面并能收到回复，即表示配置成功。

Codex 配置

1. 打开 CC-Switch。在分组条中切换到 Codex。
2. 创建 Codex 专用密钥。在 ChatEasy “API 密钥”页面创建新密钥，建议命名为 codex-cli 或 codex-local。
3. 选择 Codex 分组。创建密钥时选择 Codex 可用分组；截图中可以看到密钥可以归属不同分组。
4. 点击“导入到 CCS”。在对应密钥右侧点击导入，按 CC-Switch 的弹窗或提示完成添加。
5. 启用 Codex 配置。回到 CC-Switch，在 Codex 分组下启用 ChatEasy 配置。
6. 终端测试。运行 codex，看到 Codex 交互界面并能正常回复，即表示配置完成。

CC-Switch CLI 使用

CC-Switch 也提供 CLI / TUI 方式，适合服务器、SSH、macOS 终端或自动化场景。如果你不方便打开图形界面，可以使用 CC-Switch CLI 检查、切换和修复 Claude Code、Codex 的配置。具体命令以你安装的 CC-Switch 版本帮助信息为准。

如果不使用 CC-Switch，也可以手动配置 Claude Code 和 Codex。建议按“检查 Node.js、安装 CLI、首次运行生成配置目录、写入配置文件、终端测试”的顺序完成。

环境检查

1. 确认 Node.js / npm 可用。 在 Windows 或 macOS 终端运行 npm list -g --depth-0。如果提示 command not found，说明 Node.js 未安装或环境变量未生效。
2. 安装 CLI。 需要用到 Claude Code 和 Codex 时，可分别安装对应命令行工具。
3. 运行一次 CLI。 安装后分别运行 claude 和 codex。这一步很重要，因为首次运行通常会生成配置目录。

npm i -g @anthropic-ai/claude-code@latest
npm i -g @openai/codex@latest

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://chateasy.cc",
    "ANTHROPIC_AUTH_TOKEN": "你的 ChatEasy Claude/CC 分组密钥",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

model_provider = "chateasy"
model = "gpt-5.5"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true
model_verbosity = "high"

[model_providers.chateasy]
name = "chateasy"
base_url = "https://chateasy.cc/v1"
wire_api = "responses"
requires_openai_auth = true

{
  "OPENAI_API_KEY": "你的 ChatEasy Codex 分组密钥"
}

配置完成后，先用简单请求测试，不要直接接入正式业务。测试目标是确认“能连通、能认证、模型存在、余额可扣、记录可查”。

1. 选择一个低成本或常用模型
2. 发送一句简单问题，例如：请回复 ok
3. 检查客户端是否返回正常结果
4. 回到 ChatEasy 使用记录查看是否产生调用
5. 核对模型、Token、费用和状态