陈少文的博客
·
OpenCode 自定义模型配置与使用技巧
内容提要
本文介绍了如何配置 OpenCode 接入 OpenAI Chat Completions API。用户需安装 opencode-ai，并在配置文件中设置网关地址和 API 密钥。提供了最小配置示例和多模型配置方法，强调 API 密钥的安全性，建议使用环境变量或文件存储。同时包含日常开发技巧和常见错误排查方法。
关键要点
-
用户需安装 opencode-ai，并在配置文件中设置网关地址和 API 密钥。
-
配置文件默认位置为 ~/.config/opencode/opencode.jsonc，支持自定义路径。
-
API 密钥建议使用环境变量或文件存储，避免明文存储在配置文件中。
-
提供了最小配置示例和多模型配置方法，强调模型 ID 与网关 API 一致性。
-
日常开发中，默认使用 GLM 5.2 模型，轻量任务可使用 small_model 自动切换。
-
常见错误包括模型列表为空、API 密钥未设置、baseURL 不正确等，需检查配置。
延伸解读
API 密钥安全性
在配置 OpenCode 时，API 密钥的安全性至关重要。建议使用环境变量或文件存储，而不是直接在配置文件中明文存储。这可以有效防止密钥泄露，尤其是在将代码提交到公共仓库时。
多模型配置的灵活性
OpenCode 支持多模型配置，用户可以根据任务需求灵活切换模型。默认使用 GLM 5.2 进行日常开发，而在轻量任务中可自动切换到 small_model。这种灵活性可以提高开发效率，适应不同的应用场景。
常见错误排查
在使用 OpenCode 时，常见的错误包括模型列表为空、API 密钥未设置和 baseURL 不正确。用户应仔细检查配置文件，确保所有字段正确无误，并在修改后重启 OpenCode，以确保配置生效。
延伸问答
如何安装 OpenCode 并配置 API 密钥？
用户需通过命令 'npm install -g opencode-ai' 安装 OpenCode，并在配置文件中设置网关地址和 API 密钥。
OpenCode 的配置文件默认位置在哪里？
配置文件默认位置为 ~/.config/opencode/opencode.jsonc，用户也可以使用自定义路径。
如何确保 API 密钥的安全性？
建议使用环境变量或文件存储 API 密钥，避免明文存储在配置文件中。
在 OpenCode 中如何配置多模型？
在 provider.<id>.models 中声明所有模型，并使用 'model' 和 'small_model' 字段进行分工。
常见的错误有哪些，如何排查？
常见错误包括模型列表为空、API 密钥未设置、baseURL 不正确等，需检查配置并重启 OpenCode。
如何在 OpenCode 中切换模型？
可以通过 TUI 输入 '/models' 来选择模型，或使用 '/provider' 切换 Provider。
