新用户接入指南

这篇给第一次使用 BestAI 的用户。你不需要先理解所有协议名，按下面流程完成一次最小接入即可。

你会完成什么

接入成功不是“配置文件写完”，而是同时看到两个结果：

1. 工具收到验证请求的模型回复。
2. 余额与账单 中出现对应时间的请求记录。

验证请求也会产生用量，所以第一次只发送短句，不要一开始运行长任务。

开始前准备

准备项	用途
BestAI 账号	创建 API Key、查看余额和请求记录
一个要接入的工具	Claude Code、Codex 或任意兼容 SDK
可用余额或分组额度	避免验证请求因额度不足失败
5 分钟连续操作时间	创建 Key、配置、验证和核对账单

第 1 步：创建 API Key

打开 API Keys，创建一个 Key。

建议按用途命名，例如：

用途	示例名称
Claude Code	claude-code-local
Codex	codex-local
SDK 或项目	project-dev

创建后确认：

1. Key 状态可用。
2. 已复制完整 Key，而不是只复制前缀。
3. Key 的额度符合预期；测试时可以先使用较小额度。

文档中的 sk-你的Key 只是占位符。不要把真实 Key 放进截图、公开仓库或聊天记录。

第 2 步：确认余额或额度

打开 仪表盘，确认账户余额、Key 额度和目标分组都可用。

如果余额不足，工具侧可能显示为 401、403 或请求失败。先确认额度，再排查地址和配置。

第 3 步：选择工具并保存配置

一次只接入一个工具。先让一个工具完成“有回复 + 有账单记录”，再接第二个工具，排错会简单很多。

Claude Code

详细步骤见 Claude Code 接入指南。临时验证可以在当前终端设置：

export ANTHROPIC_BASE_URL="https://api.bestai.chat"
export ANTHROPIC_API_KEY="sk-你的Key"
unset ANTHROPIC_AUTH_TOKEN

长期使用建议写入 ~/.claude/settings.json，不要每次手工输入。

Codex CLI / App

详细步骤见 Codex 接入指南。默认配置文件是 ~/.codex/config.toml；只有主动设置了 CODEX_HOME 时路径才会变化。

model = "从控制台选择的模型"
model_provider = "bestai"

[model_providers.bestai]
name = "bestai"
base_url = "https://api.bestai.chat"
wire_api = "responses"
env_key = "BESTAI_API_KEY"

export BESTAI_API_KEY="sk-你的Key"

SDK 或其他工具

OpenAI 兼容工具通常填写：

Base URL: https://api.bestai.chat/v1
API Key:  sk-你的Key

Anthropic 兼容工具通常填写：

Base URL: https://api.bestai.chat
API Key:  sk-你的Key

第 4 步：发送最小验证请求

启动工具后发送：

请只回复：BestAI 已连接。

先不要测试长上下文、图片或复杂 Agent 任务。短验证句更容易判断问题来自配置、额度还是上游模型。

第 5 步：核对账单

收到回复后立即打开 仪表盘，找到刚才时间附近的请求记录，核对模型、状态和扣费。

结果	说明
有回复，有账单	接入完成
有回复，无账单	当前会话可能仍在使用旧 Provider 或其他服务
无回复，无账单	请求可能没有发出，检查工具配置或网络
有失败账单	请求已到达 BestAI，继续按错误码排查

验证失败怎么办

现象	第一检查项	下一步
401 / 403	Key 是否完整、额度是否可用	查看 常见问题
404	是否把完整 endpoint 填进了 Base URL	查看 常见问题
有回复但没有账单	当前 Provider / Profile 是否切到 BestAI	查看 控制台使用指南
502 / 503	稍后重试并记录时间和错误文本	查看 常见问题

完成标准

你已经完成接入，当且仅当：

1. 工具能收到 BestAI 已连接。。
2. 余额与账单中有对应请求记录。
3. 你知道当前工具读取配置的文件或环境变量位置。

接下来可以阅读对应的完整工具指南，或返回 文档中心 选择下一项任务。