Codex on OHTLY Blog

Codex CLI 与 OpenCode 的对比

Wed, 24 Jun 2026 17:22:48 +0800

OpenAI 去年发布了 Codex CLI，加上社区早已熟知的 OpenCode（SST 团队从零构建，受 Claude Code 启发，与 OpenHands/OpenDevin 无关），两者代表了终端 AI 编码代理的两个不同方向。这篇文章记录实际使用和社区反馈的综合对比。

同时适配 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	✅ 根目录	✅ 根目录

两个关键发现：

Codex CLI 网络代理设置

Wed, 24 Jun 2026 15:52:35 +0800

Codex CLI 默认直连网络。在国内网络环境或企业内网中，通常需要通过 HTTP 代理（Clash、Surge、Zscaler 等）访问外网。

代理机制链接到标题

Codex CLI 的 HTTP 客户端（Rust/reqwest）读取以下环境变量：

HTTP_PROXY / http_proxy — HTTP 代理地址
HTTPS_PROXY / https_proxy — HTTPS 代理地址
NO_PROXY / no_proxy — 绕过代理的地址列表
ALL_PROXY / all_proxy — 兜底代理

优先级：HTTPS_PROXY > HTTP_PROXY > ALL_PROXY。

配置方式链接到标题

推荐：`.env` 文件链接到标题

Codex 启动时自动加载 ~/.codex/.env，将其中定义的环境变量注入进程。

HTTP_PROXY=http://127.0.0.1:7890
HTTPS_PROXY=http://127.0.0.1:7890
NO_PROXY=localhost,127.0.0.1,.lan,内网 IP 段

优点：不污染 shell 配置，只对 Codex 生效，与 opencode 等工具兼容。

备选：Shell 环境变量链接到标题

直接写在 ~/.zshrc 或 ~/.bashrc 中：

Codex CLI 用 DeepSeek 的协议转换方案

Wed, 24 Jun 2026 14:35:40 +0800

Codex CLI 是 OpenAI 出品的终端编码 agent。2026 年 2 月起，Codex 只支持 OpenAI Responses API（/v1/responses），不再兼容 Chat Completions（/v1/chat/completions）。DeepSeek 官方 API 只提供 Chat Completions 接口，两者协议不互通。

需要一个协议转换层。

方案对比链接到标题

方案	原理	评价
Chutes	云端 Responses→Chat 翻译	依赖第三方云服务
LiteLLM	全能 AI 网关	功能太多，对 Codex 场景大材小用
open-codex fork	用 Chat API 重写	已停更
Moon Bridge	本地 Go 代理，协议转换 + 路由	DeepSeek 官方推荐，轻量专注

Moon Bridge 是 Go 写的协议转换代理，对外暴露 POST /v1/responses，对内将请求转为 Anthropic Messages API 格式发给 DeepSeek（DeepSeek 兼容 Anthropic 协议）。支持多 Provider 路由、请求跟踪、Web Console 管理。

Codex on OHTLY Blog

Codex CLI 与 OpenCode 的对比

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

问题 链接到标题

全貌对比 链接到标题

Codex CLI 网络代理设置

代理机制 链接到标题

配置方式 链接到标题

推荐：.env 文件 链接到标题

备选：Shell 环境变量 链接到标题