CodePilotCodePilot

服务商配置

配置 LLM 服务商以驱动 CodePilot。

服务商配置

CodePilot 支持多种 LLM 服务商。你可以同时配置多个服务商,在不同对话中使用不同的模型。

认证方式概览

CodePilot 有两种获取 API 凭据的途径:

1. CLI 环境认证(自动检测)

如果你在 shell 环境中设置了 ANTHROPIC_API_KEY 环境变量,CodePilot 启动时会自动检测并作为内置服务商使用。

export ANTHROPIC_API_KEY="sk-ant-..."

注意: 通过 claude config set 或 Claude Code 的 /config 命令切换的配置不会被 CodePilot 识别。CodePilot 只读取 shell 环境变量,不共享 Claude Code CLI 的内部配置。如果你在 CLI 中通过 cc switch 或类似方式切换了账号/密钥,需要在 CodePilot 的 设置 > 服务商 中重新手动配置对应的密钥。

修改环境变量后需要重启 CodePilot 才能生效。

2. 手动添加服务商

设置 > 服务商 中手动添加 API 密钥。这些凭据存储在 CodePilot 本地数据库中,与 CLI 环境相互独立。

适合需要使用多个服务商、或使用非 Anthropic 服务的场景。

优先级

当发送消息时,CodePilot 按以下顺序确定使用哪个服务商:

  1. 对话指定 — 对话头部手动选择的服务商
  2. 全局默认 — 在服务商列表中标记为"默认"的服务商
  3. 环境变量 — 如果没有配置任何服务商,回退到 shell 环境中的凭据

支持的服务商

Anthropic(官方)

直接连接 Anthropic API,使用 Claude 模型(Opus、Sonnet、Haiku)。

  • 认证:API 密钥
  • 说明:如果你只使用 Anthropic,通过 CLI 环境认证即可,无需手动添加

Anthropic(第三方兼容)

连接兼容 Anthropic API 格式的第三方端点。

  • 认证:API 密钥或 Auth Token + 自定义基础 URL。添加时需要选择认证类型:
    • API Key — 服务商提供的密钥以 sk- 开头,或者文档中明确标注为 API Key。大多数服务商使用这种方式,对应环境变量 ANTHROPIC_API_KEY
    • Auth Token — 服务商提供的是 OAuth Token 或其他形式的访问令牌,通常不以 sk- 开头。部分订阅制服务(如 Kimi Coding Plan、火山引擎 Ark)使用这种方式,对应环境变量 ANTHROPIC_AUTH_TOKEN
    • 如果不确定,先尝试 API Key;如果认证失败,切换为 Auth Token 再试
  • 模型映射:部分第三方服务商要求使用自己的模型名称(而非 Anthropic 原始模型名)。如果遇到模型不可用的错误,点击配置表单底部的 更多选项,在 模型名称 字段中填写该服务商要求的模型标识符

国内服务商

CodePilot 内置了国内主流服务商的配置预设,选择后自动填充基础 URL 和默认模型:

服务商说明认证方式
智谱 GLM(国内版)智谱 AI GLM 系列API 密钥
智谱 GLM(国际版)智谱 AI 国际端点API 密钥
Kimi Coding Plan月之暗面 Kimi 编程版Auth Token
Moonshot月之暗面 Moonshot APIAPI 密钥
MiniMax(国内版)MiniMax abab 系列API 密钥
MiniMax(国际版)MiniMax 国际端点API 密钥
火山引擎 Ark字节跳动火山引擎Auth Token
阿里云百炼 Coding Plan阿里云通义系列API 密钥

Auth Token 类型:Kimi Coding Plan 和火山引擎 Ark 使用 ANTHROPIC_AUTH_TOKEN 而非 ANTHROPIC_API_KEY 进行认证。在 CodePilot 中添加时,系统会自动处理认证方式,你只需填写对应平台提供的密钥。

OpenRouter

通过 OpenRouter 统一接口访问多家模型服务商(Anthropic、OpenAI、Google、Meta 等)。

  • 认证:API 密钥
  • 优势:一个密钥访问多种模型,自动路由和故障转移

AWS Bedrock

通过 AWS 基础设施使用 Claude。

  • 认证:环境变量方式,需要 AWS_ACCESS_KEY_IDAWS_SECRET_ACCESS_KEYAWS_REGION
  • 说明:在 CodePilot 中添加后,系统会读取你的 AWS 环境变量进行认证。不需要在界面中填写密钥。

Google Vertex

通过 Google Cloud 使用 Claude 和 Gemini。

  • 认证:环境变量方式,需要 Google Cloud 服务账号凭证
  • 说明:与 Bedrock 类似,通过环境变量认证

Google Gemini (Image)

Gemini 图片生成 API,供设计 Agent 使用。

  • 认证:API 密钥
  • 说明:这是专门用于图片生成的服务商,不用于文本对话

Custom API(OpenAI 兼容)

任何兼容 OpenAI Chat Completions API 的端点。

  • 认证:API 密钥 + 基础 URL
  • 用途:接入本地模型(Ollama、LM Studio、vLLM)或其他第三方代理

LiteLLM

统一代理,支持 100+ LLM 服务商。

  • 认证:API 密钥 + 基础 URL

添加服务商

  1. 打开 设置 > 服务商
  2. 点击 添加服务商
  3. 选择服务商类型(或国内预设)
  4. 填写凭据:
    • API 密钥类:粘贴密钥
    • 自定义端点:还需填写基础 URL
    • 环境变量类(Bedrock / Vertex):确保环境变量已设置
  5. 选择默认模型
  6. 点击 保存

切换服务商

  • 在对话头部的服务商选择器中选择
  • 每个对话会记住所用的服务商
  • 可以在对话中途切换,切换后的消息使用新服务商
  • 在服务商列表中点击 设为默认 可设置全局默认

常见问题

已设置环境变量但 CodePilot 没有检测到

  • 确认环境变量在 CodePilot 启动时的 shell 环境中可用
  • 如果通过 .zshrc / .bashrc 设置,确保修改后重启了 CodePilot(不是刷新)
  • macOS 通过 Launchpad 启动的应用可能不继承终端环境变量,建议从终端启动或使用手动添加服务商

API 密钥有效但请求失败

  • 检查账户是否有余额
  • 检查密钥是否有模型访问权限
  • 国内服务商检查网络是否可达对应 API 端点
  • AWS Bedrock 检查 IAM 权限是否包含 bedrock:InvokeModel

切换服务商后对话异常

  • 不同服务商的上下文窗口大小不同,切换后可能因上下文过长导致报错
  • 部分服务商不支持 Claude Code 的所有功能(如工具使用),切换后某些操作可能不可用

如何使用本地模型

选择 Custom API(OpenAI 兼容) 类型,基础 URL 填写本地服务地址(如 http://localhost:11434/v1)。API 密钥可填任意值(本地服务通常不校验)。