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命令下载脚本并安装。

Windows系统

1. 安装 Node.js

教程地址：https://www.runoob.com/nodejs/nodejs-install-setup.html

2. 安装 opencode

2. 输入 API Key

首先，我们先获取火山方舟的API KEY，

地址：szacq.cn/YEubD/

购买后点击控制台

在快速导航处，进入火山方舟。

再点击上方新建一个API KEY即可。

接下来，我们创建 OpenCode 的配置文件

Mac/Linux系统

Windows系统

可以直接用 文件管理找到地址。一般在 用户下的 .config/opencode，在里面创建一个json文件。

然后复制以下代码（开启深度思考模式，不需要可以删除 options 的内容）：

粘贴到 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- 文档与代码搜索专家