【免费下载链接】opencodexUniversal provider proxy for OpenAI Codex Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code项目地址https://gitcode.com/gh_mirrors/ope/opencodex点击查看免费下载opencodexUniversal provider proxy for OpenAI Codex Claude Code在 Claude 入站inbound/v1/messages能力落地的第三个阶段将 Claude 侧配置从手改配置文件推进到GUI 可视化 全文档面覆盖。本文基于仓库中的 Phase 3 规划文档结合 GUI 页面源码、管理 API 实现 与 docs-site 指南 等仓库证据完整讲解/api/claude-code管理接口、侧边栏开关、Claude 配置页、四语言 i18n 同步与三语言文档的落地细节读者可获得该功能从规划、实现到测试门禁的全链路理解。一、Phase 3 的定位让 Claude 侧配置进入现有 Dashboard在整体规划见 000_plan.md中Claude Code 入站能力被拆分为四个 PABCD 周期阶段内容工作分类Phase 1核心入站POST /v1/messagescount_tokenstranslate-and-replay 复用handleResponsesC3Phase 2ocx claude启动器 网关模型发现GET /v1/models 别名层C2-C3Phase 3本文GUI Claude Code 配置区 docs-site/README 多语言文档C2Phase 4加固thinking 回放、错误分类、协议边角 发布C3-C4Phase 3 的核心目标Objective非常明确用户从现有 Dashboard 配置 Claude 侧D2 决策不新增独立 app/端口且所有公开文档面都解释该功能——包括 GUI 配置区、docs-site 文章3 语言、README 行3 语言。它依赖 Phase 1-2 已交付的config.claudeCode消费与模型发现机制本身不改变任何入站行为。值得注意该文档在 2026-07-11 被用户规格修订AMENDED将默认的Models 页内嵌区块方案替换为侧边栏开关 独立 Claude 导航页双入口方案这一修订直接塑造了今天仓库里的实现形态。二、管理 APIGET/PUT /api/claude-code2.1 设计意图Phase 3 规划在 src/server/management-api.ts 中新增GET/PUT /api/claude-code用于读/改config.claudeCode并明确校验规则model id 必须存在于注册表registry中或者是别名aliasmodelMap键非空拒绝未知字段沿用既有 subagentModels 端点模式包括saveConfig与 broadcast变更广播。2.2 实际实现路由与字段面仓库中的管理路由经过演进注册于 src/server/management/route-registry.ts由 src/server/management/agent-settings-routes.ts 处理GETL1271-L1354读取配置并返回完整状态面包括enabled、三态authModeauto/proxy/subscription缺省即 AUTO不做隐式强制转换、markerMode、model/smallFastModel/tierModels、modelMap、systemEnvmacOS 系统环境注入开关、autoContext/autoCompactWindow、maxContextTokens/alwaysEnableEffort等兼容字段以及webSearchSidecar/visionSidecar覆盖、effectiveModelEnv、available路由模型列表与aliases发现别名预览。PUTL1355 起先做 body 合法性校验isPlainObject、JSON 解析失败返回 400再按字段白名单逐项校验model/tierModels/maxContextTokens/alwaysEnableEffort被标记为config-only back-compat 字段——GUI 已不再提供控件默认模型由 Claude Code 的/modelpicker 持有但 PUT 仍校验它们以保护手写配置与旧版 GUI。从实现看该端点承担了配置唯一事实来源的读写代理角色GET 负责把 daemon 端检测结果如authDetection、detectionScope: daemon与别名列表聚合给前端PUT 负责把 GUI 的增量修改安全落盘并广播。三、GUI从侧边栏开关到独立 Claude 配置页3.1 侧边栏 Claude ON 开关按 030 修订规格开关应位于 gui/src/App.tsx 的sidebar-foot、语言选择器上方标签为各语言环境下的字面字符串 Claude ONi18n keyclaude.toggle存在但值在各语言中一致视觉族与theme-toggle相同语义为反映并翻转config.claudeCode.enabled经GET/PUT /api/claude-code。开关关闭时入站/v1/messages*路由应答 403permission_errorClaude inbound disabledAnthropic 风格发现返回{data:[]}默认enabled: true仅环回暴露开关是紧急停止开关而非启用仪式。源码演进印证了这一设计在 App.tsx L388-L391 的注释中明确写道sidebar 只做导航——没有任何行持有变更且ClaudeCode 现在持有 GET/PUT /api/claude-code原来的行已移除。也就是说后续 GUI 重构把开关从导航区迁移到了 ClaudeCode.tsx 页面顶部的连接头部claudecode-connection-head但保留了侧边栏的即时语义toggleConnectionL131-L153非乐观更新——等待 PUT 响应后才翻转 UI 状态因为该开关会写入用户的 Claude 配置文件若 PUT 失败却显示已开启就是欺骗配置connectionInFlightref 序列化快速连点避免三次点击产生三次 PUT。i18n key 的实际落点app.claudeOn在 en.ts L112 中为 Claude ON后续本地化扩展允许了变体如 de.ts 的 Claude AN、日语 Claude オン且每个语言文件都提供claude.toggleAria无障碍标签如 en.ts L2641。3.2 独立 Claude 导航页030 修订点 2 要求在 App.tsx 的 NAV 条目中、api条目正下方新增{id:claude, tkey:nav.claude, Icon:sparkle/bot-ish lucide}渲染新页面 gui/src/pages/ClaudeCode.tsx。当前页面采用工作台 左栏导航布局包含五个 sectionL207-L252Section内容settings连接开关、authMode、autoContext/autoCompactWindow自动压缩窗口下拉阶梯 100k–1M、fastMode、sidecar 覆盖等经ClaudeCodeSettingsCard渲染quickstartocx claude一行命令 非 ocx 启动的手动 env 块buildManualEnv(state)smallFast小快模型槽位下拉选项来自backgroundHelperOptions(state.available, ...)——复用 Subagents 页的同一路由模型列表获取模式modelMap入站 id → 路由 id 键值对行编辑器ClaudeCodeModelMapSection支持增删右侧显示行数 metaaliases发现别名预览只读展示别名总数与列表含诚实 display_name只有 settings / smallFast / modelMap 三个 section 显示 Save 按钮sectionEditablequickstart 与 aliases 为只读。saveL155-L188将整页草稿含模型映射过滤空行后的modelMap、sidecar 序列化结果PUT 到/api/claude-code。草稿机制上页面用useDataSurface 会话缓存ocx.claude-code.v1:apiBase实现隐藏标签页保持挂载与草稿保留服务端数据仅在成功读取边界被替换为 draft保持保存→重载行为不变避免同步副作用。3.3 模型发现别名与诚实 display_nameGET/api/claude-code返回的aliases由服务端聚合agent-settings-routes.ts L1286-L1301原生 native slug经listCatalogNativeSlugs()过滤禁用项→claudeCodeNativeAlias(slug)display_name 为slug (native)路由模型 →claudeCodeAlias(provider, id)display_name 为model (provider)全局 fast 开关开启时cursor 模型解析为 fast 身份 id保证 Dashboard 列出的 id 与 Claude Code 实际发现的 id 一致。这正是 Phase 2 别名层src/claude/alias.ts前缀规则id 必须以claude或anthropic开头在 GUI 侧的消费端与 src/server/claude-messages.ts 的入站别名反解resolveAlias/decodeClaudeFastSelector构成完整闭环。四、i18n四语言同 commit 同步030 强调仓库惯例git log 可证i18n 同步必须与功能同 commit 交付新增 key 覆盖gui/src/i18n/{en,ko,zh,de}.ts全部四个语言文件。实际仓库已将语言面扩展至 fr/ja/ru/tr/vi/zh-TW 等且claude.*key 族claude.toggleAria、claude.loadFail、claude.saveFailed、claude.saved、claude.smallFastModel、claude.modelMap、claude.aliases、claude.quickstart等在每一语言文件中成对出现。防漂移机制方面030 的风险节提出de 经常滞后的担忧测试计划要求验证是否存在 i18n key 一致性测试否则新增最小 key-diff 测试。实际验证中cd gui bun run build依赖tsc -b强制执行 i18n key 奇偶校验见 050_close.md 的 gate 证据使 key 漂移成为编译错误而非运行时缺失。五、docs-site 文章与 README 行030 规划在docs-site/src/content/docs/guides/claude-code.md新增英文文章及ko/、zh-cn/翻译并在 astro.config.mjs 侧边栏注册内容须覆盖quickstartocx claude、发现/picker 工作原理含前缀别名解释、槽位映射表、非 ocx 启动的手动 env 设置、count_tokens 近似说明、troubleshooting版本门禁、非环回认证。仓库现状完全兑现并超出指南现存8 个语言版本en、ko、zh-cn、zh-tw、ja、fr、ru、tr。指南开头即点明定位opencodex 在同一端口上提供POST /v1/messages及count_tokens与/v1/responsesClaude Code 因此可用所有路由 provider——OAuth 登录、账户池、key 故障转移与 sidecar 全部复用零额外认证工作。Quickstart 的环境变量表完整呈现了 src/cli/claude.ts 注入的 env 槽位仅举关键项变量值ANTHROPIC_BASE_URLhttp://127.0.0.1:portANTHROPIC_AUTH_TOKEN仅当代理要求 API key 时注入否则不设置保留 claude.ai 订阅与 connectorsCLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY1原生/modelpicker 发现ANTHROPIC_MODELclaudeCode.model可选ANTHROPIC_DEFAULT_HAIKU_MODELclaudeCode.tierModels.haiku ?? claudeCode.smallFastModel兼容旧ANTHROPIC_SMALL_FAST_MODELANTHROPIC_DEFAULT_{OPUS,SONNET,FABLE}_MODELclaudeCode.tierModels.*可选用户自行导出的变量始终优先额外参数透传ocx claude -p hello。指南还记录了一个微妙的安全修正Bun 运行时会自动加载项目.env/.env.local导致目录里的ANTHROPIC_API_KEY曾与手动 export 无法区分、静默把健康订阅切到 API 计费ocx claude现在忽略仅由项目 dotenv 引入的 Anthropic 凭据故意用 API key 需显式export。README 侧030 要求README.md/README.ko.md/README.zh-CN.md各加一个功能行 简短 Claude Code 小节镜像 Codex quickstart 块作为三语言 README 更新在 050_close.md 中随 WP4 一并交付。六、测试计划与 C 门禁030 的测试计划C gate包含tests/management-api claude-code GET/PUT round-trip 校验拒绝未知字段、非法 body、空 modelMapi18n key 奇偶校验若存在套件模式则复用否则新增最小 key-diff 测试cd gui bun run buildtsc -b与 docs-sitebun run buildastro check全绿视觉检查GUI section 截图桌面 窄屏宽度在 D 前评审文本适配、下拉展开无布局位移命令门禁bun test ./tests/、bun x tsc --noEmit 上述两个 build。三条门禁标准Gate criteria持久性 即时路由生效GUI 修改的配置在 daemon 重启后存活且实时改变路由冒烟切换 small-fast 槽位在 Logs 中看到 haiku 槽位流量移动文档构建 侧边栏链接本地预览验证ko/zh 翻译齐全无占位英文正文全量套件 类型检查 双 build 全绿。实际 gate 证据记录在 050_close.mdbun test ./tests/2126 通过唯一失败为环境既有问题shell PATH 无 nodebun x tsc --noEmit干净GUI/docs-site 双 build 干净docs-site 55 页Playwright 视觉 QA 在隔离 live server端口 18234上验证了 Claude 页在 en ko 渲染、韩语环境下侧边栏开关仍显示字面 Claude ON、点击开关完成 APIenabledfalse→true round-trip、别名列表渲染 9 条诚实 display_name。七、范围边界与风险Out of scope030 明确划出不改动入站/翻译器行为发现的 bug 归入 Phase 4除非阻塞发布不新增 de 语言 docs-site站点仅 en/ko/zh-cnde 只存在于 GUI i18n。风险与对策Models 页拥挤→ 备用方案为独立页面决策在 A 阶段以截图证据记录不在 B 阶段重开讨论最终用户规格直接选择了独立页面方案i18n 漂移de 常滞后→ key-diff 测试使其机械化最终由tsc -b奇偶校验兜底。此外050 记录了两个与本阶段直接相关的实施偏差值得读者注意路径重命名规划中的src/anthropic/*实际落地为src/claude/*避免与既有 provider 适配器 src/adapters/anthropic.ts 冲突测试文件相应为tests/claude-*.test.ts非流式策略路由适配器拒绝内部stream:false入站始终以stream:true回放并通过collectAnthropicMessage将翻译后的 Anthropic SSE 折叠为 JSON 消息给非流式客户端。八、小结Phase 3 的落地闭环验证了该功能面的完整性管理 API 提供配置读写与校验的安全边界GUI 以侧边栏即时开关 独立配置页双入口兑现了 D2不新增独立进程/端口的集成决策i18n 编译期奇偶校验与 docs-site 多语言指南保证了功能可被发现、可被理解、可被检索。开发者若想深入本主题可依次阅读 Phase 3 规划、Phase 1 入站协议、Phase 2 发现与别名、关闭记录再对照 GUI 页面、管理路由、启动器 与 docs-site 指南 进行源码级验证。赞分享【免费下载链接】opencodexUniversal provider proxy for OpenAI Codex Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code项目地址https://gitcode.com/gh_mirrors/ope/opencodex点击查看免费下载相关推荐Claude Code Router 文档站Astro 构建、双语文档体系与 GitHub Pages 部署全解Claude Code Router 文档站Astro 构建、双语文档体系与 GitHub Pages 部署全解 本文以 Claude Code Router后端API网关LLM 网关大模型es-toolkit文档系统多语言文档站建设技术es toolkit文档系统多语言文档站建设技术 引言全球化时代的文档挑战 在开源项目日益全球化的今天多语言文档已成为项目成功的关键因素。es toolk前端后端ok-ww 文档站构建实战基于 MkDocs Material 的多语言文档体系与 GitHub Pages 发布流程ok ww 文档站构建实战基于 MkDocs Material 的多语言文档体系与 GitHub Pages 发布流程 本文以 ok ww鸣潮后台自动战斗、GUI 自动化计算机视觉RPA人工智能创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考