凌晨 1 点，生产环境报错。我启动 Claude Code，输入问题描述，等待分析——红色提示：「Claude usage limit reached. Resets at 2:00 AM (UTC+8)」。想切到 Codex 继续调试，又得找配置文件、填不同格式的环境变量、重启终端。

Codelux 是与 OpenRouter 同类的第三方模型网关服务。一个账号、一套配置，Claude Code、Codex、OpenCode 等工具共用同一个 API 地址和密钥，在会话中随时切换模型，账单统一查看。限流时切到免费模型继续工作，架构设计时用高级模型深度推理，长文档处理时用大上下文模型。

## 绑定单一供应商的四个摩擦点

- **限流阻断工作节奏**：遇到限流只能等重置时间，或切换工具重新配置。
- **横向对比需要多套环境**：测试 DeepSeek V4 Flash 与 Claude Opus 4.8 在代码审查上的差异，要配置两个工具、维护两套环境变量、记住两个命令格式。
- **账单分散难以汇总**：Claude Code 的订阅费、Codex 的 API Key 扣费、Kimi Code 的充值，月底对账要汇总三个平台的用量报表。
- **配置文件格式不统一**：Claude Code 用 `~/.claude/settings.json` 和 `ANTHROPIC_BASE_URL`，Codex 用 `~/.codex/config.toml` 和 `model_provider`，OpenCode 用 `opencode.json` 和 `/connect`。

## Codelux 如何消除摩擦

### 统一网关

Codelux 接收 Agent 发来的请求、识别协议类型（Messages API、Responses API、Chat Completions）、路由到目标模型、返回标准响应。Claude Code 以为自己在调用 Anthropic API，Codex 以为在调用 OpenAI API，它们只需修改 `base_url` 和 API Key。

支持 Claude Code、Codex、OpenCode、Kimi Code、DeepSeek Harness、Tencent WorkBuddy 六个主流 Agent，兼容 OpenAI 与 Anthropic 接口的其他工具也可以接入。

### 模型选择范围

官网公开价格表列出 25+ 顶级模型，按每百万 tokens 计费（输入、输出、缓存写入、缓存读取分别计价）。Portal「AI 中心」展示完整模型列表与实时可用性。

**典型模型与场景**：

- **免费与快速模型**：DeepSeek V4 Flash（零成本，日常查询与代码格式化）、Qwen 系列
- **高级推理模型**：Claude Opus 5.5、GPT-5.6 Sol、Claude Sonnet 5.5
- **大上下文模型**：Kimi K3（1M tokens 上下文，长文档与大型代码库）、Claude Haiku 5.5

在 Claude Code 会话中输入 `/model glm-5.2` 即可切换模型。Portal 日志显示每次请求的模型、tokens 用量、缓存命中率与扣费明细。

## Claude Code 接入 Codelux

约 10 分钟完成。推荐用 CC-Switch 图形化导入，也可以手动编辑 `settings.json`。

### Step 1：安装 Claude Code CLI

**macOS / Linux / WSL**：

```bash
curl -fsSL https://claude.ai/install.sh | bash
```

**Windows PowerShell**：

```powershell
irm https://claude.ai/install.ps1 | iex
```

**Homebrew**：

```bash
brew install --cask claude-code
```

打开新终端，运行 `claude --version` 确认安装成功。

### Step 2：在 Codelux Portal 创建 API 密钥

1. 打开 [Codelux Portal](https://codelux.io) 注册账号。
2. 在「财务中心」充值——余额对所有 Agent 通用。
3. 在左侧菜单进入「API 密钥」，点击「新建密钥」，名称建议写成对应 Agent 的名字（如 `Claude Code`）。
4. 创建成功后，复制「API 密钥」（以 `sk-` 开头）和「API 地址」。

### Step 3a：用 CC-Switch 一键导入（推荐）

[CC-Switch](https://github.com/farion1231/cc-switch) 是开源（MIT）的桌面应用，统一管理多个工具的 API 供应商，自动写入配置文件。系统要求：Windows 10+、macOS 12+、或 glibc 2.35+ 且带 WebKitGTK 4.1 的 Linux（如 Ubuntu 22.04+）。

**macOS（推荐 Homebrew）**：

```bash
brew install --cask cc-switch
```

也可在 [Releases](https://github.com/farion1231/cc-switch/releases) 下载 `CC-Switch-v{版本号}-macOS.dmg`。这是通用包（Apple Silicon 与 Intel 均可运行），已通过 Apple 签名与公证。

**Windows**：在 [Releases](https://github.com/farion1231/cc-switch/releases) 下载 `CC-Switch-v{版本号}-Windows.msi` 安装包并运行。

**Linux**：在 [Releases](https://github.com/farion1231/cc-switch/releases) 按架构下载 `.deb` 或 `.rpm`。以 Ubuntu 为例：

```bash
sudo apt install ./CC-Switch-v*-Linux-x86_64.deb
```

**从 Portal 一键导入到 CC-Switch**：

1. 保持 CC-Switch 运行（首次启动时会注册 `ccswitch://` 链接）。
2. 回到 Portal 刚创建密钥的成功页，找到「导入到桌面客户端」区域。
3. 在 CC-Switch 卡片中把「目标应用」选为「Claude Code」，点击「一键导入」。
4. 浏览器提示打开 CC-Switch 时选择允许。CC-Switch 会弹出确认框，确认后完成添加。
5. 在 CC-Switch 顶部切换到「Claude Code」，确认「Codelux」供应商已启用。

也可以手动添加：在 CC-Switch 点击右上角橙色「+」→「自定义配置」，依次填写「供应商名称」（如 `codelux.io`）、「官网链接」、「API Key」和「请求地址」（不要以斜杠结尾），点击「添加」。

![figure-8e761bcc1a45627a1b917f27.png](https://developer.qcloudimg.com/http-save/yehe-12774008/f6f5554baaf6e8536a54e44dbb4cee51.png)

如果 Claude Code 首次启动时仍要求登录，在 CC-Switch「设置 → 通用」中打开「跳过 Claude Code 初次安装确认」，再重新启动 Claude Code。

![figure-8dec0b6f55e1c392f5f3dcf7.png](https://developer.qcloudimg.com/http-save/yehe-12774008/9316751ea25ccc735161c1a3f4f2c6e6.png)

### Step 3b：手动编辑 settings.json（可选）

不使用 CC-Switch 时，把下面的 `env` 块写入用户设置文件：

| 系统 | 文件路径 |
|------|----------|
| macOS / Linux / WSL | `~/.claude/settings.json` |
| Windows | `%USERPROFILE%\.claude\settings.json` |

**~/.claude/settings.json**：

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://codelux.io",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Codelux密钥",
    "ANTHROPIC_MODEL": "claude-sonnet-5"
  }
}
```

- `ANTHROPIC_BASE_URL`：Codelux 的 API 地址，**不要**带 `/v1`，Claude Code 会自动拼接 `/v1/messages`。
- `ANTHROPIC_AUTH_TOKEN`：你的 Codelux API 密钥。
- `ANTHROPIC_MODEL`（可选）：默认模型，可填 Portal「AI 中心」里的任意模型 ID。

### Step 4：启动并确认连接

```bash
cd your-project
claude
```

进入会话后输入 `/status`，确认：

- `Anthropic base URL` 显示 `https://codelux.io`
- 认证一行显示 `ANTHROPIC_AUTH_TOKEN`

随便发一句话（例如「介绍一下这个项目」），能正常回复即配置完成。

### Step 5：切换模型

在会话中输入 `/model` 打开模型选择器，或直接加模型 ID：

```
/model claude-opus-4-8
/model glm-5.2
/model deepseek-v4-flash
```

切换模型后第一条请求会重新读取整个对话，不命中缓存。

### 常用操作

| 命令 | 作用 |
|------|------|
| `/init` | 扫描项目并生成 `CLAUDE.md` 项目说明 |
| `/status` | 查看 API 地址、凭证来源与已加载的设置文件 |
| `/model` | 切换当前及新会话的模型 |
| `/compact` | 压缩长对话，释放上下文 |
| `claude -p "..."` | 不进入交互界面直接执行一次任务 |

每次请求的模型、tokens 和扣费可以在 Portal「使用日志」中查看。

## Codex、OpenCode、DeepSeek Harness 接入

### Codex：Responses API 与 config.toml

Codex 是 OpenAI 推出的官方 Agent，可以让多个任务并行推进。它的 provider 写在 `~/.codex/config.toml`。推荐用 CC-Switch 一键写入，也可以手动添加。

**手动配置示例**（`~/.codex/config.toml`）：

```toml
model = "gpt-5.5"
model_provider = "codelux"

[model_providers.codelux]
name = "Codelux"
base_url = "https://codelux.io/v1"
env_key = "CODELUX_API_KEY"
wire_api = "responses"
```

- `base_url` 为 Codelux API 地址**加上**`/v1`，Codex 会自动拼接 `/responses`。
- `env_key` 是保存密钥的环境变量名。

把密钥写入环境变量：

**Bash / Zsh**：

```bash
echo 'export CODELUX_API_KEY=sk-你的Codelux密钥' >> ~/.zshrc
source ~/.zshrc
```

**PowerShell**：

```powershell
setx CODELUX_API_KEY "sk-你的Codelux密钥"
```

启动 Codex：

```bash
cd your-project
codex
```

进入界面后输入 `/status` 确认配置，然后发一句话测试。会话中输入 `/model` 切换模型。

### OpenCode：OpenAI 兼容接口与 /connect

OpenCode 是开源的 AI 编程 Agent，不绑定任何一家模型厂商。用 CC-Switch 导入或用 `/connect` + `opencode.json` 手动配置。

**用 /connect 保存密钥**：

1. 启动 `opencode`，输入 `/connect`。
2. 滚动到列表底部，选择「Other」。
3. Provider ID 填 `codelux`（必须与 `opencode.json` 中的键名一致）。
4. 粘贴 Codelux API 密钥，密钥会保存在 `~/.local/share/opencode/auth.json`。

**在 opencode.json 中添加 provider**（`~/.config/opencode/opencode.json`）：

```json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "codelux": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Codelux",
      "options": {
        "baseURL": "https://codelux.io/v1"
      },
      "models": {
        "claude-sonnet-5": { "name": "Claude Sonnet 5" },
        "gpt-5.5": { "name": "GPT-5.5" },
        "kimi-k3": { "name": "Kimi K3" },
        "deepseek-v4-flash": { "name": "DeepSeek V4 Flash" }
      }
    }
  },
  "model": "codelux/claude-sonnet-5"
}
```

- `baseURL` 为 Codelux API 地址**加上**`/v1`。
- `models` 下的键是 Portal「AI 中心」中的模型 ID。

在 OpenCode 中输入 `/models`，列表中会出现 Codelux 分组，选中需要的模型即可。

### DeepSeek Harness：Web UI 与自定义模型 API

DeepSeek Harness（`dsh`）是 DeepSeek 开源的 Agent 框架，核心理念是「一切皆插件」。用 npx 启动 dsh Web UI，在「设置 → 模型」添加自定义模型 API。

**启动 Web UI**：

```bash
cd your-project
npx @deepseek-ai/dsh web
```

默认在 `http://127.0.0.1:3080` 启动。

**添加自定义模型 API**：

1. 打开「设置 → 模型」，点击「添加模型提供商」。
2. 把卡片从「第三方模型提供商」切换到「自定义模型 API」。
3. **Provider ID** 填 `codelux`，**显示名称** 填 `Codelux`。
4. **API 地址** 填 `https://codelux.io/v1`。
5. **API 协议** 选「OpenAI Chat Completions」。
6. **API 密钥** 粘贴 Codelux 密钥。

在「模型目录」中点击「获取可用模型」，搜索并勾选需要的模型，点击「添加所选」。点击「选择工作区」，添加项目目录并选中它。在模型选择器中选择 Codelux 下的模型，然后发送一个任务。

## 协议兼容性：避开三个常见陷阱

### base_url 拼接规则差异

- **Claude Code**：`ANTHROPIC_BASE_URL` 只填域名，不要带 `/v1`，Claude Code 会自动拼接 `/v1/messages`。
- **Codex**：`base_url` 需要以 `/v1` 结尾，Codex 会自动拼接 `/responses`。
- **OpenCode**：`baseURL` 需要以 `/v1` 结尾，OpenCode 会自动拼接 `/chat/completions`。
- **DeepSeek Harness**：在 Web UI 中填完整地址 `https://codelux.io/v1`。

### 工具调用支持

- **Messages API**（Claude Code）：原生支持工具调用，Codelux 直接透传。
- **Responses API**（Codex）：支持工具调用但格式不同，Codelux 会处理协议转换。
- **Chat Completions**（OpenCode/DeepSeek Harness）：需网关转换，Codelux 兼容 `tools` 和 `tool_choice` 参数。

遇到「工具调用失败」错误时，检查当前模型是否支持工具调用（Portal「AI 中心」标注各模型能力）。

### 环境变量命名

| Agent | 环境变量名 | 配置位置 |
|-------|-----------|----------|
| Claude Code | `ANTHROPIC_AUTH_TOKEN` | `settings.json` 中的 `env` 或 shell 环境变量 |
| Codex | `CODELUX_API_KEY` | `config.toml` 中的 `env_key` 指定 |
| OpenCode | （通过 `/connect` 保存） | `~/.local/share/opencode/auth.json` |

检查环境变量是否生效：

```bash
echo $CODELUX_API_KEY                    # Bash / Zsh
echo $env:CODELUX_API_KEY                # PowerShell
```

## 真实工作流：一天五个时段的模型切换

使用 Claude Code、Codex、OpenCode 三个月后，我的典型工作日模型切换：

**晨会准备（9:00）**：用 DeepSeek V4 Flash 总结昨天的 Git 提交。零成本，响应速度快。

**功能开发（10:00-12:00）**：用 Claude Opus 4.8 做架构设计与复杂实现。需要深度推理，愿意为此付费。会话中输入 `/model claude-opus-4-8`。

**代码审查（14:00）**：用 GLM-5.2 审查 PR。中文注释理解更准确。

**调试排错（16:00）**：用 GPT-5.6 Sol 分析日志与堆栈。响应速度与准确度平衡。

**文档整理（18:00）**：用 Kimi K3 处理长文档。1M 上下文无需分段。

Portal「使用日志」显示每次请求的模型、tokens、缓存命中率与扣费。

## 成本优化：一个月使用后的四条经验

以下策略帮我把月度费用从预期的 $200 降到 $85：

**从免费模型起步**：DeepSeek V4 Flash 和 Qwen 处理日常查询与代码格式化。只有遇到复杂推理或长上下文任务才切到付费模型。

**用上下文阈值触发高级模型**：超过 50K tokens 或涉及架构决策时才用 Opus/GPT-5。简单查询优先用 Haiku 或 Flash。

**监控 Portal 日志识别必需场景**：每周查看「使用日志」，找出哪些查询真正需要高级模型。发现至少 30% 的请求可以降级到免费模型。

**利用缓存降低重复成本**：Codelux 支持 prompt caching（5 分钟与 1 小时两档），长对话的重复部分自动缓存。缓存读取价格仅为输入价格的 5%（如 Claude Sonnet 5.5 的缓存读取为 $0.1/MTok，而输入为 $2/MTok）。

## 故障排查：四种常见错误与检查方法

Portal「使用日志」显示每次请求的模型、tokens、扣费与失败原因。

### 401 Unauthorized

检查 API Key 是否正确：在 Portal「API 密钥」页核对，确认密钥未被删除。检查环境变量是否生效：运行 `echo $CODELUX_API_KEY`（Bash/Zsh）或 `echo $env:CODELUX_API_KEY`（PowerShell）。Claude Code 特有：确认 `ANTHROPIC_AUTH_TOKEN` 写在 `~/.claude/settings.json` 或 shell 环境变量中。

### 404 Not Found

检查 `base_url` 是否符合 Agent 的拼接规则：Claude Code 不带 `/v1`，Codex/OpenCode 带 `/v1`。

### Timeout

增加超时设置：在 CC-Switch 中调整「API timeout」，或设置环境变量 `API_TIMEOUT_MS`（如 600000 表示 10 分钟）。

### 模型不支持的功能

检查模型能力：Portal「AI 中心」标注每个模型的上下文限制、工具调用支持、缓存支持。遇到不支持的功能时，切换到支持该功能的模型。

## 高级可能性：仍在探索的四个方向

使用三个月，以下功能仍在尝试：

**自部署环境**：DeepSeek Harness 支持自定义执行环境，可配合 Codelux 做内网模型路由（如连接本地 Ollama 或私有 API）。具体内网部署与 Codelux 结合的步骤需进一步确认。

**MCP 工具集成**：Claude Code 的 MCP 服务器可通过 Codelux 调用外部 API（如票务系统、错误日志）。通过 Codelux 调用外部 API 的具体配置需进一步确认。

**自定义兼容性配置**：OpenCode 的 `opencode.json` 可调整字段映射，DeepSeek Harness 的 `cordis.patch.yml` 可设置 `supportsDeveloperRole: false` 等兼容性选项。

**团队权限管理**：Portal 支持多成员协作，可按项目或团队分配 API Key 与用量配额（具体权限管理能力以 Portal 实际界面为准）。

## 从供应商锁定到自由切换

这套配置把我的编程 Agent 工作流从「遇到限流只能等」变成「立即切换到另一个模型继续工作」，从「三个平台的分散账单」变成「Portal 一张清单查看所有扣费」。

最小起步路径：先配置 Claude Code（10 分钟用 CC-Switch 或 `settings.json`）+ 添加一个免费模型（DeepSeek V4 Flash）作为限流时的回退选项。测试成功后，按需接入 Codex、OpenCode 或其他 Agent。

核心不是选择「最佳供应商」并被锁定，而是为每个任务选择合适模型——简单查询用免费模型，架构设计用高级模型,长文档用大上下文模型。统一网关消除了切换摩擦，让这种灵活性成为日常。

---

**作者披露**：本文作者使用 Codelux 已三个月，独立撰写此文。文中配置示例与成本数据基于作者实际使用经验，不代表所有场景下的效果。

凌晨 1 点，生产环境报错。我启动 Claude Code，输入问题描述，等待分析——红色提示：「Claude usage limit reached. Resets at 2:00 AM (UTC+8)」。想切到 Codex 继续调试，又得找配置文件、填不同格式的环境变量、重启终端。

一个网关接入所有编程 Agent：用 Codelux 让 Claude Code、Codex、OpenCode 自由切换模型

用 Codelux 在 Claude Code 里切换 Claude、GPT、GLM、DeepSeek 等模型：通过 CC-Switch 或 settings.json 配置 ANTHROPIC_BASE_URL，用 /model 命令秒切模型，一个密钥管理所有 Agent。

人工智能

开发工具

云计算

Codelux统一网关，一个API密钥接入ClaudeCode、Codex、OpenCode等主流Agent，25+模型随心切换。限流时秒切免费模型，账单统一查看，成本直降。10分钟完成配置，彻底摆脱供应商锁定，让每个任务用上最合适的模型。

代码解释

文档处理

服务器

DeepSeek

AI编程

Windows

路由

Ubuntu

Cordis

Agent

MacOS

Linux

JSON

2026上云采购 | AI焕新·智启新局

热销域名限时优惠，新客首年免费！


domain

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

一个网关接入所有编程 Agent：用 Codelux 让 Claude Code、Codex、OpenCode 自由切换模型-腾讯云开发者社区-腾讯云

一个网关接入所有编程 Agent：用 Codelux 让 Claude Code、Codex、OpenCode 自由切换模型

一个网关接入所有编程 Agent：用 Codelux 让 Claude Code、Codex、OpenCode 自由切换模型

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐