OpenCodex：将任意LLM路由到Codex和Claude Code

项目简介

OpenCodex 是一个本地代理工具，能将任何LLM提供商（OpenAI、Anthropic、Gemini、本地模型等）路由到Codex、Claude Code、Claude Desktop或Grok Build等AI编程工具。它通过协议转换实现完全功能对等——即使用开源模型替代付费API，也能享受Codex的代码生成、Claude Code的智能编程等高级功能。OpenCodex在本地运行，数据不经过第三方服务器，保障了代码隐私和API密钥安全。

如果你对AI编程工具集成感兴趣，也可以参考 CopilotKit集成教程 了解另一种AI编程助手方案。

核心功能与架构

安装指南

OpenCodex通过npm全局安装：

# 全局安装
npm install -g opencodex

# 初始化配置
opencodex init

# 添加LLM提供商
opencodex provider add openai --key sk-xxx
opencodex provider add anthropic --key sk-ant-xxx
opencodex provider add local --url http://localhost:11434 --model llama3

# 查看已配置的提供商
opencodex provider list

# 启动代理服务
opencodex start --port 8888

# 验证连接
opencodex test --provider openai --model gpt-4

使用示例

以下展示如何配置OpenCodex将本地模型路由到Claude Code：

// opencodex.config.ts
import { defineConfig } from "opencodex";

export default defineConfig({
  // 代理监听端口
  port: 8888,

  // 默认路由规则
  routes: {
    // 将Claude Code请求路由到本地Ollama
    "claude-code": {
      target: "local",
      model: "llama3.1:70b",
      fallback: "openai:gpt-4o",
      // 功能映射配置
      mapping: {
        toolUse: "function-calling",
        streaming: true,
        maxTokens: 32768,
      },
    },

    // 将Codex请求路由到Gemini
    "codex": {
      target: "google",
      model: "gemini-1.5-pro",
      fallback: "anthropic:claude-3.5-sonnet",
      mapping: {
        toolUse: "function-calling",
        streaming: true,
      },
    },

    // Grok Build路由到本地模型
    "grok-build": {
      target: "local",
      model: "deepseek-coder-v2",
      fallback: "openai:gpt-4-turbo",
    },
  },

  // 故障转移策略
  fallback: {
    maxRetries: 3,
    timeout: 30000,
    onFallback: (from, to) => {
      console.log(`Fallback: ${from} → ${to}`);
    },
  },

  // 成本控制
  billing: {
    dailyBudget: 10, // 美元
    alertThreshold: 0.8,
    onBudgetExceeded: "fallback-to-local",
  },
});

配置完成后，在Claude Code中设置API端点即可：

# 设置环境变量指向OpenCodex
export CLAUDE_API_BASE="http://localhost:8888"
export CLAUDE_API_KEY="opencodex-proxy"

# 启动Claude Code（实际使用本地模型）
claude-code

# Codex同理
export OPENAI_API_BASE="http://localhost:8888"
export OPENAI_API_KEY="opencodex-proxy"
codex

与同类工具对比