环境说明

• 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 图标，配置文件自动生成：

系统	配置文件路径
macOS	~/.continue/config.json
Linux	~/.continue/config.json
Windows	%USERPROFILE%\.continue\config.json

---

二、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 支持的模型名称

模型	完整名称	输入价格	输出价格
Haiku 4.5	claude-haiku-4-5-20251001	$0.8/MTok	$4/MTok
Sonnet 4.6	claude-sonnet-4-6	$2.4/MTok	$12/MTok
Opus 4.8	claude-opus-4-8	$4/MTok	$20/MTok

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

---

三、验证配置是否生效

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

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

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

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

curl -s https://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": "生成终端命令" }
  ]
}