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 | bash

Windows系统

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.json

Windows系统

可以直接用文件管理找到地址。一般在用户下的 .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

根据事实回复问题，就安装完成啦。

一起“点赞”三连↓