7418andClaude Opus 4.6
8372a3f548
- installation.mdx: expand "First Launch" into detailed Setup Center walkthrough covering CLI detection, provider configuration, and project directory setup - installation.mdx: add "Claude Code Conflicts" section with detection logic, uninstall commands per install type, and recommended installation method - faq.mdx: add troubleshooting entries for CLI not detected, multi-version conflicts, and Setup Center auto-open behavior - providers.mdx: mention ANTHROPIC_AUTH_TOKEN alongside API_KEY for env detection All changes in both English and Chinese versions. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
159 lines
6.7 KiB
Plaintext
159 lines
6.7 KiB
Plaintext
---
|
||
title: 服务商配置
|
||
description: 配置 LLM 服务商以驱动 CodePilot。
|
||
---
|
||
|
||
# 服务商配置
|
||
|
||
CodePilot 支持多种 LLM 服务商。你可以同时配置多个服务商，在不同对话中使用不同的模型。
|
||
|
||
## 认证方式概览
|
||
|
||
CodePilot 有两种获取 API 凭据的途径：
|
||
|
||
### 1. CLI 环境认证（自动检测）
|
||
|
||
如果你在 shell 环境中设置了 `ANTHROPIC_API_KEY` 或 `ANTHROPIC_AUTH_TOKEN` 环境变量，CodePilot 启动时会**自动检测**并作为内置服务商使用。设置中心也会检查这些凭据，如果检测到会自动将服务商步骤标记为已完成。
|
||
|
||
```bash
|
||
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 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
|
||
|
||
## 添加服务商
|
||
|
||
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 密钥可填任意值（本地服务通常不校验）。
|