Cursor 接入 Claude 的完整配置流程
摘要Cursor 在国内的使用问题主要集中在两件事连不通 Anthropic以及不方便支付 Cursor Pro。本文把 Cursor 接入 Claude 的完整流程拆成 7 个步骤用兼容 OpenAI 协议的自定义端点来实现。一、配置前的 3 项准备下载最新版 Cursor访问 cursor.com 下载较新的稳定版本才支持自定义 base_url。准备一个可用的 API Key在你所用的模型服务控制台创建一个sk-xxx的 key。关闭代理软件避免代理干扰 Cursor 的网络判断。二、步骤 1进入 Cursor 设置按CtrlShiftJWindows / Linux或CmdShiftJmacOS打开设置面板在左侧菜单点Models。三、步骤 2开启 Override OpenAI Base URL在 Models 面板底部找到Override OpenAI Base URL开关打开并填入服务提供的 OpenAI 兼容地址以jiekou.vip为例https://api.highwayapi.ai/openai注意地址格式要与服务文档一致路径缺失容易导致 404。四、步骤 3填入 API Key在同一面板的OpenAI API Key字段填入sk-xxx点Verify连接成功会显示 ✓。五、步骤 4添加自定义模型Cursor 默认列出的是 OpenAI 型号要用 Claude 需手动添加。点 Add custom model依次加入claude-sonnet-4-6claude-opus-4-8claude-haiku-4-5-20251001每个模型添加后记得点旁边的开关启用。六、步骤 5把 Claude 设为默认模型回到主界面按CtrlL打开 Chat 面板在底部模型选择器里把默认值切到claude-sonnet-4-6。之后 Chat、Composer、CmdK 都会走 Claude。七、步骤 6测试 Composer Agent 模式打开 Composer输入帮我在 src/components 目录下新建一个 Button 组件使用 TypeScript Tailwind支持 primary/secondary/ghost 三种变体正常情况下 Cursor 会调用 Claude 完成多文件代码生成。八、步骤 7开启 Tab 补全回到 Models 面板把 Tab 补全模型设为claude-haiku-4-5-20251001速度和成本较优。九、团队部署建议对中大型团队可以把上述配置标准化集中管理 base_url 与 key放到团队的密码管理器共享库。子账号体系为每个开发者创建独立 key便于审计。配额管理给每个 key 设月度上限超额告警。新员工 onboarding把配置写进入职手册。十、常见错误与排查错误 AVerify 显示 ✓ 但 Chat 报model_not_found。原因自定义模型没启用回到 Models 面板检查开关。错误 BTab 补全延迟很高。原因可能用了 Opus 跑 Tab改成 Haiku 即可。错误 CAgent 模式 tool_use 报错。原因base_url 路径不对或服务端不支持 tool_use 透传。核对服务文档给的地址。错误 D账单超预期。原因所有任务都默认走了 Opus。日常用 Sonnet关键任务再切 Opus。