# Cursor、Claude Code 与 Cline 最佳接入实践指南

> **文档定位**：本指南提供在主流 AI 编程环境（Cursor、Claude Code、VS Code Cline / Roo Code、Aider、Antigravity）中无缝接入极智 API (`api.lmxxz.xyz`) 的推荐兼容配置参数、最佳模型选型与排错清单。  
> **中立性说明**：Cursor 与 Claude Code 均原生支持通过环境变量或设置项配置自定义 OpenAI / Anthropic 兼容端点。本文仅作为技术选型与配置参考，不代表相关客户端产品对极智 API 的官方授权、官方推荐或排他性支持。  
> **服务特性**：提供兼容 OpenAI `/v1`、Anthropic `/v1/messages` 与 Google Gemini `/v1beta/` 规范的 API 接入与路由服务。

---

## 一、 快速接入参数速查

| 配置项 | 推荐兼容配置参数 |
| :--- | :--- |
| **OpenAI 兼容 Base URL** | `https://api.lmxxz.xyz/v1` |
| **Anthropic 兼容 Base URL** | `https://api.lmxxz.xyz` （或根据客户端要求追加 `/v1`） |
| **Gemini 兼容 Base URL** | `https://api.lmxxz.xyz/v1beta` |
| **API Key 格式** | `sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` |
| **推荐旗舰编程模型** | `claude-sonnet-5` (Sonnet 官方当前主力), `claude-opus-4-6`, `gpt-6-astra`, `gpt-5.6-sol` |
| **极速与长文献思考模型** | `gemini-3.8-flash`（全网 7.5 折特惠）, `gpt-5.5` |

---

## 二、 主流开发工具实战配置步骤

### 1. Cursor IDE 配置与注意事项

> ⚠️ **Cursor 路由机制重要提示**：根据 Cursor 官方说明，在 Cursor 设置中开启并填入 **Override OpenAI Base URL** 是**全局生效**的配置。启用自定义 Base URL 后，可能会改变 Cursor 管理的其他默认模型的底层路由。建议您按需开启，或在多项目切换时确认端点状态。

**配置流程**：
1. 打开 Cursor，点击右上角齿轮 **Settings** -> **Models**。
2. 开启 **OpenAI API Key** 开关：
   * 输入您的极智 API Key（`sk-...`）。
   * 点击展开 **Override OpenAI Base URL**，填入：`https://api.lmxxz.xyz/v1`。
3. 添加主力模型：在下方 Model 列表中点击 **Add Model**，输入：
   * `claude-sonnet-5`
   * `claude-opus-4-6`
   * `gpt-6-astra`
   * `gpt-5.6-sol`
4. 点击保存并测试连接。极智 API 提供 P50 188ms 极速首字直连，代码补全与 Composer 模式稳定运行。

---

### 2. Anthropic 的 Claude Code CLI 终端工具配置
在终端环境（Bash / Zsh / PowerShell）中配置环境变量即可启动：

**Linux / macOS (Bash / Zsh)**:
```bash
export ANTHROPIC_BASE_URL="https://api.lmxxz.xyz"
export ANTHROPIC_API_KEY="sk-YOUR_API_KEY"
claude
```

**Windows (PowerShell)**:
```powershell
$env:ANTHROPIC_BASE_URL = "https://api.lmxxz.xyz"
$env:ANTHROPIC_API_KEY = "sk-YOUR_API_KEY"
claude
```

---

### 3. VS Code 插件 Cline / Roo Code 配置
1. 打开 Cline 插件设置，在 **API Provider** 下拉列表中选择 **OpenAI Compatible** 或 **Anthropic**。
2. 若选择 **OpenAI Compatible**：
   * Base URL: `https://api.lmxxz.xyz/v1`
   * API Key: `sk-YOUR_API_KEY`
   * Model ID: `claude-sonnet-5` 或 `gpt-6-astra`
3. 若选择 **Anthropic**：
   * Base URL: `https://api.lmxxz.xyz`
   * API Key: `sk-YOUR_API_KEY`
   * Model ID: `claude-sonnet-5`

---

## 三、 常见排错与连接自检

1. **遇到 401 Unauthorized 错误**：  
   请核查 API Key 是否完整复制，确保无前后空格；并确认账户在控制台中处于激活且有额度状态。
2. **遇到请求超时**：  
   长任务建议将客户端 Client Timeout 设置为 120 秒以上。极智 API 专线底层支持 600 秒超长 TCP Keep-Alive 保活。
3. **Cursor 无法识别自定义模型**：  
   在 Cursor 的 Models 列表中手动点击 "Add Model"，输入上述官方支持的 Model ID，并确保开关处于开启状态。