效率工具 on OHTLY Blog

同时适配 OpenCode 和 Codex CLI 的配置方法

Wed, 24 Jun 2026 16:47:06 +0800

问题链接到标题

两个终端 AI 编码 agent 各有优势，但配置格式完全不互通。

OpenCode：配置在 .opencode/ 目录，subagent 用 Markdown + YAML frontmatter，权限控制细粒度
Codex CLI（OpenAI）：配置在 .codex/ 目录，custom agent 用 TOML 格式，权限模型粗粒度
Skills 加载路径两边也不同

如果继续分别在 .opencode/skills/ 和 .codex/skills/ 各放一份，维护成本会翻倍。更新一条命令模板要改两个文件，迟早不同步。

本文记录了一个实际项目的配置方案：Skill 放共享层，Agent 放独立层，AGENTS.md 做通用索引。

全貌对比链接到标题

先看两个工具的配置差异：

项目	OpenCode	Codex CLI
Skills 目录	`.opencode/skills/`	`.codex/skills/`
通用 Skills	`.agents/skills/` ✅	`.agents/skills/` ✅
Subagent 目录	`.opencode/agents/*.md`	`.codex/agents/*.toml`
项目配置	`opencode.json`	`.codex/config.toml` 或全局
权限粒度	YAML permission 细粒度（按工具/按命令）	sandbox_mode 粗粒度（read-only / workspace-write / danger-full-access）
AGENTS.md	✅ 根目录	✅ 根目录

两个关键发现：

Skill + Subagent ：用 OpenCode 替代 Terraform 做阿里云运维

Thu, 18 Jun 2026 17:20:28 +0800

从 Terraform 说起链接到标题

之前一直用 Terraform 管理阿里云资源：DNS 记录、安全组规则、ECS 查询。

Terraform 是优秀的基础设施编排工具，但日常运维中使用它有些痛点：

操作重：改一条 DNS 记录也要跑完改 HCL → plan → apply 全套流程
State 维护繁琐：即使使用 OSS 后端，每次操作前要 pull state，操作后要 push state。多人操作时还要处理 lock 超时或冲突
查询不便：查一条 DNS 记录，要么 terraform state list 再 grep，要么混用 aliyun CLI，反而多一套工具
过设计：只有几台 ECS、几十条 DNS 记录的场景，Terraform 的"全量声明式"模型过于笨重

这些痛点本质上是因为：Terraform 是为"基础设施全生命周期管理"设计的，不是为"今天改条记录明天加个端口"设计的。

而日常运维中后者才是常态。

更轻量的方案：aliyun CLI 链接到标题

aliyun CLI 一条命令就能完成 Terraform 改 HCL → plan → apply 三件事：

# 查 DNS 记录
aliyun alidns DescribeDomainRecords --DomainName example.com

# 添加 A 记录
aliyun alidns AddDomainRecord --DomainName example.com --RR www --Type A --Value 1.2.3.4

# 更新 A 记录
aliyun alidns UpdateDomainRecord --RecordId <id> --RR www --Type A --Value 5.6.7.8

# 查安全组规则
aliyun ecs DescribeSecurityGroupAttribute --SecurityGroupId <sg-id>

找到正确的命令和参数比跑 Terraform 快得多。但问题在于：每次都记不住这些命令的参数格式。

OpenCode 静态记忆架构从零配置指南

Thu, 18 Jun 2026 15:02:38 +0800

问题链接到标题

每次启动 OpenCode，agent 对你的项目结构、主机信息、常用操作一无所知。

今天查过的主机列表，明天又要重新解释。这周写过的部署流程，下周 agent 又忘了。每次都在重复——低效且容易遗漏。

解决思路是用配置文件构建"静态记忆"：一次配置，提交 git，每个新会话自动生效。

什么是静态记忆架构链接到标题

静态记忆 = 提交到 git 的配置文件，OpenCode 每次启动自动读取或按需加载。

它和"动态记忆"（MCP 插件、向量数据库）的区别：静态记忆没有运行时依赖，不消耗额外服务，修改就是改 .md 文件提交 git。

完整架构由四层组成：

~/.config/opencode/AGENTS.md          ← 全局层（个人规则）
./AGENTS.md                            ← 项目层（路由 + 懒加载规则）
.opencode/opencode.json                ← 配置层（instructions + 权限）
.opencode/skills/<name>/SKILL.md       ← 技能层（按需加载的工作流）
docs/*.md                              ← 内容层（按需读取的知识库）

下面逐层搭建。

第一层：全局 AGENTS.md 链接到标题

全局规则放在 ~/.config/opencode/AGENTS.md，所有项目都生效，不提交 git。

用中文回答问题。
回答简洁，不废话，不说"好的"、"明白了"等开场白。

适合放这里的内容：

你的名字和称呼方式
语言偏好
通用的回复风格要求
个人常用快捷键或工作流偏好

第二层：项目 AGENTS.md 链接到标题

项目根目录的 AGENTS.md 是静态记忆的核心。运行 opencode /init 可以自动生成骨架。

macOS 下用函数快速启动 VS Code SSH Remote

Sun, 14 Jun 2026 19:59:37 +0800

背景链接到标题

日常开发免不了频繁通过 VS Code 的 Remote SSH 连接远程服务器。每次都要敲：

code --remote ssh-remote+some-host /home/user/project

路径要记、主机名要打、目录要拼，烦。

能不能 rcode my-server 就完事？

其他方案对比链接到标题

先看看除了敲命令，还有哪些方式打开 Remote SSH：

方案	操作步骤	评价
VS Code 命令面板	`F1` → “Remote-SSH: Connect to Host…” → 选主机 → `File > Open Folder` → 选目录	点选四五次，慢
本地终端 `code --remote`	`code --remote ssh-remote+some-host /home/user/project`	可用，但路径要自己记
macOS `open` 打开 URL	`open vscode://vscode-remote/ssh-remote+some-host/home/user/project`	可脚本化，但路径写死
Markdown/HTML 中放 VS Code 链接	在文档里写 `vscode://vscode-remote/ssh-remote+some-host/home/user/project`，浏览器点击触发	适合文档入口，但仍然路径写死
终端别名/函数	本文方案	一行搞定

这里容易踩一个坑：code 是本地 macOS 上的 VS Code CLI，不是远程服务器上的命令。已经 SSH 登录到远程机器后再敲 code .，通常只会得到 command not found。

效率工具 on OHTLY Blog

同时适配 OpenCode 和 Codex CLI 的配置方法

问题 链接到标题

全貌对比 链接到标题

Skill + Subagent ：用 OpenCode 替代 Terraform 做阿里云运维

从 Terraform 说起 链接到标题

更轻量的方案：aliyun CLI 链接到标题

OpenCode 静态记忆架构从零配置指南

问题 链接到标题

什么是静态记忆架构 链接到标题

第一层：全局 AGENTS.md 链接到标题

第二层：项目 AGENTS.md 链接到标题

macOS 下用函数快速启动 VS Code SSH Remote

背景 链接到标题

其他方案对比 链接到标题

问题链接到标题

全貌对比链接到标题

从 Terraform 说起链接到标题

问题链接到标题

什么是静态记忆架构链接到标题

背景链接到标题

其他方案对比链接到标题