VS Code + Continue 接入 Claude API 完整配置教程（含排障）

环境说明

• VS Code 版本：1.90+
• Continue 插件版本：0.9+
• API 服务：claudeapi.com（OpenAI 兼容接口）
• 接口地址：https://gw.claudeapi.com/v1

一、安装 Continue 插件

打开 VS Code，按Ctrl+Shift+X（macOS：⌘+Shift+X）打开扩展面板，搜索Continue，安装发布者为 Continue Dev Inc. 的插件。

安装完成后，左侧活动栏出现 Continue 图标，配置文件自动生成：

二、config.json 完整配置

2.1 基础单模型配置

{"models":[{"title":"Claude Sonnet 4.6","provider":"openai","model":"claude-sonnet-4-6","apiKey":"YOUR_API_KEY","apiBase":"https://gw.claudeapi.com/v1"}]}

关键字段说明：

• provider：必须为"openai"，claudeapi.com 提供 OpenAI 兼容接口
• apiBase：固定为https://gw.claudeapi.com/v1，末尾不加斜杠
• model：Claude 模型名称，必须完整（见下表）

2.2 生产推荐配置（多模型 + Tab 补全）

{"models":[{"title":"Claude Sonnet 4.6（主力）","provider":"openai","model":"claude-sonnet-4-6","apiKey":"YOUR_API_KEY","apiBase":"https://gw.claudeapi.com/v1"},{"title":"Claude Opus 4.8（复杂任务）","provider":"openai","model":"claude-opus-4-8","apiKey":"YOUR_API_KEY","apiBase":"https://gw.claudeapi.com/v1"},{"title":"Claude Haiku 4.5（快速问答）","provider":"openai","model":"claude-haiku-4-5-20251001","apiKey":"YOUR_API_KEY","apiBase":"https://gw.claudeapi.com/v1"}],"tabAutocompleteModel":{"title":"Haiku 补全","provider":"openai","model":"claude-haiku-4-5-20251001","apiKey":"YOUR_API_KEY","apiBase":"https://gw.claudeapi.com/v1","tabAutocompleteOptions":{"maxPromptTokens":2048,"prefixPercentage":0.85}},"contextProviders":[{"name":"code"},{"name":"docs"},{"name":"diff"},{"name":"terminal"}]}

2.3 支持的模型名称

（价格来源：claudeapi.com 控制台）

三、验证配置是否生效

保存config.json后，切换到 Continue 侧边栏（Ctrl+Shift+L），在对话框输入测试消息：

用 Python 写一个快速排序函数，添加类型注解

模型正常响应即配置成功。

使用 curl 直接验证接口可用性

curl-shttps://gw.claudeapi.com/v1/chat/completions\-H"Content-Type: application/json"\-H"Authorization: Bearer YOUR_API_KEY"\-d'{ "model": "claude-haiku-4-5-20251001", "messages": [{"role": "user", "content": "ping"}], "max_tokens": 10 }'

返回choices[0].message.content有内容即表示接口正常。

四、Tab 代码补全配置详解

Tab 补全对延迟要求严格，需要独立配置轻量模型：

"tabAutocompleteModel":{"title":"Haiku 补全","provider":"openai","model":"claude-haiku-4-5-20251001","apiKey":"YOUR_API_KEY","apiBase":"https://gw.claudeapi.com/v1","tabAutocompleteOptions":{"maxPromptTokens":2048,"debounceDelay":300,"multilineCompletions":"auto"}}

参数说明：

• maxPromptTokens：发送给模型的最大上下文 token 数，降低此值可减少延迟，2048 是合理的平衡点
• debounceDelay：停止输入后多少毫秒触发补全请求（毫秒），默认 300
• multilineCompletions："auto"让模型决定是否多行补全

Tab 键接受建议，Esc拒绝，Alt+]/Alt+[在多个候选间切换（若有）。

五、使用 system prompt 统一代码风格

在 models 数组中每个模型对象里添加systemMessage：

{"title":"Claude Sonnet 4.6（TypeScript专用）","provider":"openai","model":"claude-sonnet-4-6","apiKey":"YOUR_API_KEY","apiBase":"https://gw.claudeapi.com/v1","systemMessage":"你是一个专注于 TypeScript 的代码助手。始终添加完整的 JSDoc 注释，使用严格类型，避免 any 类型。"}

六、常见错误排查

错误 1：401 Unauthorized

{"error":{"message":"Invalid API key","type":"authentication_error"}}

原因：API Key 错误或已过期。
解决：重新在 claudeapi.com 控制台复制 Key，注意不要携带多余空格或换行符。

# 检查 Key 格式（应以 sk- 开头，无空格）echo-n"YOUR_API_KEY"|wc-c

错误 2：404 Not Found

{"error":{"message":"Not Found","type":"invalid_request_error"}}

原因：apiBase路径错误，通常是缺少/v1。
解决：

// ❌ 错误"apiBase":"https://gw.claudeapi.com/"// ✅ 正确"apiBase":"https://gw.claudeapi.com/v1"

错误 3：model_not_found

{"error":{"message":"model not found: claude-haiku-4-5"}}

原因：模型名称不完整。
解决：使用完整名称claude-haiku-4-5-20251001。

错误 4：Tab 补全不触发

1. 确认tabAutocompleteModel字段存在且格式正确
2. 检查 VS Code 设置中 Continue 的补全开关是否启用（Continue: Enable Tab Autocomplete）
3. 在.continue/config.json修改后需要重启 VS Code

错误 5：连接超时（ETIMEDOUT）

原因：网络问题，或apiBase地址填写有误。
解决：先用 curl 命令（见第三节）单独测试接口连通性，排除网络问题。

七、完整 config.json 示例

以下是一个完整的生产配置，可直接使用（替换 YOUR_API_KEY）：

{"models":[{"title":"Claude Sonnet 4.6","provider":"openai","model":"claude-sonnet-4-6","apiKey":"YOUR_API_KEY","apiBase":"https://gw.claudeapi.com/v1","systemMessage":"你是一个有经验的软件工程师，代码简洁、可读性强，注释用中文。"},{"title":"Claude Opus 4.8","provider":"openai","model":"claude-opus-4-8","apiKey":"YOUR_API_KEY","apiBase":"https://gw.claudeapi.com/v1"},{"title":"Claude Haiku 4.5","provider":"openai","model":"claude-haiku-4-5-20251001","apiKey":"YOUR_API_KEY","apiBase":"https://gw.claudeapi.com/v1"}],"tabAutocompleteModel":{"title":"Haiku 补全","provider":"openai","model":"claude-haiku-4-5-20251001","apiKey":"YOUR_API_KEY","apiBase":"https://gw.claudeapi.com/v1","tabAutocompleteOptions":{"maxPromptTokens":2048,"debounceDelay":300,"multilineCompletions":"auto"}},"contextProviders":[{"name":"code"},{"name":"docs"},{"name":"diff"},{"name":"terminal"},{"name":"problems"}],"slashCommands":[{"name":"edit","description":"对选中代码进行修改"},{"name":"comment","description":"为代码添加注释"},{"name":"share","description":"分享当前对话"},{"name":"cmd","description":"生成终端命令"}]}