服务商配置
配置 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 按以下顺序确定使用哪个服务商:
- 对话指定 — 对话头部手动选择的服务商
- 全局默认 — 在服务商列表中标记为"默认"的服务商
- 环境变量 — 如果没有配置任何服务商,回退到 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 再试
- API Key — 服务商提供的密钥以
- 模型映射:部分第三方服务商要求使用自己的模型名称(而非 Anthropic 原始模型名)。如果遇到模型不可用的错误,点击配置表单底部的 更多选项,在 模型名称 字段中填写该服务商要求的模型标识符
国内服务商
CodePilot 内置了国内主流服务商的配置预设,选择后自动填充基础 URL 和默认模型:
| 服务商 | 说明 | 认证方式 |
|---|---|---|
| 智谱 GLM(国内版) | 智谱 AI GLM 系列 | API 密钥 |
| 智谱 GLM(国际版) | 智谱 AI 国际端点 | API 密钥 |
| Kimi Coding Plan | 月之暗面 Kimi 编程版 | Auth Token |
| Moonshot | 月之暗面 Moonshot API | API 密钥 |
| 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_ID、AWS_SECRET_ACCESS_KEY、AWS_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
添加服务商
- 打开 设置 > 服务商
- 点击 添加服务商
- 选择服务商类型(或国内预设)
- 填写凭据:
- API 密钥类:粘贴密钥
- 自定义端点:还需填写基础 URL
- 环境变量类(Bedrock / Vertex):确保环境变量已设置
- 选择默认模型
- 点击 保存
切换服务商
- 在对话头部的服务商选择器中选择
- 每个对话会记住所用的服务商
- 可以在对话中途切换,切换后的消息使用新服务商
- 在服务商列表中点击 设为默认 可设置全局默认
常见问题
已设置环境变量但 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 密钥可填任意值(本地服务通常不校验)。