Claude 系列：Claude Code 与 VS Code / Cursor 完整部署指南

Claude Code 走 Anthropic-compatible 根地址。重点是 ANTHROPIC_BASE_URL 不要写错。

1. 适用场景

• Claude Code 命令行使用 Claude 系列模型。
• VS Code / Cursor 里使用支持 Anthropic-compatible 的插件。
• 需要 Claude 风格 Messages API 的团队。

2. 核心配置

3. Claude Code 安装前提

Claude Code 官方要求 Node.js 18+，并可通过 npm 安装：

node -v
npm install -g @anthropic-ai/claude-code
claude doctor

不要使用 sudo npm install -g，否则容易出现权限问题。

4. Claude Code 环境变量

export ANTHROPIC_BASE_URL="https://api.synterolink.com"
export ANTHROPIC_AUTH_TOKEN="your_synterolink_key"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

说明：ANTHROPIC_AUTH_TOKEN 会作为 Authorization Bearer token 使用。

5. 先验证 Messages API

curl https://api.synterolink.com/v1/messages \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 64,
    "messages": [
      {"role": "user", "content": "Reply exactly: OK"}
    ]
  }'

6. 启动 Claude Code

claude --model claude-sonnet-4-6 -p "Reply exactly: OK"

如果返回 OK，说明 Claude Code 已经走 SynteroLink 链路。

7. 其他 Claude 模型示例

claude --model claude-opus-4-7
claude --model claude-opus-4-6
claude --model claude-sonnet-4-5
claude --model claude-haiku-4-5

8. VS Code / Cursor 配置方式

Anthropic-compatible 方式

OpenAI-compatible fallback

如果某个插件不支持 Anthropic-compatible，但支持 OpenAI-compatible，可以尝试：

Base URL: https://api.synterolink.com/v1
Model: claude-sonnet-4-6

优先使用 Anthropic-compatible；fallback 只用于插件限制场景。

9. 成功验收清单

• /v1/messages curl 能返回正常结果。
• claude --model claude-sonnet-4-6 -p "Reply exactly: OK" 能返回 OK。
• Claude Code 没有继续要求官方 Anthropic 登录。
• 编辑器插件使用的 Base URL 与模型名完全一致。

10. 常见错误