环境检查（通用步骤）
在配置任何 AI 编程工具之前，请先完成以下环境检查，确保你的系统环境满足要求。
前置条件
请确认你已完成 快速开始 中的所有步骤，拥有：
- ✅ AiFirst 账号
- ✅ 充足的余额
- ✅ 一个可用的 API 密钥（
sk-xxx）
确认 API 信息
| 配置项 | 值 |
|---|---|
| API Base URL | https://apiaifirst.com |
| API Base URL（含 v1） | https://apiaifirst.com/v1 |
| API Key | 你创建的密钥（sk-xxx） |
⚠️
不同工具对 API Base URL 的格式要求不同：
- Claude Code：使用
https://apiaifirst.com（不加/v1） - Codex / OpenAI SDK：使用
https://apiaifirst.com/v1（需要加/v1）
网络环境检查
测试 API 连通性
在终端中运行以下命令，确认能正常访问 AiFirst API：
curl https://apiaifirst.com/health预期返回：
{"status":"ok"}测试 API Key 有效性
curl https://apiaifirst.com/v1/models \
-H "Authorization: Bearer sk-xxx"如果返回模型列表（JSON 格式），说明你的 API Key 有效。
测试 Chat Completions
curl https://apiaifirst.com/v1/chat/completions \
-H "Authorization: Bearer sk-xxx" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.5",
"messages": [{"role": "user", "content": "Say hi"}],
"max_tokens": 10
}'如果返回正常的 AI 回复，说明一切就绪！
常见网络问题
| 现象 | 原因 | 解决方案 |
|---|---|---|
Connection refused | 网络不通 | 检查网络连接，确认能访问外网 |
401 Unauthorized | API Key 无效 | 检查 Key 是否正确，是否已过期 |
429 Too Many Requests | 请求频率过高 | 稍等片刻后重试 |
503 Service Unavailable | 上游服务暂时不可用 | 等待几分钟后重试 |
👉
环境检查通过后，请前往对应工具的配置教程：