主题
Cursor 与 Claude Code 坑
这一页只记接入时最容易踩的坑,不是 Cursor 安装长教程。其它报错见 常见报错。
Claude Code:密钥变量名
要用 ANTHROPIC_AUTH_TOKEN,不要写成 ANTHROPIC_API_KEY。
本站 Windows / macOS / Linux 安装页都把 Key 放在 settings.json 的 env 里:
json
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "你的API密钥",
"ANTHROPIC_BASE_URL": "https://aicode.cat"
}
}"你的API密钥" 换成 用户仪表盘密钥页 里创建的实际密钥。
Claude Code:Base URL 用站点根
ANTHROPIC_BASE_URL 填 https://aicode.cat,不要再加 /v1。
这和 Codex 不同:Codex 的 base_url 是 https://aicode.cat/v1。抄错路径会连不上或 401。
改完必须重启
Claude Code、Codex、Gemini CLI 安装页都写了:
- 配置完成后要重启终端
- 如果在 VS Code / Cursor 的集成终端里使用,需要彻底重启整个 IDE,不只是重开终端面板
只改文件、不重启,还是会用旧环境变量。
Cursor:官方模型名可能被拦住
在 Cursor 里接入时,填官方全名有可能被编辑器拦截或改写成它内置的模型。
怎么处理:
- 改用短名,或在 Cursor 里添加自定义模型后再填 AiCodeCat 的地址和 Key
- 短名、自定义模型入口以 Cursor 当前界面和本站控制台为准
- Base URL、Key 仍按你实际使用的客户端来:走 Claude Code 就用上一节的站点根 +
ANTHROPIC_AUTH_TOKEN
不要在 Cursor 里把 Claude Code 的站点根和 Codex 的 /v1 混填。