OpenCode 环境变量配置指南
在使用 OpenCode 时，用户常遇到'认证失败'或'API 密钥无效'的错误提示。本文将介绍环境变量的配置方法与常见问题排查。
为什么配置会失败？
常见的配置陷阱包括：
1. 环境变量设置错误
- 变量名拼写不正确
- 值前后有空格或特殊字符
- 未在正确的 shell 中设置
2. 配置文件优先级混淆
- 不知道系统会读取哪个配置文件
- 多个配置文件间存在冲突
3. API 密钥问题
- 密钥已过期或被吊销
- 未正确复制完整密钥
- 账户余额不足或配额用完
5 步快速配置法
第一步：选择 AI 服务商
根据需求和预算选择主要 AI 服务商：
| 服务商 | 特点 | 适合场景 |
|---|---|---|
| OpenAI | 响应快，模型新 | 代码生成、快速迭代 |
| Anthropic | 上下文长，逻辑强 | 复杂任务、文档分析 |
| Azure OpenAI | 国内稳定 | 企业环境、国内用户 |
| Gemini | 免费额度多 | 学习使用、预算有限 |
第二步：获取 API 密钥
以 OpenAI 为例：
- 访问 https://platform.openai.com/account/api-keys
- 点击'Create new secret key'
- 复制生成的密钥（注意：只会显示一次）
第三步：设置环境变量
在终端中执行以下命令（替换为你的实际密钥）：
export OPENAI_API_KEY="sk-你的实际密钥"
第四步：验证配置
检查环境变量是否设置成功：
echo $OPENAI_API_KEY
如果显示你的密钥，说明设置成功。
第五步：重启 OpenCode
关闭并重新打开 OpenCode，现在你应该可以正常使用 AI 功能了。
进阶配置
多模型协同配置
{
"providers": {
"openai"
