VS Code 扩展配置 — Cline / Roo Code / Continue
在 VS Code 的 Cline、Roo Code、Continue 等 AI 编程扩展中接入 Claude API,中国大陆免 VPN。
LLMsRelay 是独立运营的 API 网关,与 Anthropic, PBC 无隶属或授权关系。产品和模型名称仅用于说明兼容性。
Cline 配置
- 在 VS Code 安装 Cline 扩展。
- 打开 Cline 设置,选择 API Provider: OpenAI Compatible。
- 填入 API Key:
sk-cs4-... - 填入 Custom Base URL:
https://api.llmsrelay.com/v1 - 选择模型
claude-sonnet-4.6
Roo Code 配置
同 Cline,配置方式完全一致。Roo Code 是 Cline 的多 Agent 分支版本。
Continue 配置
编辑 ~/.continue/config.json:
{
"models": [{
"title": "Claude Sonnet 4.6",
"provider": "anthropic",
"model": "claude-sonnet-4.6",
"apiKey": "sk-cs4-...",
"apiBase": "https://api.llmsrelay.com"
}]
}Kilo Code 配置
Kilo Code 使用两个独立的自定义 provider:Anthropic Messages 用于 Claude,OpenAI Responses 用于 GPT/Codex。不要把两种协议合并到一个 provider。
选择正确的密钥分组
1. 添加 provider
在 Kilo 的 provider 设置中添加,或编辑用户级别的 kilo.jsonc:
{
"$schema": "https://app.kilo.ai/config.json",
"provider": {
"llmsrelay-anthropic": {
"name": "LLMsRelay Anthropic Messages",
"npm": "@ai-sdk/anthropic",
"options": {
"baseURL": "https://api.llmsrelay.com/v1"
},
"models": {
"claude-opus-5": { "name": "claude-opus-5", "reasoning": true },
"claude-fable-5": { "name": "claude-fable-5", "reasoning": true },
"claude-opus-4.8": { "name": "claude-opus-4.8", "reasoning": true },
"claude-opus-4.7": { "name": "claude-opus-4.7", "reasoning": true },
"claude-opus-4.6": { "name": "claude-opus-4.6", "reasoning": true },
"claude-sonnet-5": { "name": "claude-sonnet-5", "reasoning": true },
"claude-sonnet-4.6": { "name": "claude-sonnet-4.6", "reasoning": true },
"claude-haiku-4.5": { "name": "claude-haiku-4.5", "reasoning": true }
}
},
"llmsrelay-openai": {
"name": "LLMsRelay OpenAI Responses",
"npm": "@ai-sdk/openai",
"env": ["OPENAI_API_KEY"],
"options": {
"baseURL": "https://api.llmsrelay.com/v1"
},
"models": {
"gpt-5.3-codex-spark": { "name": "gpt-5.3-codex-spark", "reasoning": true },
"gpt-5.4-mini": { "name": "gpt-5.4-mini", "reasoning": true },
"gpt-5.4": { "name": "gpt-5.4", "reasoning": true },
"codex-auto-review": { "name": "codex-auto-review", "reasoning": true },
"gpt-5.3-codex-spark-openai-compact": { "name": "gpt-5.3-codex-spark-openai-compact", "reasoning": true },
"gpt-5.5": { "name": "gpt-5.5", "reasoning": true },
"gpt-5.5-openai-compact": { "name": "gpt-5.5-openai-compact", "reasoning": true },
"gpt-5.6-terra": { "name": "gpt-5.6-terra", "reasoning": true },
"gpt-5.4-openai-compact": { "name": "gpt-5.4-openai-compact", "reasoning": true },
"gpt-5.4-mini-openai-compact": { "name": "gpt-5.4-mini-openai-compact", "reasoning": true },
"gpt-5.6-sol": { "name": "gpt-5.6-sol", "reasoning": true }
}
}
}
}2. 安全添加 API Key
通过 Kilo 的 credentials 对话框或 /connect 为 Anthropic provider 添加 Basic 密钥,为 OpenAI provider 添加单独的 Codex 密钥。请使用不同的占位符: sk-cs4-YOUR_BASIC_KEY 和 sk-cs4-YOUR_CODEX_KEY。不要把真实 Key 写入 kilo.jsonc、项目文件、截图或公开仓库。
3. 选择模型
使用 GET /v1/models 返回的完整模型 ID。Claude 从 Anthropic provider 选择,GPT/Codex 从 OpenAI Responses provider 选择,例如 gpt-5.5。Claude 使用 /v1/messages, OpenAI 使用 /v1/responses。
Windows 配置(适用于全部扩展)
在 Windows 上,Continue、Cline、Roo Code 和 Kilo Code 使用同一个 gateway,但 provider 模式不同。 先完成下面的通用步骤,再按扩展专属说明配置。
1. 准备
- VS Code 1.80+(建议最新版)
- Node.js LTS — 仅 Continue 的 CLI / MCP 模式需要。在 PowerShell 执行
node -v验证。 - 从面板获取的 LLMsRelay 密钥:Claude 用
sk-cs4-YOUR_BASIC_KEY,OpenAI 用sk-cs4-YOUR_CODEX_KEY。
2. 设置环境变量(PowerShell)
打开 PowerShell(不要使用 cmd.exe)执行以下命令。setx 会将变量写入用户配置,新打开的终端与进程都会读取到。
setx ANTHROPIC_BASE_URL "https://api.llmsrelay.com"
setx ANTHROPIC_API_KEY "sk-cs4-YOUR_BASIC_KEY"
setx OPENAI_BASE_URL "https://api.llmsrelay.com/v1"
setx OPENAI_API_KEY "sk-cs4-YOUR_CODEX_KEY"GUI 方式:Win+R → 输入 sysdm.cpl →高级 →环境变量,在「用户变量」中添加上述 5 个变量。
3. 完全重启 VS Code
VS Code 仅在启动时读取环境变量。执行 setx 后请关闭所有 VS Code 窗口, 打开任务管理器(Ctrl+Shift+Esc)结束所有 Code.exe 进程后重新打开,否则扩展仍读取旧值。
4. 各扩展的 Windows 注意事项
- Continue — 配置文件位于
%USERPROFILE%\.continue\config.yaml。可通过notepad %USERPROFILE%\.continue\config.yaml打开。 - Cline / Roo Code — 在扩展设置中选择 OpenAI Compatible, 填入 Base URL
https://api.llmsrelay.com/v1与 API Key。 步骤 2 的环境变量作为默认值生效,UI 中填入的值优先级更高。 - Kilo Code — 使用上方 Kilo Code 配置中的两个自定义 provider。通过 Kilo credentials 或
/connect管理 Key,并选择GET /v1/models返回的完整模型 ID。
5. WSL / Remote-WSL 用户
Windows 的环境变量不会传递到 WSL。请在 WSL 内的 ~/.bashrc(或 ~/.zshrc)中追加:
export ANTHROPIC_BASE_URL="https://api.llmsrelay.com"
export ANTHROPIC_API_KEY="sk-cs4-YOUR_BASIC_KEY"
export OPENAI_BASE_URL="https://api.llmsrelay.com/v1"
export OPENAI_API_KEY="sk-cs4-YOUR_CODEX_KEY"6. 常见问题
setx不会影响当前终端,请新开一个窗口。- PowerShell 中务必使用双引号包裹值,特别是包含
/的 URL。 - 公司代理:额外执行
setx HTTPS_PROXY "http://proxy.company:8080"。 - 杀毒软件 / 防火墙拦截:请将
api.llmsrelay.com加入白名单。 - 调用了错误的模型 — 请参阅 Claude Code 常见配置错误。
使用了错误的模型?
检查 ANTHROPIC_MODEL 冲突