Learning Path
浏览 OpenCode 相关教程与章节。
AI Agent、机器学习、深度学习、数据分析与 Python 科学计算。
教程
29
OpenCode 教程 OpenCode 是一个基于命令行（CLI）的 AI 编程 Agent，能够理解项目上下文，并自动执行开发任务。 OpenCode 并不是一个简单的代码生成器，而是一个具备理解 + 执行能力的智能体工具。 OpenCode 运行在终端中，而不是 IDE。 OpenCode 是 Agent（智能体工具），不是 Chat（聊天工具）。 AI 编程新时代 过去的软件开发模式是：开发者编..
OpenCode 代理（Agent）配置详解 代理是 OpenCode 中专门化的 AI 助手，每个代理可以配置独立的系统提示词、模型、工具访问权限和行为约束，用于处理特定类型的任务和工作流程。你可以在会话期间随时切换代理，或通过 @代理名称 的方式直接调用特定代理。 代理类型 OpenCode 中的代理分为两种类型，它们的调用方式和职责不同： 类型 ..
OpenCode 规则（AGENTS.md） 在 OpenCode 中，规则（Rules）是控制 AI 行为的核心机制。 我们可以通过 AGENTS.md 文件，为 OpenCode 提供自定义指令，让它按照你的项目规范进行开发。 工具决定 AI 能做什么，AGENTS.md 决定 AI 应该怎么做。 AGENTS.md = 给 AI 制定团队开发规范。 一、什么是 AGENTS.md AGENTS.md 是一个规则文..
OpenCode API 设置 通过 OpenCode，你可以接入任意 LLM（大语言模型）提供商，例如 OpenAI、Claude、DeepSeek、阿里百炼等，从而获得更强的 AI 编程能力。 如果你是第一次使用，建议优先选择 OpenCode Zen，它是 OpenCode 官方精选的一组模型，已经过测试和优化，开箱即用，适合新手。 OpenCode Zen 里面也包含了大量的免费大模型，所以基本上可以直接用，不用充..
OpenCode CLI 使用 OpenCode 提供了强大的命令行接口（CLI），不仅可以启动交互式 TUI，还可以通过命令实现自动化、脚本化操作。 默认情况下，OpenCode CLI 会启动 TUI，但它的真正能力在于可编程调用。 OpenCode CLI 不只是一个命令工具，而是一个可编程的 AI 开发接口。 OpenCode CLI 可以抽象为三层： 交互层：tui / web / attach 执..
OpenCode 自定义命令 自定义命令允许你将常用的提示词封装成一个短命令，在 TUI 中通过 /命令名称 的方式一键执行，避免重复输入相同的提示词。例如，将'运行测试并分析失败原因'这个复杂提示词封装为 /test，每次只需输入两个字符即可触发。 自定义命令是 /init、/undo、/redo、/share、/help 等内置命令之外的扩展。 如果你定义的自定义命令与内置命令同名，自定义命令会覆盖内置命令..
OpenCode 自定义工具 自定义工具（Custom Tools）允许你为 OpenCode 扩展能力，让 LLM 在对话过程中调用你定义的函数，从而实现数据库查询、脚本执行、API 调用等复杂操作。 这些工具会与内置工具（如 read、write、bash）协同工作，构建完整的自动化开发能力体系。 自定义工具是 OpenCode 的核心扩展能力，它让 LLM 从只会生成代码，升级为可以执行任务。 通过合理设计..
OpenCode 接入 DeepSeek OpenCode 是一款开源的 AI 编程助手，支持在终端、网页等多种环境中运行。 本章节我们要配置 DeepSeek 作为其 AI 后端，从而在编程中获得强大的智能辅助。 OpenCode 下载与安装 首先，请根据你的操作系统访问 OpenCode 官方下载页面 https://opencode.ai/zh/download，获取安装包或安装脚本： 为了避免因版本差异导致的兼容性问题..
OpenCode 生态系统 基于 OpenCode 构建的社区项目合集。 您还可以查看 awesome-opencode 和 opencode.cafe，这是一个聚合生态系统与社区资源的社区。 插件 名称 描述 opencode-daytona 在隔离..
OpenCode 第一次使用 安装了 Claude Code 及配置好 API 后，我们就可以开始使用了。 可以先进入项目目录： cd /path/to/project 然后运行 OpenCode： opencode 运行以下命令为项目初始化 OpenCode： /init OpenCode 会分析你的项目并在项目根目录创建一个 AGENTS.md 文件。 退出 OpenCode，使用以下命令： /exit 接下来..
OpenCode 格式化工具 OpenCode 会在每次写入或编辑文件后，自动使用对应语言的格式化工具对其进行格式化，确保生成的代码始终符合你项目的代码风格。整个过程在后台静默完成，无需任何手动操作。 工作原理 当 OpenCode 写入或编辑文件时，会按以下步骤自动执行格式化： 检测被写入或编辑的文件扩展名（如 .ts、.py、.go 等） 将扩展名与所有已启用的格式化工具进行匹配 对该文件运行匹配..
OpenCode GitHub OpenCode 可以深度集成 GitHub 工作流，让 AI 直接参与 Issue、Pull Request 和代码审查流程。 通过在评论中输入 /opencode 或 /oc，即可触发 AI 自动执行任务。 OpenCode GitHub = 把 AI 变成你的自动化开发成员，直接参与 Issue、PR 和代码流程。 一、核心能力 Issue 分析：自动理解问题并给出解释 自动修复：创..
OpenCode GitLab OpenCode 同样可以集成到 GitLab 工作流中，在 Issue、合并请求（Merge Request）以及 CI/CD 流水线中自动执行任务。 它的核心特点是：在你的 GitLab Runner 上运行，实现安全可控的 AI 自动化开发。 OpenCode GitLab = 把 AI 接入 CI/CD，让代码分析、修复和审查自动化运行。 一、集成方式概览 OpenCode 在 Git..
OpenCode 安装 OpenCode 是一个开源的 AI 编程 Agent，支持在终端中直接完成代码理解、修改、执行等开发任务。 相比传统 AI 工具，OpenCode 可以直接参与开发流程，而不仅仅是生成代码。 在安装之前，需要确保你的环境满足以下条件： 1、操作系统要求 macOS Linux Windows（推荐使用 WSL） 2、终端工具 需要一个现代终端，例如： WezTerm（跨平台）：..
OpenCode 简介 OpenCode 是一款开源 AI 编程协作工具，定位为基于命令行（CLI）的 AI 编程 Agent，区别于传统聊天式编程工具，专注于深度参与项目全流程开发。 OpenCode 与仅在聊天窗口生成零散代码不同，OpenCode 的核心目标是深度理解你的整个项目，全程参与真实的编码、修改与重构过程，成为可落地的开发搭档。 OpenCode 并非简单的代码生成器，而是能读取项目、理解上下文、自主执行开发任务的 A..
OpenCode 快捷键配置详解 OpenCode 提供了一套完整的键盘快捷键系统，涵盖应用控制、会话管理、消息浏览、模型切换和输入编辑等各类操作。所有快捷键均可通过 tui.json 文件进行自定义。 配置文件 快捷键配置写在 tui.json 文件的 keybinds 字段下，每条记录的键名为操作名称，值为对应的快捷键： 实例[mycode4 type='json'] { '$schema..
OpenCode LSP 服务器配置 OpenCode 与语言服务器协议（LSP，Language Server Protocol）深度集成，通过 LSP 服务器为 LLM 提供代码诊断、错误提示等实时反馈，帮助 AI 更准确地理解和操作你的代码库。 简单来说，LSP 服务器就是让 OpenCode 具备'读懂代码'能力的组件，类似于 VS Code 中提供代码补全、错误提示的插件。当文件中出现语法错误或类型不匹..
OpenCode MCP 服务器配置 MCP（Model Context Protocol，模型上下文协议）是一种开放协议，允许你为 OpenCode 接入外部工具和数据源。添加 MCP 服务器后，其提供的工具会自动与 OpenCode 的内置工具并列，LLM 可以在对话中直接调用它们。 OpenCode 同时支持两种 MCP 服务器： 本地（local）：在你的机器上通过命令行启动的 MCP 进程，适合本地工具和脚本 ..
OpenCode oh-my-openagent 使用教程 Oh My OpenAgent（简称 OmO）是一个开源的 AI 编程助手增强插件，前身叫 oh-my-opencode。 oh-my-openagent 运行在 OpenCode这个 AI 编程工具之上，把它变成一个由 11 个专业 AI Agent 组成的开发团队。 用一句话解释： 你发一个需求 → OmO 自动调度多个 AI 并行工作 → 比单个 AI 快数..
OpenCode 权限配置 OpenCode 的权限系统用于控制哪些操作可以自动运行、哪些需要你手动审批、哪些会被直接阻止。合理配置权限，既能让 AI 高效完成任务，又能防止误操作破坏代码或泄露敏感文件。 从 v1.1.1 开始，旧版 tools 布尔配置已被弃用，并已合并到 permission 中。旧版配置仍然支持，以保持向后兼容，但建议迁移到新的 permission 写法。 三种权限动作 每条权限规则最终会解析为以下三..
OpenCode 配置文件 OpenCode 使用 JSON 格式来配置。 我们可以先看在全局配置文件 ~/.config/opencode/opencode.json： touch ~/.config/opencode/opencode.json 包含模型提供商及配置信息： { // JSON Schema（用于编辑器校验和自动补全） '$schema': 'https://opencode...
OpenCode skills 使用 在之前的内容，我们已经了解了 OpenCode 和 skills，如果还没阅读，可以参阅： OpenCode 入门教程 Skills 教程 接下来我们将将介绍如何在 OpenCode 中使用 skills。 现在市面上已经有很多现成的 skills，我么可以直接拿来使用，我们可以在 https://skills.sh/ 查找更多的 skill。 安装方式： npx skills add ..
OpenCode Skills 在 OpenCode 中，代理技能（Skills）是一种用于封装可复用行为的机制，通过 SKILL.md 文件定义，使 LLM 能够按需加载、按需执行特定能力。 相比普通提示词，技能更接近模块化能力单元，可以在多个项目或团队中复用。 Skills 是 OpenCode 的能力插件系统，它将 AI 行为从单次提示升级为可复用能力模块，使开发流程更加标准化、可组合，并适用于复杂工程体系。 S..
OpenCode 主题 OpenCode 支持多种主题系统，您可以选择内置主题、自动适配终端主题，或者完全自定义主题，从而获得一致且舒适的终端体验。 最简单的方式就是在 TUI 输入框中输入 /themes 命令： /themes 然后在弹出的窗口中选择你喜欢的主题： 终端要求 为了确保主题能够正确显示完整色彩，您的终端必须支持 真彩色（24 位色）。 检查支持情况： echo $COLORTERM ..