常见问题

关于 Continue 的常见问题

网络问题

配置证书

如果您看到 fetch failed 错误，且您的网络需要自定义证书，则需要在配置文件中进行配置。在 "models" 数组的每个对象中，添加 requestOptions.caBundlePath，如下所示：

models:
  - name: My Model
    ...
    requestOptions:
      caBundlePath: /path/to/cert.pem

您也可以将 requestOptions.caBundlePath 设置为一个包含多个证书路径的数组。

Windows VS Code 用户：安装 win-ca 插件可能有助于 Continue 使用 Windows 证书存储，但 requestOptions.caBundlePath 是最可靠的修复方案。

常见 SSL 证书错误

如果您的日志中包含诸如 unable to verify the first certificate、self signed certificate in certificate chain、certificate verify failed 或 CERT_UNTRUSTED 等错误，说明 Continue 能够访问到端点，但无法验证其返回的 TLS 证书链。

在大多数情况下，解决方法是导出该端点的根证书或中间 CA 证书，并在模型配置中设置 requestOptions.caBundlePath。如果服务器还需要双向 TLS，请同时添加 requestOptions.clientCertificate。

关于使用 curl 和 openssl 进行逐步诊断的方法，请参阅排查 SSL 证书错误。

VS Code 代理设置

如果您正在使用 VS Code 并且请求需要通过代理发送，通常已经通过 VS Code 的代理服务器支持配置完成。要检查此功能是否开启，请使用 cmd/ctrl + , 打开设置，搜索 "Proxy Support"。除非设置为 "off"，否则 VS Code 负责处理到代理的请求。

code-server

Continue 可以在 code-server 中使用，但如果日志中出现“This is likely because the editor is not running in a secure context”的错误，请参阅其关于安全暴露 code-server 的文档。

VS Code 中配置更改未生效

如果您更改了配置（添加、修改或删除）但这些更改在 VS Code 的 Continue 插件中未显示，请尝试重新加载 VS Code 窗口：

打开命令面板 (cmd/ctrl + shift + P)
输入 "Reload Window"
选择重新加载选项

这将重启 VS Code 并重新加载所有插件，您的配置更改应可见。

默认情况下，Continue 窗口位于 VS Code 的左侧，但也可以拖动到右侧，我们在教程中推荐这样做。如果您之前安装过 Continue 并将其移动到了右侧，它可能仍然在那里。您可以通过 cmd/ctrl+L 或点击 VS Code 右上角的按钮打开右侧侧边栏来调出 Continue。

收到 OpenAI 的 404 错误

如果您输入了有效的 API 密钥和模型，但仍收到 OpenAI 的 404 错误，这可能是因为您需要在结算账户中充值。您可以从结算控制台进行操作。如果您想确认这确实是错误原因，可以尝试往账户里充值 1 美元，查看错误是否仍然存在。

收到 OpenRouter 的 404 错误

如果您输入了有效的 API 密钥和模型，但仍收到 OpenRouter 的 404 错误，这可能是因为不支持函数调用的模型在发送请求时会向 Continue 返回错误。错误示例：HTTP 404 Not Found from https://openrouter.ai/api/v1/chat/completions

索引问题

如果您在索引时遇到持续的错误，我们建议从头开始重建索引。注意，对于大型代码库，这可能需要一些时间。

您可以使用以下命令实现：Continue: Rebuild codebase index。

Agent 模式不可用或工具无法工作

如果 Agent 模式变灰或工具无法正常运行，这很可能是由于模型能力配置问题导致的。

对于不支持原生工具调用的模型，Continue 会自动使用系统消息工具作为备选方案，因此大多数模型应该能自动配合 Agent 模式使用。

检查您的模型是否支持工具

并非所有模型都支持原生工具/函数调用，但 Continue 会自动使用系统消息工具作为 fallback。
尝试在您的模型配置中添加 capabilities: ["tool_use"] 以强制启用工具支持。
验证您的提供商是否支持函数调用，或者系统消息工具是否工作正常。

工具无法工作

如果工具没有被调用：

确保 tool_use 在您的 capabilities 中。
检查您的 API 端点是否确实支持函数调用。
某些提供商可能会使用不同的函数调用格式。

图片无法上传

如果您无法上传图片：

在 capabilities 中添加 image_input。
确保您的模型确实支持视觉（例如 gpt-4-vision, claude-3）。
检查您的提供商是否透传了图片数据。

添加 capabilities

如果 Continue 的自动检测工作不正确，您可以手动在 config.yaml 中添加 capabilities。

models:
  - name: my-model
    provider: openai
    model: gpt-4
    capabilities:
      - tool_use
      - image_input

与提供商核实

某些代理服务（如 OpenRouter）或自定义部署可能不会保留工具调用能力。请查看您提供商的文档。

验证当前 Capabilities

查看 Continue 为您的模型检测到了哪些能力：

检查模式选择器的工具提示 - 它们会指示工具是否可用。
尝试上传一张图片 - 如果被禁用，则该模型缺少 image_input。
检查 Agent 模式是否可用 - 需要 tool_use。

请参阅模型能力指南获取完整的配置细节。

Android Studio - 聊天显示“Nothing to show”

可以通过选择 Actions > Choose Boot runtime for the IDE，然后选择最新版本，最后重启 Android Studio 来解决。详见此讨论贴。

收到“Codebase indexing disabled - Your Linux system lacks required CPU features (AVX2, FMA)”通知

我们使用 LanceDB 作为代码库搜索功能的向量数据库。在 x64 Linux 系统上，LanceDB 需要特定的 CPU 特性（FMA 和 AVX2），旧的处理器可能不支持。

大多数 Continue 功能（包括自动补全和聊天）仍能正常工作。但是，依赖代码库索引的命令（如 @codebase, @files 和 @folder）将被禁用。

关于此要求的更多详细信息，请参阅 LanceDB issue #2195。

Ollama 问题

关于设置和排查 Ollama 的全面指南，请参阅 Ollama 指南。

无法连接到本地 Ollama 实例

如果您收到“Unable to connect to local Ollama instance”错误：

验证 Ollama 是否正在运行：在浏览器检查 https://:11434 - 您应该看到“Ollama is running”。
正确启动 Ollama：使用 ollama serve（而不仅仅是 ollama run model-name）。
检查您的配置：确保您的 config.yaml 设置正确。

models:
  - name: llama3
    provider: ollama
    model: llama3:latest

连接远程 Ollama 失败 (EHOSTUNREACH/ECONNREFUSED)

当连接到另一台机器上的 Ollama 时：

配置 Ollama 以监听所有接口。:
- 设置环境变量：OLLAMA_HOST=0.0.0.0:11434。
- 对于 systemd：编辑 /etc/systemd/system/ollama.service 并在 [Service] 下添加。
```
Environment="OLLAMA_HOST=0.0.0.0:11434"
Environment="OLLAMA_ORIGINS=*"
```
- 重启 Ollama：sudo systemctl restart ollama。
更新您的 Continue 配置。:

models:
  - name: llama3
    provider: ollama
    apiBase: http://192.168.1.136:11434  # Use your server's IP
    model: llama3:latest

检查防火墙设置：确保服务器上开放了 11434 端口。

Ollama 在 WSL 中无法工作

针对遇到连接问题的 WSL 用户：

Windows 11 22H2+（推荐）

创建或编辑 %UserProfile%\.wslconfig。

[wsl2]
networkingMode=mirrored

然后重启 WSL：wsl --shutdown。

较旧的 Windows/WSL 版本

在 PowerShell（以管理员身份）中执行。

# Add firewall rules
New-NetFireWallRule -DisplayName 'WSL Ollama' -Direction Inbound -LocalPort 11434 -Action Allow -Protocol TCP
New-NetFireWallRule -DisplayName 'WSL Ollama' -Direction Outbound -LocalPort 11434 -Action Allow -Protocol TCP

# Get WSL IP (run 'ip addr' in WSL to find eth0 IP)
# Then add port proxy (replace <WSL_IP> with your actual IP)
netsh interface portproxy add v4tov4 listenport=11434 listenaddress=0.0.0.0 connectport=11434 connectaddress=<WSL_IP>

Docker 容器无法连接到宿主机的 Ollama

当在 Docker 中运行 Continue 或其他需要连接到宿主机 Ollama 的工具时：

Windows/Mac：使用 host.docker.internal。

models:
  - name: llama3
    provider: ollama
    apiBase: http://host.docker.internal:11434
    model: llama3:latest

Linux：使用 Docker 网桥 IP（通常是 172.17.0.1）。

models:
  - name: llama3
    provider: ollama
    apiBase: http://172.17.0.1:11434
    model: llama3:latest

Docker 运行命令：添加主机映射。

docker run -d --add-host=host.docker.internal:host-gateway ...

远程 Ollama 解析错误

如果您在连接远程 Ollama 时遇到解析错误：

验证模型是否已安装在远程端。:

OLLAMA_HOST=192.168.1.136:11434 ollama list

安装缺失的模型。:

OLLAMA_HOST=192.168.1.136:11434 ollama pull llama3

检查 URL 格式：确保本地网络地址使用的是 http:// 而不是 https://。

本地配置

管理本地密钥和环境变量

如需完全离线运行 Continue，请参阅离线运行 Continue 指南。

如何在 config.yaml 中引用密钥

在 config.yaml 中的任何位置使用 ${{ secrets.SECRET_NAME }} 语法。

models:
  - provider: openai
    apiKey: ${{ secrets.OPENAI_API_KEY }}

密钥的解析来源

当 Continue 遇到 ${{ secrets.X }} 时，它会按顺序搜索以下来源：

工作区 .env 文件：<workspace-root>/.env
工作区 Continue .env 文件：<workspace-root>/.continue/.env
全局 .env 文件：~/.continue/.env
进程环境变量：标准的系统环境变量。

IDE 插件（VS Code, JetBrains）无法读取您的 Shell 环境变量。 在终端设置 export OPENAI_API_KEY=... 并不会让密钥在 IDE 内部运行的 Continue 中可用。您必须使用 .env 文件。

进程环境变量（来源 4）仅在使用 Continue CLI 时有效，您可以直接传入：export OPENAI_API_KEY=sk-... && cn。

创建 `.env` 文件

在上述位置之一创建 .env 文件。使用标准 dotenv 格式。

OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
CUSTOM_API_URL=https://api.example.com

永远不要将 .env 文件提交到版本控制系统 — 将它们加入 .gitignore。
值不需要加引号。
添加或更改密钥后请重启您的 IDE。

本地使用模型插件 (Model Addons)

您可以利用 Continue Mission Control 的模型插件，通过 uses: 语法在本地配置中使用它们。这允许您引用预配置的模型块而无需重复配置。

要求

您必须登录到 Continue。
需要互联网连接（模型插件从 Mission Control 获取）。

用法

在本地 config.yaml 中，使用 provider/model-name 的格式引用模型插件。

name: My Local Config
version: 0.0.1
schema: v1
models:
  - uses: ollama/llama3.1-8b
  - uses: anthropic/claude-sonnet-4-6
  - uses: openai/gpt-4

结合本地配置

您可以将 Hub 模型插件与本地模型结合使用。

name: My Local Config
version: 0.0.1
schema: v1
models:
  # Hub model addon
  - uses: anthropic/claude-sonnet-4-6
  
  # Local model configuration
  - name: Local Ollama
    provider: ollama
    model: codellama:latest
    apiBase: http://:11434

覆盖插件设置

您可以覆盖模型插件中的特定设置。

models:
  - uses: ollama/llama3.1-8b
    override:
      apiBase: http://192.168.1.100:11434  # Use remote Ollama server
      roles:
        - chat
        - autocomplete

此功能允许您在整个团队中保持一致的模型配置，同时在需要时允许进行本地自定义。

如何重置插件状态？

Continue 将其数据存储在 ~/.continue 目录中（Windows 上为 %USERPROFILE%\.continue）。

如果您想执行彻底的重置，包括删除所有配置文件、索引等，可以删除此目录，卸载并重新安装。

仍然遇到问题？

您可以加入 GitHub Discussions 获取额外支持。或者，您可以在此创建 GitHub Issue，提供您问题的详细信息，以便我们更快地为您提供帮助。

如何自托管模型故障排查