在 VS Code / Cursor / Windsurf 中使用 4AICode

Anthropic 官方的 Claude Code 扩展（2.0+）支持在 VS Code settings.json 里直接配置中转地址，不依赖系统环境变量，Windows / macOS / Linux 用法完全一致。

Cursor 和 Windsurf 都基于 VS Code，配置方式相同。

1. 装扩展

扩展面板搜 Claude Code，装作者是 Anthropic 的那一个。

2. 打开 settings.json

通过命令面板打开，最稳也最快。

打开命令面板：
- Windows / Linux：Ctrl + Shift + P
- macOS：Cmd + Shift + P（⇧⌘P）
输入 Preferences: Open User Settings (JSON)，回车

如果 Ctrl/Cmd + Shift + P 没反应（常见：被输入法或其他工具占用），用 Ctrl + P / Cmd + P 打开「快速打开」面板，在输入框首字符打 >（大于号），就会切成命令面板，一样能搜到这条命令。

3. 加配置

在 settings.json 最外层对象里加 claudeCode.environmentVariables：

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://relay.4aicode.net" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-4ai-xxxxxxxxxxxxxxxx" }
  ]
}

已有其他配置的话合并进去即可，不要嵌套在别的 key 里。

要在 Claude Code 面板里使用 ChatGPT gpt-5.6-sol 超高推理，把模型和推理强度变量也放进去：

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://relay.4aicode.net" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-4ai-xxxxxxxxxxxxxxxx" },
    { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "gpt-5.6-sol" },
    { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL_NAME", "value": "4AICode GPT 5.6 Sol" },
    {
      "name": "ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES",
      "value": "effort,xhigh_effort,thinking,adaptive_thinking,interleaved_thinking"
    },
    { "name": "ANTHROPIC_MODEL", "value": "opus" },
    { "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "gpt-5.4-mini" },
    { "name": "CLAUDE_CODE_EFFORT_LEVEL", "value": "xhigh" }
  ]
}

ANTHROPIC_DEFAULT_OPUS_MODEL 把 Claude Code 的 opus alias 指到 gpt-5.6-sol，CLAUDE_CODE_EFFORT_LEVEL=xhigh 对应超高推理。

要使用 GPT-6 Astra，将 ANTHROPIC_DEFAULT_OPUS_MODEL 改为 gpt-6-astra，并可将显示名称改为 4AICode GPT 6 Astra。

网关根据 gpt-* 或 claude-* 模型名称选择对应的上游服务，实际可用范围以控制台为准。

4. 重启 VS Code

完全退出再重开（关窗口不算，进程起时读一次就不刷新了）：

Windows：File → Exit / Alt + F4，再检查系统托盘、任务管理器里的 Code.exe 全部结束
macOS：Cmd + Q
Linux：File → Exit

Cursor / Windsurf 同理。

5. 验证

打开左侧 Claude Code 面板（装完扩展后有 Anthropic 图标），发一条 ping，能回复就通了。

再到仪表盘 → 使用记录确认对应调用。

常见问题

Q：还是弹 "Welcome to Claude Code" 登录界面？

别点那三个按钮（Claude.ai Subscription / Anthropic Console / Bedrock），点了会走 OAuth 到官方，之后要 claude logout 清本地登录态才能回 4AICode。多半是：

claudeCode.environmentVariables 拼错 / 嵌在别的 key 下 —— 回 settings.json 检查
没完全重启 —— 托盘图标、任务管理器里的 Code.exe 全部杀掉再开
用了 ANTHROPIC_API_KEY 而不是 ANTHROPIC_AUTH_TOKEN —— 扩展 2.0 认后者更稳

Q：Cursor 自己的 Chat / Agent 会冲突吗？

不会。Claude Code 是独立面板，Cursor 原生 Chat / Agent / Tab 走 Cursor 自己的后端，互不影响。

Q：Workspace 配置还是 User 配置？

推荐写 User 级（上面的 Preferences: Open User Settings (JSON)），所有项目共享。如果只想在某个项目生效，用 Preferences: Open Workspace Settings (JSON)，会写到项目下的 .vscode/settings.json。

⚠️ Workspace settings 别提交到 git，token 会泄漏。