工具接入
查看 Cursor、Codex、Cline、Claude Code、OpenCode 的完整接入方式。
快速开始
这一页只解决一件事：先把请求打通。内容聚焦 curl、Codex、Claude Code 的最小接入方式，剩下的缓存、压缩和控制台细节在后面的页面展开。
开始之前
先准备好 API Key、分组和模型名，再做任何客户端配置。
OpenAI 兼容请求的 Base URL：https://api.lingcorex.ai/v1
Anthropic 原生请求的 Base URL：https://api.lingcorex.ai
先在控制台创建 API Key，再选择与工具或端点格式相匹配的分组。
如果工具走 OpenAI 兼容格式，就选择对应的兼容分组；如果工具走 Anthropic 原生格式，就选择 Anthropic 原生分组。
如果你还不确定该选哪个分组，先看 API Key 与分组 页面。那一页会解释分组的概念，以及怎么识别 Anthropic 端点分组。
curl
最快的联通性检查方式，就是先发一条 OpenAI 兼容的 chat completions 请求。
OpenAI 兼容 curl 请求
curl https://api.lingcorex.ai/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.4-mini",
"messages": [
{"role": "user", "content": "返回一句健康检查结果。"}
],
"stream": false
}'401 一般表示 API Key 缺失或无效；402 一般表示当前账户余额不足以通过预扣费校验。
Cursor
如果你使用 Cursor，可以按这个真实界面录屏完成 API Key、OpenAI 兼容 Base URL、官方支持模型选择，以及第一条 hello 对话验证。
Codex
Codex 走的是 OpenAI 兼容路径，所以最小配置就是 Base URL 加 API Key。
01
创建 OpenAI 兼容的 API Key
在控制台选择适用于 OpenAI 兼容工具的分组来创建 API Key。
02
设置环境变量
在启动 Codex 之前，先导出 OPENAI_BASE_URL=https://api.lingcorex.ai/v1 和 OPENAI_API_KEY=<YOUR_API_KEY>。
03
先验证第一条请求
建议先用轻量模型跑一次短会话，确认链路可用后，再补充你自己的持久化配置。
Claude Code
Claude Code 更适合搭配 Anthropic 原生分组，这样更容易保留 Anthropic 原生请求行为。
Codex 环境变量
export OPENAI_BASE_URL=https://api.lingcorex.ai/v1
export OPENAI_API_KEY=YOUR_API_KEY
codexClaude Code 环境变量
ANTHROPIC_BASE_URL=https://api.lingcorex.ai \
ANTHROPIC_API_KEY=YOUR_API_KEY \
ANTHROPIC_CUSTOM_MODEL_OPTION=claude-sonnet-4-5 \
claude如果你的工作流很看重 Anthropic 原生缓存语义，Claude Code 通常比 OpenAI 兼容路径更合适。
下一步读什么
把第一条请求打通之后，再根据你的实际场景继续往下读。
缓存说明
理解不同接口和工具在缓存上的差异，以及 LingCoreX 的自动缓存优化。
API Key 与分组
了解 API Key、QPM、每日限额、分组选择，以及 Anthropic 端点分组的识别方式。