前言

最近在填一个项目的坑，别人的代码写得那叫一个「别具一格」，看得我头都大了。😅

自己一个个改，改了好几天，终于把它跑起来了。

说实话，这种体力活儿，写完第一个后面都大差不差，简直是 AI 的舒适区。

再加上领导最近开会天天念叨「把 AI 用起来，提升效率」，我就静下心来研究了一下 OpenCode 这一款开源神器。

在此之前，我也就是用用 DeepSeek、豆包、Kimi 的网页版对话，或者 VS Code 里的 Trae、Continue、Cline 这些插件做代码补全。

但 OpenCode 完全免费不说，还支持接入 Claude、GPT、DeepSeek、GLM 等多种大模型，关键是完全开源，隐私优先！👍

今天手把手教你安装配置，小白也能轻松上手。还可以支持配置本地模型哦~

什么是 OpenCode？

OpenCode 是一个开源的 AI 编程助手，可以帮你：

✅ 分析代码
✅ 生成新功能
✅ 重构优化项目
✅ 修复 Bug
✅ 智能问答

它支持在终端、桌面应用和主流 IDE（如 VS Code）中使用，完全免费，完全开源！

简单理解：它就像一个免费的「代码助手」，用自然语言告诉它要做什么，它就会帮你写代码。

一、安装

Windows 用户

使用 npm

前提需要安装好 Node.js（自带 npm）。

1	npm i -g opencode-ai

macOS / Linux 用户

1	curl -fsSL https://opencode.ai/install \| bash

或者使用 Homebrew：

1	brew install opencode

验证安装

1	opencode --version

二、配置模型

1. 启动 OpenCode

opencode

首次启动会提示配置模型 API，按提示操作即可。

2. 选择模型提供商

推荐选择：

🔥 OpenCode Zen - 官方优化版，支持主流模型
💎 DeepSeek - 国产之光，响应快且便宜
🤖 Claude - Anthropic 出品
🌟 Google Gemini - Google 出品

3. 获取 API Key

在对应官网申请后填入即可：

4. 免费模型

内置4个免费模型可用：

模型	特点
big-pickle	OpenCode 官方模型
GLM-4.7	智谱出品，推荐！
Grok Code Fast 1	X 出品
MiniMax M2.1	免费额度多

免费额度都是有上限的，超过后会需要等下一个周期。今天我用了自带的那个 big-pickle 模型，就改几个代码就耗完额度了。😂

后来使用公司内网部署的 GLM 模型，实现了 token 自由，真香！

三、两种工作模式

模式	说明
📖 Plan	只读规划模式，会分析代码但默认拒绝修改
🛠️ Build	构建模式，全权限可直接编辑文件、执行命令

四、常用命令

opencode              # 启动交互式会话
opencode "你的问题"   # 直接提问
/models               # 切换模型
/plan                 # 切换到规划模式
/build                # 切换到构建模式
/exit                 # 退出

五、进阶：Oh My OpenCode

这是 OpenCode 的增强插件，类似于「Oh My Zsh」之于 Zsh：

🤝 多 AI 模型协作
🎯 内置专业智能体
✨ 提示词自动优化
⚡ 后台任务管理

安装：

1	opencode plugin install omoc

或

1	npm i -g oh-my-opencode

总结

OpenCode 是一款完全免费、开源、支持多模型的 AI 编程助手，可以完美替代付费的 Claude Code 等工具。

无论你是编程新手还是资深开发者，都能从中提升效率！

要部署本地模型，需要创建 opencode.jsonc 配置文件，配置本地模型的地址和端口。

下面分享一下我的配置：

{
  "$schema": "https://opencode.ai/config.json",
  "disabled_providers": [],
  "provider": {
    "fishmwei_ai": {
      "name": "fishmwei_ai",
      "npm": "@ai-sdk/openai-compatible",
      "models": {
        "aea8ae40-fb8b-4428-b520-98793efxxxxx": {
          "name": "GLM-TEST"
        }
      },
      "options": {
        "baseURL": "https://aiapi.fishmwei.com.cn/v1",
        "allowSelfSignedCerts": true,
        "apiKey":"sk-PvSLwH5XwbloPy_SvZVXXX"
      }
    }
  }
}

快去试试吧！

如果你觉得有帮助，欢迎点赞、在看、转发~

有任何问题评论区见！

参考来源：OpenCode 官方文档

行动，才不会被动!

欢迎关注个人公众号微信 -> 搜索 -> fishmwei，沟通交流。

博客地址： https://fishmwei.github.io

掘金主页： https://juejin.cn/user/2084329776486919

IT攻城狮小明

快速安装使用opencode编程助手

前言