什么是 OpenCode？
OpenCode 是一款开源 AI 编程智能体，可在终端中运行，也可通过桌面端、IDE 及基于服务器的工作流使用。它通过读取文件、解释代码结构、编辑代码、审查改动，并借助所连接的 LLM 提供方运行任务，帮助开发者处理代码库。你可以将它连接到某个模型提供方，例如 Kimi API，OpenCode 会借助该提供方在你的开发环境中进行规划、推理和执行操作。
使用 OpenCode 可以做什么？
如果你需要一种能够直接处理项目的 AI 编程工作流，可以选择 OpenCode。例如：
编写、编辑和重构代码： 你可以让 OpenCode 添加一项功能、修改现有文件、重构某个函数，或者说明某个模块应如何调整。为获得更好的效果，建议明确指出涉及的具体文件或目录。
调试错误并生成测试： OpenCode 可以检查错误输出、读取相关文件、提出修复建议并添加测试。当故障与项目上下文相关时，这一点尤其有用。
审查代码改动： 你可以在提交之前使用 OpenCode 审查本地改动。它能够发现可能的 bug、缺失的测试、不一致的代码模式以及有风险的改动。
自动化开发工作流： OpenCode 还支持非交互式和基于服务器的工作流。例如，你可以在命令行中运行一次性提示词，或启动无界面的 OpenCode 服务器，并让其他客户端或集成与之连接。
为 OpenCode 配置 LLM API 的前提条件
在通过 LLM API 配置 OpenCode 之前，请准备好以下内容：
一个可用的终端，支持 macOS、Linux，或使用 WSL 的 Windows（推荐）。
Node.js、Homebrew 或其他受支持的安装方式。
一个可以安全测试的项目文件夹。
一个模型提供商账号。
使用 OpenCode 时，�注意提供商凭证属于敏感信息。不要将密钥粘贴到公开的 issue、共享截图、源代码文件或已提交的配置中。
第 1 步：安装 OpenCode
OpenCode 官方文档中最快的安装方式是使用安装脚本。在终端中运行：
OpenCode 还支持通过 npm、Homebrew 等方式安装。如果你更喜欢桌面版，可以下载与你的设备匹配的版本。
第 2 步：启动 OpenCode
进入你希望 OpenCode 处理的项目目录：
启动 OpenCode：
如果这是你第一次在该项目中使用 OpenCode，请在 TUI 内进行初始化：
如何通过 LLM API 配置 OpenCode
在大多数情况下，“OpenCode API”指的是通过 API 密钥将 OpenCode 连接到外部 LLM 提供商。提供商负责提供模型，而 OpenCode 负责在你的项目中处理编程 agent 的工作流程。以下步骤以 Kimi API 作为提供商示例。
第 1 步：创建你的 Kimi API 密钥
打开 Kimi 开放平台。在控制台中创建一个 API 密钥，然后将其保存到密码管理器或密钥管理工具中。如果控制台只会完整显示一次密钥，请在离开页面前复制好。
第 2 步：连接模型提供商
在你的项目中启动 OpenCode：
在 OpenCode 界面内，运行：
搜索 Moonshot AI 或你所使用的 OpenCode 版本中显示的兼容 Kimi 的提供商条目。OpenCode 官方提供商文档中包含 Moonshot AI 提供商的接入流程：在 Moonshot AI 控制台中创建密钥，运行 /connect，搜索 Moonshot AI，然后输入 API 密钥。
如果你的版本中未列出 Moonshot AI，请更新 OpenCode 并刷新模型列表：
第 3 步：输入你的 Kimi API 密钥
当 OpenCode 要求输入 API 密钥时，粘贴你的 Kimi API 密钥。
OpenCode 会将提供商凭证保存在本地的身份验证文件中。官方提供商文档列出了该路径：
通常你不需要手动编辑该文件，使用 OpenCode 提供商的 /connect 流程即可。
第 4 步：选择 Kimi 模型
连接提供商后，在 OpenCode 内选择一个模型：
选择你要使用的 Kimi 模型。对于新的编程 agent 工作流程，建议从以下模型开始：
如果你需要以非交互方式使用特定模型运行 OpenCode，请按照 OpenCode 模型列表中显示的 provider/model 格式操作。例如：
然后使用 OpenCode 输出的准确模型标识符。
第 5 步：运行你的第一个编程任务
先从一个低风险任务开始，以验证提供商、模型、项目访问权限和其他权限是否都正常工作：
预期结果：
然后尝试一个小的编程任务：
这可以确认，在你��许 OpenCode 进行修改之前，它能够读取项目并对代码库进行推理分析。
为什么在 OpenCode 中使用 Kimi API？
如果你希望为编程�� agent 工作流程使用一个兼容 OpenAI API 的模型提供商，Kimi API 很适合与 OpenCode 搭配使用。
强大的编程与推理能力
{{KIMI_MODEL_LATEST_FULL}} 官方定位面向长程编程、指令遵循、自我纠错和智能体执行。这使它适用于 OpenCode 中的多文件编辑、调试、重构和代码审查等任务。
长上下文支持，适配更大项目
{{KIMI_MODEL_LATEST_FULL}} 官方文档列出了 {{KIMI_MODEL_LATEST_FULL}} 及多款 K2 系列模型的长上下文支持。在智能体工作流中，当任务需要读取多个文件、比较不同实现方式，或保留大量任务历史时，长上下文能够提供帮助。
兼容 OpenAI API，设置更简单
Kimi API 兼容 OpenAI API 格式。对于已经支持 OpenAI 风格 chat completions 的工具，通常只需配置 API 密钥、Base URL 和模型名称即可。
灵活使用，不局限于 OpenCode
你可以在其他兼容 OpenAI API 的开发者工具、直接脚本或内部工作流中使用同一个 Kimi API 密钥。如果之后使用 OpenCode server 或 OpenCode SDK，请先将 Kimi 配置为模型提供方。
你应该了解的关键 OpenCode API 设置
这些设置能解决大多数 OpenCode API 和提供方配置问题。
API 密钥
API 密钥用于向模型提供方验证你的请求身份。在 OpenCode 中，通常通过以下方式添加：
提供方
提供方指明 OpenCode 从何处获取模型。在本指南中，提供方是月之暗面 / Kimi API。其他提供方可以单独配置，但每个提供方都需要各自的凭据和模型列表。
Base URL
Base URL 是用于直接发起兼容 OpenAI API 请求的端点。对于 Kimi API 示例，请使用当前 Kimi API 文档或账户控制台中显示的端点。
模型名称
模型名称必须与提供方给出的完全一致。一个小的拼写错误就可能导致模型未找到的错误。
常见示例：
在 OpenCode 中，可以通过以下方式确认提供方/模型标识符：
排查常见的 OpenCode API 错误
大多数配置问题都源于以下五个方面之一：凭据、端点、提供方、模型名称，或上下文大小。
身份验证失败
如果 API 密钥粘贴错误、被删除或已轮换，身份验证可能会失败。选错提供方，或密钥所属账户/地区与 OpenCode 当前配置的不一致时，也会出现这种情况。
解决方法：
重新连接提供方，并粘贴一个全新的 API 密钥。如果你使用环境变量进行直接测试，请重置密钥：
端点无效错误
端点无效错误通常意味着 OpenCode 无法访问正确的提供方端点。常见原因包括 Base URL 拼写错误、在不同工具中混用 .ai 和 .cn 端点，或代理/防火墙在请求到达提供方之前对其进行了改写。
解决方法：
查看当前 Kimi API 文档或控制台中显示的端点。进行直接 API 测试时，请始终使用同一个端点：
不支持的模型
当模型名称拼写错误、所选模型在你的账户下不可用，或 OpenCode 的模型列表缓存已过期时，可能出现此错误。当 OpenCode 使用的提供方/模型标识符与提供方文档中显示的原始模型名称不一致时，也会发生这种情况。
解决方法：
然后重新选择模型：
超出速率限制
速率限制错误通常表示提供方在短时间内收到了过多请求。如果同时运行多个智能体任务，或某个脚本/集成过于激进地重试失败请求，都可能引发这种情况。
解决方法：
暂停任务，减少并行运行数量，并在提供方控制台检查配额或账单状态。避免为 OpenCode 或直接的 Kimi API 调用编写无限重试循环。
上下文窗口溢出
上下文窗口溢出通常意味着任务规模超出了模型单次处理的上限。如果包含的文件过多、要求 OpenCode 检查整个代码仓库，或某个长会话累积了过多对话历史，都可能导致这种情况。
解决方法：
让 OpenCode 处理更小范围的任务：
你也可以为范围更小的任务新建一个会话。
结语
OpenCode 可以将你的代码库连接到模型提供方，并从终端运行编码任务。Kimi API 可以通过兼容 OpenAI API 的方式，为这些工作流提供模型后端。如果你想搭建一套实用的编程 agent 工作流，可以创建 Kimi API 密钥，在 OpenCode 中连接 Moonshot AI，选择一个 Kimi 模型，再运行一个小型项目任务来验证配置是否可用。
常见问题
/connect 在 OpenCode 中输入该密钥。OpenCode 会将 provider 凭据保存在本地，官方文档中列出的凭据文件路径为 ~/.local/share/opencode/auth.json。opencode models。对于 Kimi API，请选择 OpenCode 模型列表中显示的确切 Kimi 模型标识，例如你的账户可用时的 kimi-k2.6。/connect。