Claude Code 配置（VS Code）

在 VS Code 中安装 Claude Code 插件后，把它指向 CQT AI 网关，即可在编辑器内使用平台的 Claude 兼容模型。

前置条件

已申请 CQT AI 的 APIKey（在控制台「APIKey 管理」创建）。
已安装 VS Code 与「Claude Code for VS Code」插件。

第一步：打开设置文件

在 VS Code 中：右键「Claude Code for VS Code」插件 → 设置 → 在 settings.json 中编辑配置（或 Ctrl+Shift+P 运行「Preferences: Open User Settings (JSON)」）。

第二步：写入配置

把以下内容合并进 settings.json（ANTHROPIC_AUTH_TOKEN 的 value 填你的 APIKey）：

{
  "permissions": {
    "allow": [
      "Read",
      "Edit",
      "Glob",
      "Grep",
      "Docker",
      "mvn",
      "Bash(npm run test)",
      "Bash(npm run build)",
      "Bash(git status)",
      "Bash(git diff)",
      "COMPOSE_HTTP_TIMEOUT"
    ],
    "deny": ["Bash(rm -rf *)", "Bash(git push)"]
  },
  "claudeCode.preferredLocation": "panel",
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "你的APIKey" },
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.cqtai.com" },
    { "name": "ANTHROPIC_MODEL", "value": "claude-opus-4-8" },
    { "name": "CLAUDE_CODE_SUBAGENT_MODEL", "value": "claude-opus-4-8" },
    { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "claude-opus-4-8" },
    { "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "claude-sonnet-4-6" },
    { "name": "CLAUDE_CODE_SKIP_AUTH_LOGIN", "value": "1" },
    { "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "value": "1" },
    { "name": "CLAUDE_CODE_ATTRIBUTION_HEADER", "value": "0" }
  ],
  "files.autoGuessEncoding": true,
  "workbench.activityBar.compact": true
}

第三步：保存并重启

保存 settings.json，重启 VS Code 使配置生效。

配置说明

permissions（权限控制）

控制 Claude Code 可执行的操作，提升安全性：

allow：白名单。允许的工具/命令，如 Read（读文件）、Edit（改文件）、Glob/Grep（搜索）、Docker、mvn，以及指定的 Bash 命令（Bash(npm run test)、Bash(git status) 等）。
deny：黑名单。禁止的危险命令，如 Bash(rm -rf *)（删库）、Bash(git push)（推送）。

黑名单优先级高于白名单；未在 allow 中的操作会按插件默认策略询问。

claudeCode.preferredLocation

Claude Code 面板位置，panel 表示停靠在底部面板。

claudeCode.environmentVariables（核心）

接入 CQT AI 的关键，逐项说明：

变量	作用
`ANTHROPIC_AUTH_TOKEN`	你的 CQT AI APIKey（鉴权用）
`ANTHROPIC_BASE_URL`	CQT AI 网关地址 `https://api.cqtai.com`
`ANTHROPIC_MODEL`	默认使用的模型，如 `claude-opus-4-8`
`CLAUDE_CODE_SUBAGENT_MODEL`	子任务（subagent）使用的模型
`ANTHROPIC_DEFAULT_OPUS_MODEL`	Opus 档位默认模型
`ANTHROPIC_DEFAULT_SONNET_MODEL`	Sonnet 档位默认模型，如 `claude-sonnet-4-6`
`CLAUDE_CODE_SKIP_AUTH_LOGIN`	`1` 跳过官方登录流程（用网关 Key 鉴权时需要）
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`	`1` 关闭非必要流量上报
`CLAUDE_CODE_ATTRIBUTION_HEADER`	`0` 关闭归因头

其它

files.autoGuessEncoding：自动识别文件编码。
workbench.activityBar.compact：活动栏紧凑显示（与 Claude Code 无关，可选）。

常见问题

插件不生效：确认在「用户 settings.json」而非工作区设置中配置，保存后完全重启 VS Code。
401 认证失败：检查 ANTHROPIC_AUTH_TOKEN 是否填对、无多余空格；确认 APIKey 未禁用。
模型不可用：确认 ANTHROPIC_MODEL 等模型名在平台可用（见「对话」模型列表）。