Cursor + Claude Code 接入 API 实战：国内稳定使用 Claude 4.7 配置全攻略
官方 API 国内直连必败，本文给出 Cursor 和 Claude Code 两套完整配置方案，
图文步骤可直接照做，配置完成后无需代理，延迟稳定在 200ms 以内。
为什么官方地址不能用？
Anthropic 官方 API 地址api.anthropic.com在国内被防火长城拦截，
直连结果只有两种：超时或报错。
解决方案是将请求指向国内可访问的中转接入点，API 格式与官方完全一致，
Cursor 和 Claude Code 均无感知，只需改一个地址。
本文使用的接入点：
https://gw.claudeapi.com一、Cursor 接入配置
1.1 打开模型设置
Cursor Settings→Models，找到OpenAI API Key区域。
Cursor 对 Claude 的调用走 OpenAI 兼容格式，
因此填写位置是 OpenAI 那一栏，不是 Anthropic 专栏。
1.2 填写配置
| 字段 | 填写内容 |
|---|---|
| API Key | 你的 ClaudeAPI.com Key（sk-开头） |
| Override OpenAI Base URL | https://gw.claudeapi.com/v1 |
注意：Cursor 走 OpenAI 兼容路径，base_url 末尾需要加/v1。
1.3 选择模型
在模型列表中手动添加以下模型 ID（点击+ Add Model）：
claude-opus-4-7 claude-opus-4-6 claude-sonnet-4-6 claude-haiku-4-5-20251001添加完成后，在对话框右下角的模型选择器里切换即可。
1.4 验证
打开任意文件，按Ctrl+K（macOS：Cmd+K）唤起 Cursor AI，
发一条测试消息，看到正常回复即配置成功。
排查提示：
- 回复报 401 → API Key 填错或无余额
- 回复超时 → base_url 末尾
/v1漏写，或 Key 未激活 - 模型不可用 → 手动添加的模型 ID 拼写有误
二、Claude Code 接入配置
Claude Code 通过读取~/.claude/settings.json中的env字段获取 API 配置，
有三种方式可以修改。
方式一：直接编辑 settings.json（最直接）
文件位置：
Windows: C:\Users\<用户名>\.claude\settings.json macOS/Linux: ~/.claude/settings.json打开文件，找到或新增env字段：
{"env":{"ANTHROPIC_AUTH_TOKEN":"sk-你的ClaudeAPI密钥","ANTHROPIC_BASE_URL":"https://gw.claudeapi.com"}}保存后重启 Claude Code 生效。
方式二：环境变量（适合服务器或 CI 环境）
# Linux / macOS，写入 ~/.bashrc 或 ~/.zshrcexportANTHROPIC_API_KEY="sk-你的ClaudeAPI密钥"exportANTHROPIC_BASE_URL="https://gw.claudeapi.com"# 立即生效source~/.bashrc# Windows PowerShell（当前会话生效）$env:ANTHROPIC_API_KEY ="sk-你的ClaudeAPI密钥"$env:ANTHROPIC_BASE_URL ="https://gw.claudeapi.com"# 永久写入用户环境变量[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY","sk-你的Key","User")[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://gw.claudeapi.com","User")方式三：cc-switch 管理多套配置（推荐）
如果你同时维护多个 Key 或需要在官方 API 和国内接入点之间切换，
推荐使用 cc-switch 统一管理。
安装：
npminstall-g@hobeeliu/cc-switch初始化 ClaudeAPI.com 配置：
cc-switch init# ANTHROPIC_AUTH_TOKEN → 你的 ClaudeAPI.com Key# ANTHROPIC_BASE_URL → https://gw.claudeapi.com常用命令：
cc-switch list# 查看所有配置cc-switch use default# 切换到指定配置（立即生效）cc-switchtest-c# 测试当前配置连通性多配置示例（国内直连 + 官方备用）：
# 新建官方 API 配置cc-switch new official-i# ANTHROPIC_AUTH_TOKEN → 你的官方 Anthropic Key# ANTHROPIC_BASE_URL → https://api.anthropic.com# 切换cc-switch use default# 国内直连（日常使用）cc-switch use official# 官方 API（海外环境）三、指定使用 Claude 4.7
Claude Code 默认会使用账号绑定的模型，如需强制指定模型，
在settings.json中加入：
{"env":{"ANTHROPIC_AUTH_TOKEN":"sk-你的Key","ANTHROPIC_BASE_URL":"https://gw.claudeapi.com","ANTHROPIC_MODEL":"claude-opus-4-7","ANTHROPIC_SMALL_FAST_MODEL":"claude-haiku-4-5-20251001"}}| 环境变量 | 作用 |
|---|---|
ANTHROPIC_MODEL | 主模型，用于主要推理和代码生成 |
ANTHROPIC_SMALL_FAST_MODEL | 辅助模型，用于自动补全等轻量任务 |
推荐组合：主模型claude-opus-4-7，辅助模型claude-haiku-4-5-20251001，
兼顾效果与速度。
四、Cursor 与 Claude Code 对比
| 维度 | Cursor | Claude Code |
|---|---|---|
| 形态 | GUI 编辑器（VSCode 内核） | 命令行 CLI |
| 适合场景 | 有 GUI 偏好、需要代码补全 | 终端党、Agent 自动化任务 |
| 接入格式 | OpenAI 兼容（base_url 加/v1） | Anthropic 原生格式 |
| 多配置管理 | 手动改设置 | cc-switch 一键切换 |
| 免费额度 | Cursor 订阅内含部分额度 | 按 Token 计费 |
两者并不互斥，很多开发者同时使用：
- Cursor负责日常代码补全和文件级编辑
- Claude Code负责跨文件重构、自动化 Agent 任务
五、常见问题
Q：Cursor 填了 base_url 还是连不上？
检查 base_url 是否是https://gw.claudeapi.com/v1（带/v1）。
Cursor 走 OpenAI 兼容路径，少了/v1会 404。
Q：Claude Code 提示Invalid API Key？
settings.json中的字段名是ANTHROPIC_AUTH_TOKEN，
不是ANTHROPIC_API_KEY，两者都需要配置时以前者为准。
Q：cc-switch use 之后需要重启 Claude Code 吗？
不需要。cc-switch 直接修改settings.json，
Claude Code 下次发起 API 请求时自动读取新配置。
Q：如何确认当前用的是哪个接入点？
# cc-switch 用户cc-switch current cc-switchtest-c# 实际发起请求验证连通性# 直接查看配置文件cat~/.claude/settings.jsonQ：Cursor 的 Claude 模型和 Claude Code 用同一个 Key 吗？
可以共用同一个 ClaudeAPI.com Key，两个工具独立计费，
共享同一个账户余额。
六、配置速查卡
Cursor ├── Base URL: https://gw.claudeapi.com/v1 ← 末尾加 /v1 ├── API Key: sk-你的Key └── Model: claude-opus-4-7（手动添加） Claude Code (settings.json) ├── ANTHROPIC_AUTH_TOKEN: sk-你的Key ├── ANTHROPIC_BASE_URL: https://gw.claudeapi.com ├── ANTHROPIC_MODEL: claude-opus-4-7（可选） └── ANTHROPIC_SMALL_FAST_MODEL: claude-haiku-4-5-20251001（可选）配置完成后，Cursor 和 Claude Code 均可在国内无代理稳定使用 Claude 4.7，
延迟通常在 150–200ms 范围内，与官方直连体验一致。