Datawhale干货
保姆教程：开源版Claude Code
Claude Code 是 Anthropic 推出的 AI Agents 工具，可以在任意终端上运行，在任意 IDE 中使用，能理解代码库、执行命令、自动化管理 Git 仓库，调用 MCP等等。
但在国内使用，第一可能会被封号和一系列网络配置问题；其次，真的太贵了。
最近 GitHub 上来了个爆火的开源版 Claude Code，20天暴增4w star。截止目前已经斩获了 89.5k 的 Star。
OpenCode 完美解决了 Claude Code 的三大痛点：
完全开源，不怕封号，数据安全有保障
支持多模型切换，不被单一厂商绑定
对国内用户友好，可以接入国产模型
所以在这个背景下，我们写了一套保姆教程，旨在帮助大家零门槛用上目前最火的开源 AI 编程 Agent，并且将 OpenCode 接入各种国内主流的模型。
在模型侧，我使用的是国内平替方舟Coding Plan，集成了最新版主流国产编程模型，实现模型自由。一杯奶茶钱既能享受OpeCode的开源自由，又能以极低成本使用顶级编程模型。
火山方舟的 9.9 元编程套餐：szacq.cn/YEubD/
效果演示
按照文本教程完成操作后，就能直接打开 OpenCode 桌面版&在终端里执行 opencode 能在任意终端直接使用。
终端版
桌面版
五步完成OpenCode使用教程
以 火山方舟 为例，其他平台操作类似。首先需要在相应的模型服务平台注册账号，并获取 API Key。然后运行相应的脚本即可完成配置。
1.运行脚本，自动安装 opencode
Mac/Linux系统
1. 使用 curl 命令下载脚本并安装。
curl -fsSL https://opencode.ai/install | bashWindows系统
1. 安装 Node.js
教程地址：https://www.runoob.com/nodejs/nodejs-install-setup.html
2. 安装 opencode
npm i -g opencode-ai
2. 输入 API Key
首先，我们先获取火山方舟的API KEY，
地址：szacq.cn/YEubD/
购买后点击控制台
在快速导航处，进入火山方舟。
再点击上方新建一个API KEY即可。
接下来，我们创建 OpenCode 的配置文件
Mac/Linux系统
cd ~/.config/opencodenano opencode.jsonWindows系统
可以直接用文件管理找到地址。一般在用户下的 .config/opencode，在里面创建一个json文件。
然后复制以下代码（开启深度思考模式，不需要可以删除 options 的内容）：
{ "$schema": "https://opencode.ai/config.json", "provider": { "myprovider": { "npm": "@ai-sdk/openai-compatible", "name": "volcengine", "options": { "baseURL": "https://ark.cn-beijing.volces.com/api/coding/v3", "apiKey": "ARK_API_KEY" }, "models": { "ark-code-latest": { "name": "ark-code-latest", "options": { "thinking": { "type": "enabled" } } } } } }}粘贴到 opencode.json 配置文件，替换配置信息中的 ARK_API_KEY，保存后退出。
3. 后台选择模型
后台可以随意切换主流国产编程模型。
4.安装桌面版（IDE，按需选择）
官网地址：https://opencode.ai/download
直接下载对应的版本并安装。
5. 最后一步：运行 OpenCode
输入并执行 opencode命令
终端版：
桌面版：
6. 附加篇：安装oh-my-opencode
在 OpenCode 的使用中，oh-my-opencode 插件是不可或缺的。
它创造了一个 Agent 集群，其中分工十分明确：
Sisyphus - 主协调代理
Prometheus - 规划器
Metis- 计划顾问
Oracle- 架构与调试专家
Librarian- 文档与代码搜索专家
Frontend Engineer- 前端 UI/UX 专家
Explore- 快速代码库探索
Multimodal Looker- 多模态观察者
主 Agent 会按需指挥和调动它们，并且很多任务可以在后台并行跑。
还兼容了 Skill、MCP 等机制，自带精选过的 MCP，并支持完整的 LSP，十分强大。
安装方式，在终端或者桌面版的对话框输入：
npm config set registry https://registry.npmmirror.com先帮我配置一下镜像，随后安装oh-my-opencode。即使使用 npx 运行安装程序，底层运行时仍依赖于 Bun。bunx oh-my-opencode install# 如果 bunx 不工作，可以使用 npxnpx oh-my-opencode install一句话安装：按照这里的说明进行安装和配置 https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/README.md根据事实回复问题，就安装完成啦。
一起“点赞”三连↓
