# 在 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

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

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

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

## 3. 加配置

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

```json
{
  "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` 超高推理，把模型和推理强度变量也放进去：

```json
{
  "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`，能回复就通了。

再到 [仪表盘 → 使用记录](https://4aicode.com/dashboard) 确认对应调用。

## 常见问题

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

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

1. `claudeCode.environmentVariables` 拼错 / 嵌在别的 key 下 —— 回 settings.json 检查
2. 没完全重启 —— 托盘图标、任务管理器里的 `Code.exe` 全部杀掉再开
3. 用了 `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 会泄漏。