简介#

OpenCode 是一个开源免费的 AI Coding Agent, 在各大厂商都发布自己的 Coding Agent 时, OpenCode 完全开源和开放, 并且可以接入几乎市面上的所有厂商的 API, 因为它的开放性, 它在 github 上的 stars 比 Claude Code 还要多

割裂的开发标准#

现阶段各大厂商都发布自己的 AI Coding Agent, 例如 Claude Code / Gemini Cli / trae, 但 每家都在制定自己的标准或协议, 例如 cluade code 使用 .claude, gemini cli 使用 .gemini, trae 使用 .trae, 对于 MCP / Command / Skills / Plugins 等的标准和支持度也有差异, 也就是说如果你要使用某个厂商的模型编码, 那么就只能使用它们推出的 AI Coding Agent

OpenCode 做的就是兼容各家厂商的大模型, 你可以在这里看到支持的 providers

安装#

OpenCode 提供了多种安装方式, 这里我们选择使用 bun 进行安装, 因为它比 Node.js 更快性能更好

1
bun add -g opencode-ai
2

3
bun add v1.2.10 (db2e7d7f)
4

5
installed opencode-ai@1.1.25 with binaries:
6
 - opencode
7

8
2 packages installed [46.56s]
9

10
Blocked 1 postinstall. Run `bun pm -g untrusted` for details.

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

1
brew install anomalyco/tap/opencode

1
pnpm i -g opencode-ai

1
npm i -g opencode-ai

1
choco install opencode

免费模型#

OpenCode 提供了免费的模型, 你可以在 opencode zen pricing 中查看

配置 GLM Coding Plan#

opencode zen 提供的免费模型好像有频率限制, 不是很稳定, 而且不支持 GLM 的 视觉理解等 MCP 服务, 这里可以直接接入已经订阅的 GLM Coding Plan

推广

如果想要获得最好的 Vibe Coding 体验, 推荐购买 🔗 GLM Coding Lite 服务(也可以 🔗 点击这里 先免费试用 7 天), 包月只要 20 💰, Lite 版本的按 Prompt 计费, 每 5 小时最多约 120 次 prompts, 原因如下:

1
pnpm dlx @z_ai/coding-helper
2

3
╔═══════════════════════════════════════════════════════════════╗
4
║                                                               ║
5
║       ▄▀▀ ▄▀▄ █▀▄ █ █▄ █ ▄▀    █▄█ ██▀ █   █▀▄ ██▀ █▀▄        ║
6
║       ▀▄▄ ▀▄▀ █▄▀ █ █ ▀█ ▀▄█   █ █ █▄▄ █▄▄ █▀  █▄▄ █▀▄        ║
7
║                                                               ║
8
║                     Coding Helper v0.0.5                      ║
9
║        Manage Your Claude Code and Other Coding Tools         ║
10
╚═══════════════════════════════════════════════════════════════╝
11

12
╔═════════════════════════════════════════════════════════════╗
13
║                  Select interface language                  ║
14
╚═════════════════════════════════════════════════════════════╝
15

16
💡 ↑↓ Navigate | Enter Confirm
17

18
? ✨ Select interface language (Use arrow keys)
19
  [EN] English ✓ (Current)
20
❯ [CN] 中文
21
  ──────────────
22
  <-  Return
23
  x   Exit
24

25
...

或使用 npx:

1
npx @z_ai/coding-helper

然后修改 ~/.config/opencode/opencode.json 中的模型:

1
{
2
    "$schema": "https://opencode.ai/config.json",
3
    "provider": {
4
        "zhipuai-coding-plan": {
5
            "options": {
6
                "apiKey": "04eb870cce874c3d83c4694f0c35cc43.0I6oTtTbC7Pg4nOY"
7
            }
8
        }
9
    },
10
    "model": "zhipuai-coding-plan/glm-4.7",
11
    "small_model": "zhipuai-coding-plan/glm-4.7"
12
}

TIP

在发布新模型时需要再次修改这里的 model / small_model

接入其他模型#

其他供应商或模型的接入方式可以查看 providers

启动#

最终启动 opencode 时可能会遇到没有权限创建目录的问题:

1
opencode
2

3
EACCES: permission denied, mkdir '/Users/xxx/.local/state/opencode'
4
    path: "/Users/xxx/.local/state/opencode",
5
 syscall: "mkdir",
6
   errno: -13,
7
    code: "EACCES"
8

9

10
Bun v1.3.5 (macOS arm64)

看起来只是单纯的目录权限问题, 我们来看看当前用户是否有权限:

1
lsd -l ~/.local/
2

3
drwxr-xr-x xxx staff 320 B Wed Nov 12 15:06:56 2025  bin
4
drwxr-xr-x xxx staff  96 B Fri Nov  7 14:16:36 2025  lib
5
drwx------ xxx staff 256 B Mon Jan 19 13:24:03 2026  share
6
drwxr-xr-x root  staff  96 B Wed Feb 21 13:57:59 2024  state

这里 ~/.local/state 目录属于 root 用户, 我们将其改为当前用户:

1
sudo chown -R $USER ~/.local/state

启动 opencode#

直接执行 opencode [path] 启动 opencode

1
opencode
2

3
                                                                                 ▄
4
                                                █▀▀█ █▀▀█ █▀▀█ █▀▀▄ █▀▀▀ █▀▀█ █▀▀█ █▀▀█
5
                                                █  █ █  █ █▀▀▀ █  █ █    █  █ █  █ █▀▀▀
6
                                                ▀▀▀▀ █▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀ ▀▀▀▀
7

8

9
                              ┃
10
                              ┃  Ask anything... "Fix broken tests"
11
                              ┃
12
                              ┃  Build  GLM-4.6 Zhipu AI Coding Plan
13
                              ╹▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
14
                                                             ctrl+t variants  tab agents  ctrl+p commands

基本操作#

1
# Editor
2
export EDITOR=vim
3

4
# for vscode
5
# export EDITOR="code --wait"
6

7
# for trae
8
# export EDITOR="trae --wait"

1
# Editor
2
set -gx EDITOR vim

1
opencode run "你好"
2

3

4
你好！我是 opencode，一个可以帮助你进行软件工程任务的 CLI 工具。我可以帮助你：
5

6
- 编写和修改代码
7
- 分析代码库结构
8
- 运行构建和测试命令
9
- 解决 bug 和添加新功能
10
- 代码审查和重构
11

12
需要我帮助你做什么吗？

1
opencode stats
2
┌────────────────────────────────────────────────────────┐
3
│                       OVERVIEW                         │
4
├────────────────────────────────────────────────────────┤
5
│Sessions                                              3 │
6
│Messages                                             29 │
7
│Days                                                  1 │
8
└────────────────────────────────────────────────────────┘
9

10
┌────────────────────────────────────────────────────────┐
11
│                    COST & TOKENS                       │
12
├────────────────────────────────────────────────────────┤
13
│Total Cost                                        $0.00 │
14
│Avg Cost/Day                                      $0.00 │
15
│Avg Tokens/Session                                49.8K │
16
│Median Tokens/Session                             11.6K │
17
│Input                                            147.3K │
18
│Output                                             2.1K │
19
│Cache Read                                       123.2K │
20
│Cache Write                                           0 │
21
└────────────────────────────────────────────────────────┘
22

23

24
┌────────────────────────────────────────────────────────┐
25
│                      TOOL USAGE                        │
26
├────────────────────────────────────────────────────────┤
27
│ read               ████████████████████   6 (42.9%)    │
28
│ glob               █████████████          4 (28.6%)    │
29
│ bash               ██████████             3 (21.4%)    │
30
│ write              ███                    1 ( 7.1%)    │
31
└────────────────────────────────────────────────────────┘

vscode extension#

opencode 提供了 vscode extension:

更新#

1
opencode upgrade
2

3
# 制定更新方式, 支持 curl / npm / pnpm / bun / brew
4
opencode upgrade --method bun

指令#

OpenCode 自带了一些常用的指令:

• /compact: 压缩会话
• /clear: 清空会话
• /export: 导出会话, 导出为 markdown 文件, 并使用 $EDITOR 打开文件
• /init: 初始化 AGENTS.md 文件, 详见 初始化项目
• /models: 列出支持的 LLM
• /session: 查看所有历史会话
• /shart: 分享当前会话, 类似于 ChatGPT 的 Share 功能

快捷键#

• ctrl+c: 退出 opencode
• Esc / ctrl+[: 退出当前模式
• Tab: 切换模式

我更习惯使用 command, 所以真正用到的快捷键只有这些

配置文件#

• 当前项目的配置文件在 .opencode.jsonc
• 全局配置文件在 ~/.config/opencode/opencode.jsonc

MCP#

直接在配置文件中声明 MCP 服务

1
{
2
  "$schema": "https://opencode.ai/config.json",
3
  "mcp": {
4
    "my-remote-mcp": {
5
      "type": "remote",
6
      "url": "https://my-mcp-server.com",
7
      "enabled": true,
8
      "headers": {
9
        "Authorization": "Bearer MY_API_KEY"
10
      }
11
    }
12
  }
13
}

Skills#

opencode 会从以下位置读取 skills:

• 项目配置: .opencode/skills/<name>/SKILL.md
• 全局配置: ~/.config/opencode/skills/<name>/SKILL.md
• 项目 Claude Code: .claude/skills/<name>/SKILL.md
• 全局 Claude Code: ~/.claude/skills/<name>/SKILL.md

1
---
2
name: git-release
3
description: Create consistent releases and changelogs
4
license: MIT
5
compatibility: opencode
6
metadata:
7
  audience: maintainers
8
  workflow: github
9
---
10

11
## What I do
12

13
- Draft release notes from merged PRs
14
- Propose a version bump
15
- Provide a copy-pasteable `gh release create` command
16

17
## When to use me
18

19
Use this when you are preparing a tagged release.
20
Ask clarifying questions if the target versioning scheme is unclear.

自定义工具#

opencode 会读取 .opencode/tools/* 作为可以直接调用的工具, 以 Nodejs 为例:

1
import { tool } from "@opencode-ai/plugin"
2

3
export const add = tool({
4
  description: "Add two numbers",
5
  args: {
6
    a: tool.schema.number().describe("First number"),
7
    b: tool.schema.number().describe("Second number"),
8
  },
9
  async execute(args) {
10
    return args.a + args.b
11
  },
12
})
13

14
export const multiply = tool({
15
  description: "Multiply two numbers",
16
  args: {
17
    a: tool.schema.number().describe("First number"),
18
    b: tool.schema.number().describe("Second number"),
19
  },
20
  async execute(args) {
21
    return args.a * args.b
22
  },
23
})

这样就创建了两个工具: math_add 和 math_multiply

权限#

可以在项目中创建 opencode.jsonc 文件(.jsonc 文件允许添加注释) 来配置 opencode, 最重要的就是权限相关的配置了:

1
{
2
  "$schema": "https://opencode.ai/config.json",
3
  "permission": {
4
    "edit": "deny", // 拒绝修改
5
    "bash": "ask", // 执行 bash 命令之前询问
6
    "webfetch": "allow", // 允许执行 webfetch
7
  }
8
}

或者使用更加细粒度的权限控制:

1
{
2
  "$schema": "https://opencode.ai/config.json",
3
  "permission": {
4
    "bash": {
5
      "*": "ask",
6
      "git *": "allow",
7
      "npm *": "allow",
8
      "rm *": "deny",
9
      "grep *": "allow"
10
    },
11
    "edit": {
12
      "*": "deny",
13
      "packages/web/src/content/docs/*.mdx": "allow"
14
    }
15
  }
16
}

TIP

全局配置文件在 ~/.config/opencode/opencode.jsonc

自定义命令#

opencode 的自定义命令跟 Claude Code 的 Slash Commands 基本一致, 可以直接参考我的另一篇文章 Claude Code 系列教程之 斜杠命令(Slash Commands)

1
---
2
description: Create a new component
3
---
4

5
Create a new React component named $ARGUMENTS with TypeScript support.
6
Include proper typing and basic structure.

不同点在于参数的声明和使用, 在 opencode 中直接使用 $ARGUMENTS 或者 $1 / $2 来使用参数, 不支持声明参数

更多使用方式参考 opencode commands

formatter#

opencode 支持在更新完代码之后自动进行格式化, 例如 golang 使用 gofmt, rust 使用 rustfmt, 前端项目使用 prettier / biome / oxfmt … 更多详情参考 formatters

参考#

• OpenCode
• Claude Code
• Gemini Cli
• trae
• bun
• GLM 的 视觉理解等 MCP 服务
• GLM Coding Plan
• 点击这里
• editor setup - OpenCode
• Slash Commands
• Claude Code 系列教程之 斜杠命令(Slash Commands)
• opencode zen pricing
• providers
• opencode commands
• formatters
• mdns discovery