# TokenFlows 概述

TokenFlows 为开发者和 AI Agent 工具提供统一的模型网关。你可以用一组 API Key 调用 GPT、Claude、Gemini 等模型，并在控制台集中查看用量、余额和费用明细。

## 适合谁使用

- **AI 编程工具用户**：Codex、Claude Code、OpenCode、Cursor 等工具接入后即可使用多种模型。
- **应用开发者**：后端服务、脚本、自动化任务可以通过 OpenAI 或 Anthropic 兼容协议快速接入。
- **团队和高频用户**：统一管理密钥、用量和成本，减少多平台切换。

## 核心能力

- **统一接入**：兼容 OpenAI 和 Anthropic 常用 API 协议，减少 SDK 迁移成本。
- **多模型路由**：通过模型 ID 选择 GPT、Claude、Gemini 等模型。
- **透明计费**：控制台可查看请求明细、token 消耗和余额变化。
- **Agent 友好**：适配 Codex、Claude Code、OpenCode 等本地开发工具。
- **成本优化**：GPT 系列可利用缓存输入降低长上下文和重复上下文成本。

## 快速开始

### 1. 获取 API Key

在 [TokenFlows 控制台](https://dash.tokenflows.org/) 注册并创建一个 API Key。

### 2. 选择接入方式

| 使用场景 | 推荐入口 |
| --- | --- |
| Codex App / Codex CLI | 查看 [Codex App 集成](/docs/codex-app) 或 [Codex CLI 集成](/docs/codex-cli) |
| Claude Code | 查看 [Claude Code 集成](/docs/claude-code) |
| OpenCode | 查看 [OpenCode 集成](/docs/opencode) |
| 自己写代码调用 | 查看 [代码集成](/docs/code-integration) |
| 只想确认端点和参数 | 查看 [API 参考](/docs/api-reference) |

### 3. 发起一个 OpenAI 兼容请求

```bash
curl -X POST https://api.tokenflows.org/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {"role": "user", "content": "你好，介绍一下 TokenFlows"}
    ]
  }'
```

### 4. 查看模型与用量

- 前往 [模型列表](/models) 查看可用模型、模型 ID 和价格。
- 前往控制台查看请求记录、token 用量、余额和费用明细。

## 协议选择提示

- OpenAI SDK、OpenCode GPT 模型和多数自定义后端：优先使用 OpenAI 兼容协议，base URL 为 `https://api.tokenflows.org/v1`。
- Claude Code：`ANTHROPIC_BASE_URL` 填 `https://api.tokenflows.org`，不要在末尾加 `/v1`。
- Anthropic SDK 或 Claude 协议直连：使用 `https://api.tokenflows.org/v1/messages` 发送消息。