VS Code 插件接入

不同 VS Code AI 插件支持的协议不同，不能把一组配置套到所有插件。先确认插件 支持自定义 Provider 或网关地址。

怎么选择

插件类型	推荐配置
OpenAI Codex 官方扩展	使用 Codex config.toml
Claude Code 官方扩展	使用 Claude Code 环境变量
支持 OpenAI Compatible 的第三方插件	手动填写 Provider、Base URL、Key、Model
只支持官方账号登录的插件	无法直接使用自定义 FreedomZ AI Base URL

通用 OpenAI Compatible 配置

插件明确支持自定义 OpenAI Provider 时填写：

字段	填写
Provider	OpenAI Compatible、Custom OpenAI 或同义选项
API Key	控制台创建的完整密钥
Base URL	https://freedomz.cn/v1
Model	当前 Key 的 /v1/models 返回值

插件会自动追加 /v1 时，Base URL 改为 https://freedomz.cn。

Codex 官方扩展

官方扩展和 Codex CLI 共用 $CODEX_HOME/config.toml。按 Codex 接入 定义 freedomz Provider 后：

1. 确保 VS Code 进程能读取 FREEDOMZ_API_KEY。
2. 重新加载 VS Code 窗口。
3. 确认当前模型和 Provider。
4. 发起最小请求并核对使用记录。

Claude Code 官方扩展

在 VS Code 用户设置 JSON 中配置：

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://freedomz.cn" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "YOUR_API_KEY" },
    { "name": "ANTHROPIC_MODEL", "value": "MODEL_ID_FROM_V1_MODELS" }
  ]
}

此方式会在 VS Code 设置中保存密钥。共享电脑应改用受控环境变量或凭据管理， 不要同步包含真实密钥的设置。

配置后验证

1. 重新加载 VS Code 窗口。
2. 发送不带工具和附件的测试请求。
3. 打开 使用记录。
4. 核对时间、Key、模型和费用。

常见问题

现象	处理
找不到自定义 Provider	插件可能只支持官方账号，查看插件说明
Base URL 报路径错误	检查是否重复拼接 /v1
终端可用、扩展不可用	VS Code 未继承环境变量，重新启动整个应用
能回复但站内无记录	插件仍在官方账号或旧 Provider 模式
401 / 403	停止重试，不要自动切换其他 Key