SynteroLink 快速开始:3 分钟跑通 GPT 和 Claude
适合第一次接入的用户。先跑通接口,再配置 CLI / VS Code / Cursor。
1. 先选模型系列
| 你要使用 | 推荐入口 | Base URL | 默认模型 |
|---|---|---|---|
| GPT 系列 | OpenAI-compatible | https://api.synterolink.com/v1 | gpt-5.4 |
| Claude 系列 | Anthropic-compatible | https://api.synterolink.com | claude-sonnet-4-6 |
2. GPT 最小验证
export OPENAI_API_KEY="your_synterolink_key"
curl https://api.synterolink.com/v1/models \
-H "Authorization: Bearer $OPENAI_API_KEY"
curl https://api.synterolink.com/v1/responses \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-d '{"model":"gpt-5.4","input":"Reply exactly: OK"}'
成功标准:返回内容里能看到模型列表,或者生成结果中出现 OK。
3. Claude 最小验证
export ANTHROPIC_BASE_URL="https://api.synterolink.com"
export ANTHROPIC_AUTH_TOKEN="your_synterolink_key"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
curl https://api.synterolink.com/v1/messages \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
-H "anthropic-version: 2023-06-01" \
-d '{"model":"claude-sonnet-4-6","max_tokens":32,"messages":[{"role":"user","content":"Reply exactly: OK"}]}'
成功标准:返回 Claude Messages 格式响应,并能看到 OK 或正常文本内容。
4. 编辑器配置原则
| 工具 | 推荐方式 | 必填项 |
|---|---|---|
| VS Code + Continue | OpenAI-compatible | Base URL、API Key、Model |
| VS Code + Cline / Roo Code | OpenAI-compatible 或 Anthropic-compatible | Provider、Base URL、Key、Model |
| Cursor | OpenAI-compatible 自定义模型 | Base URL、Key、Model |
| Claude Code | Anthropic-compatible | ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN |
5. 新手不要跳过的检查
- 先在终端跑 curl。
- 再配置 CLI 或编辑器。
- 使用准确模型名,不要自己改大小写。
- GPT Base URL 必须带
/v1。 - Claude Code Base URL 使用根地址,不要写成
/v1。 - 不要把真实 key 发到公开文档、GitHub、截图或群聊。
6. 下一步
- GPT 用户看:GPT 系列完整指南
- Claude 用户看:Claude 系列完整指南
- 不确定用哪个模型看:模型矩阵
- 报错看:错误排查中心