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 字段：

json 复制代码

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的ClaudeAPI密钥",
    "ANTHROPIC_BASE_URL": "https://gw.claudeapi.com"
  }
}

保存后重启 Claude Code 生效。

方式二：环境变量（适合服务器或 CI 环境）

bash 复制代码

# Linux / macOS，写入 ~/.bashrc 或 ~/.zshrc
export ANTHROPIC_API_KEY="sk-你的ClaudeAPI密钥"
export ANTHROPIC_BASE_URL="https://gw.claudeapi.com"

# 立即生效
source ~/.bashrc

powershell 复制代码

# 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 统一管理。

安装：

bash 复制代码

npm install -g @hobeeliu/cc-switch

初始化 ClaudeAPI.com 配置：

bash 复制代码

cc-switch init
# ANTHROPIC_AUTH_TOKEN → 你的 ClaudeAPI.com Key
# ANTHROPIC_BASE_URL   → https://gw.claudeapi.com

常用命令：

bash 复制代码

cc-switch list          # 查看所有配置
cc-switch use default   # 切换到指定配置（立即生效）
cc-switch test -c       # 测试当前配置连通性

多配置示例（国内直连 + 官方备用）：

bash 复制代码

# 新建官方 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 中加入：

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：如何确认当前用的是哪个接入点？

bash 复制代码

# cc-switch 用户
cc-switch current
cc-switch test -c   # 实际发起请求验证连通性

# 直接查看配置文件
cat ~/.claude/settings.json

Q：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 范围内，与官方直连体验一致。