1. (推荐)opencode使用教程
速创 API
  • 文档说明
  • 新手必看！速创API 中转站
  • (推荐)opencode使用教程
    • OpenCode 桌面版小白使用教程
    • 实操案例：OpenCode 桌面版辅助论文写作
  • cherry studio使用教程
    • (推荐)电脑版Cherry Studio对接速创API实现简单对话教程
    • 安卓版Cherry Studio · 接入速创API教程
    • (进阶)电脑版Cherry Studio实现画图
    • (进阶)电脑版Cherry Studio实现agent操控电脑文件
    • 实操案例——写论文
  • 模型（Models）
    • 列出模型
      • 原生OpenAI格式
      • 原生Gemini格式
  • 聊天（Chat）
    • 原生OpenAI格式
      • ChatCompletions格式
      • Responses格式
    • 原生Gemini格式
      • Gemini文本聊天
      • Gemini媒体识别
    • 原生Claude格式
      POST
  • 图像（Images）
    • 原生OpenAI格式
      • 生成图像
      • 编辑图像
    • 通义千问格式
      • 生成图像
      • 编辑图像
    • Nano Banana
      • Gemini原生格式
      • OpenAI聊天格式
  • 视频（Videos）
    • Sora格式
      • 创建视频
      • 获取视频任务状态
      • 获取视频内容
    • 可灵格式
      • Kling 文生视频
      • 获取 Kling 文生视频任务状态
      • Kling 图生视频
      • 获取 Kling 图生视频任务状态
    • 即梦格式
      • 即梦视频生成
    • 创建视频生成任务
      POST
    • 获取视频生成任务状态
      GET
  • 嵌入（Embeddings）
    • 原生OpenAI格式
      POST
    • 原生Gemini格式
      POST
  • 补全（Completions）
    • 原生OpenAI格式
  • 音频（Audio）
    • 原生OpenAI格式
      • 音频转录
      • 音频翻译
      • 文本转语音
    • 原生Gemini格式
  • 实时语音（Realtime）
    • 原生OpenAI格式
  • 重排序（Rerank）
    • 文档重排序
  • 审查（Moderations）
    • 原生OpenAI格式
  • 未实现（Unimplemented）
    • 微调（Fine-tuning）
      • 列出微调任务 (未实现)
      • 创建微调任务 (未实现)
      • 获取微调任务详情 (未实现)
      • 取消微调任务 (未实现)
      • 获取微调任务事件 (未实现)
    • 文件（Files）
      • 列出文件 (未实现)
      • 上传文件 (未实现)
      • 获取文件信息 (未实现)
      • 删除文件 (未实现)
      • 获取文件内容 (未实现)
  • 数据模型
    • Schemas
      • User
      • Log
      • Model
      • Token
      • Usage
      • PageInfo
      • Channel
      • Redemption
      • ApiResponse
      • ModelsResponse
      • ErrorResponse
      • Message
      • MessageContent
      • Tool
      • ToolCall
      • GeminiModelsResponse
      • ChatCompletionResponse
      • ChatCompletionRequest
      • ChatCompletionStreamResponse
      • CompletionRequest
      • CompletionResponse
      • ResponseFormat
      • ResponsesRequest
      • ResponsesResponse
      • ResponsesStreamResponse
      • ClaudeRequest
      • ClaudeMessage
      • ClaudeResponse
      • EmbeddingRequest
      • EmbeddingResponse
      • ImageGenerationRequest
      • ImageEditRequest
      • ImageResponse
      • AudioTranscriptionRequest
      • AudioTranslationRequest
      • AudioTranscriptionResponse
      • SpeechRequest
      • RerankRequest
      • RerankResponse
      • VideoRequest
      • ModerationRequest
      • VideoResponse
      • ModerationResponse
      • VideoTaskResponse
      • GeminiRequest
      • VideoTaskMetadata
      • VideoTaskError
      • GeminiResponse
      • OpenAIVideo
      • OpenAIVideoError
  1. (推荐)opencode使用教程

OpenCode 桌面版小白使用教程

转载请注明出处

⚠️ 使用前必看：AI 不是万能的#

AI 不是万能的，使用本工具存在以下风险：
文件丢失或损坏风险：Agent 模式可以读取、编辑、删除你电脑上的文件，操作失误可能导致数据丢失
系统损坏风险：Agent 可以执行命令行指令，包括删除系统文件、修改注册表、安装/卸载软件等
隐私泄露风险：Agent 可以读取你指定目录下的所有文件，不要给 AI 读取敏感信息的权限
请务必遵守以下安全规则：
1.
第一次使用请先在空文件夹或测试项目中尝试
2.
仔细设置 Agent 的工作目录权限，只给 AI 它能访问的最小范围
3.
执行危险命令前，AI 会请求你的确认，请仔细阅读再批准
4.
重要文件请先备份
5.
不要给 AI 设置为"全自动模式"（无人值守模式），除非你清楚后果

AI 不是所有软件都能操控#

Agent 能读取和编辑文件，也能执行命令，但不是所有软件都能被 AI 操控。
简单理解：
支持命令行、脚本、API 的软件，AI 更容易操控；
只能靠鼠标点击界面的软件，AI 通常不能稳定操控；
MATLAB 支持命令行运行脚本，实测可以配合 Agent 使用；
如果不确定某个专业软件能不能用，可以先问 AI："这个软件是否支持命令行调用、脚本运行或 API 自动化？"
示例：
请帮我确认 XXX 软件是否支持命令行调用、脚本运行或 API 自动化。如果支持，请告诉我 Windows 下的基本调用方式。

一、下载与安装#

1.1 下载#

百度网盘：通过网盘分享的文件：opencode
链接: https://pan.baidu.com/s/1jI1CIToxj_RKOsx18-97zA 提取码: 8i6y
--来自百度网盘超级会员v5的分享
官方：https://opencode.ai/zh/download 注意下载桌面版

1.2 安装步骤#

双击安装包 → 选择安装路径 → 等待完成 → 启动 OpenCode

1.3 安装 Git（推荐）#

Agent 操控电脑文件时经常需要使用命令行工具，建议先安装 Git。
百度网盘：通过网盘分享的文件：opencode
链接: https://pan.baidu.com/s/1jI1CIToxj_RKOsx18-97zA 提取码: 8i6y
--来自百度网盘超级会员v5的分享
官方：https://git-scm.cn/install/
安装完成后打开终端（CMD 或 PowerShell），输入以下命令检查是否成功：
如果能显示版本号，说明安装成功。

二、推荐设置#

打开 OpenCode 桌面版后，建议先打开以下设置项，防止折叠之后误认为ai卡住了：
QQ_1781433452684.png
设置项说明建议
在时间线中显示模型推理摘要显示 AI 的思考过程✅ 打开
默认在时间线中展开 shell 工具部分展开命令行执行详情✅ 打开
默认在时间线中展开 edit、write 和 patch 工具部分展开文件编辑详情✅ 打开
当智能体正在工作时，在会话顶部显示动画进度条显示进度条✅ 打开
QQ_1781433504863.png
权限设置建议
在设置中，建议不要开启自动接受权限：
读文件：自动允许
写文件/执行命令：需要你批准

这样 AI 不会偷偷改你的文件——每次修改前都会问你。#

三、配置免费模型（推荐速创API）#

OpenCode 自带一些免费模型，但如果你想用更强的模型，推荐使用速创API中转站，价格便宜且支持多种模型。

3.1 注册速创API#

1.
打开浏览器访问：https://api.suchuang.vip
2.
使用邮箱注册账号并登录
3.
注册就送1额度，每天签到也可获得额度

3.2 获取 API Key#

关于如何获取 API Key 和详细配置方法，请查看速创API配置文档：
👉 https://apidoc.suchuang.vip/8466135m0
QQ_1781433568458.png

3.3 让 AI 帮你配置（小白最简方式）#

拿到 API Key 后，回到 OpenCode 桌面版，新建一个对话，直接对内置的免费模型说：
帮我在 opencode 配置文件 ~/.config/opencode/opencode.jsonc 中添加新的 provider。配置要求如下：

供应商信息：

供应商 ID：suchuang
显示名称：速创API
API 地址：https://api.suchuang.vip/v1
API Key：sk-xxx
SDK 包：@ai-sdk/openai-compatible
模型列表（请先搜索每个模型在 OpenAI / xAI 官方文档中的规格）：

模型一：ID xxx (例如gpt-5.5，具体参考速创API-模型广场的名称)

搜索它的 context window、max output tokens、是否支持 reasoning（支持哪些 level：none/low/medium/high）、是否支持 vision（图片输入）
主力模型，走 Responses API（provider.npm: "@ai-sdk/openai"）

模型二：ID xxx(例如gpt-5.4-nano，具体参考速创API-模型广场的名称)

同样搜索以上规格
每个模型必须包含的字段： name、limit.context、limit.output、reasoning（布尔）、modalities.input+modalities.output、options.reasoningEffort、options.reasoningSummary，以及需要时加 provider.npm。tool_call 和 attachment 不是有效字段，不要加。
配置完成后，请告诉我需要重启 OpenCode 才能生效。
AI 会自动帮你修改配置文件，添加供应商和模型。你只需要把上面这段话发给 AI 就行。
💡 小提示：不只是配模型，任何使用中遇到的问题（环境配置、无法读取 PDF/Word、命令行报错等）都可以直接问 AI。比如：
我打开 PDF 文件时报错，说缺少依赖，帮我看看怎么解决。
AI 会自动诊断环境问题并帮你修复。

3.4 其他常用指令#

配完之后，这些操作也可以直接跟 AI 说：
你想做的事对 AI 说的话
改模型参数"帮我改 gpt-5.5 的思考强度为 high"
禁用某个供应商"帮我把 suchuang 禁用了"
查看当前配置"帮我读一下现在的配置文件"
配 Key"帮我把 Key 加到配置文件里，key 是 sk-xxx"

四、常见问题#

5.1 修改配置后不生效#

解决：重启 OpenCode

5.2 报错 "API key is missing"#

原因：没有配 API Key
解决：把 Key 发给 AI，让它帮你加上

5.3 报错 "reasoning_effort not supported"#

解决：告诉 AI "帮我把 gpt-5.5 的 reasoningEffort 设为 none"

5.4 模型切换无效#

切模型：直接切换，不用重启
改思考档位：直接切换，不用重启
改配置文件：需要重启

六、安全建议#

1.
✅ 重要文件先备份
2.
✅ 第一次用先建个测试文件夹试试
3.
✅ API Key 不要发给陌生人，不要截图公开
4.
✅ AI 执行命令前会问你，看清楚再同意
5.
❌ 不要把整个 C 盘的权限给 AI
修改于 2026-07-03 02:31:03
上一页
新手必看！速创API 中转站
下一页
实操案例：OpenCode 桌面版辅助论文写作
Built with