登录注册

OpenCode

OpenCode 是开源的 AI 编程 Agent，可以在终端、桌面应用和 IDE 插件中使用。它不绑定任何一家模型厂商，官方内置 75+ 个提供商，也可以连接任何 OpenAI 兼容接口。

注册并进入 Portal查看接入教程

已有账号？登录

codelux.config示意
agent
opencode
endpoint
codelux.io/v1/messages
route
anthropic / claude-sonnet-5
status
可用
  • OpenCode
Codelux Gateway
  • claude-sonnet-5
  • claude-opus-5-5
  • gpt-6-sol
  • DeepSeek-V41-Flash
  • kimi-k3
  • glm-5.3
示意：OpenCode 通过 codelux.io/v1/messages 连接 Codelux Gateway，选用 anthropic / claude-sonnet-5。同一个 Agent 可以切换使用 claude-sonnet-5、claude-opus-5-5、gpt-6-sol、DeepSeek-V41-Flash、kimi-k3、glm-5.3 等模型。

OpenCode 接入 Codelux 教程

约 10 分钟：安装 OpenCode → 在 Portal 创建密钥 → 用 CC-Switch 导入或用 /connect + opencode.json 添加 provider → 选择模型开始使用。

一、安装 OpenCode

需要一个现代终端（如 WezTerm、Alacritty、Ghostty、Kitty）。Windows 官方推荐在 WSL 中使用。

运行安装命令

终端
curl -fsSL https://opencode.ai/install | bash

验证安装

在项目目录中运行 opencode，能看到 OpenCode 界面即安装成功。之后可以用 opencode upgrade 升级。

终端
cd your-project
opencode
OpenCode 终端界面
OpenCode 终端界面。 · OpenCode (MIT)

二、配置 Codelux 为第三方 Provider

方式 A：CC-Switch 一键导入；方式 B：用 /connect 保存密钥，并在 opencode.json 中声明 Codelux provider 与模型。

注册 Codelux 并创建 API 密钥

  1. 打开 Codelux Portal 注册账号（已有账号直接登录）。
  2. 在「财务中心」选择订阅套餐或按需充值——余额对所有 Agent 通用。
  3. 在左侧菜单进入「API 密钥」，点击「新建密钥」，名称建议写成对应 Agent 的名字，方便以后区分用量。
  4. 创建成功后，复制「API 密钥」（以 sk- 开头）和「API 地址」。密钥只完整显示一次，请妥善保存。

安装 CC-Switch

CC-Switch 是开源（MIT）的桌面应用，统一管理 Claude Code、Codex、Gemini CLI、OpenCode 等工具的 API 供应商，自动写入各工具的配置文件，免去手动编辑。系统要求：Windows 10 及以上、macOS 12 及以上，或 glibc 2.35+ 且带 WebKitGTK 4.1 的 Linux x86_64/ARM64（如 Ubuntu 22.04+、Debian 12+）。

推荐使用 Homebrew 安装：

终端
brew install --cask cc-switch

也可以在 Releases 下载 CC-Switch-v{版本号}-macOS.dmg。这是通用包（Apple Silicon 与 Intel 均可运行），已通过 Apple 签名与公证。

CC-Switch 主界面，列出 Claude Code 的供应商
CC-Switch 主界面：顶部选择要配置的工具，再启用对应供应商；右上角橙色「+」用于添加新供应商。

从 Portal 一键导入到 CC-Switch

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

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

CC-Switch 添加新供应商表单，已填写 Codelux 的供应商名称、官网链接、API Key 与请求地址
在 CC-Switch 中手动添加 Codelux。Claude Code 的请求地址只填域名，不要以斜杠结尾。

OpenCode 在 CC-Switch 中是“共存”式工具：卡片按钮为「添加」，可以同时保留多个供应商，在 OpenCode 里用 /models 选择。导入后需要关闭并重新打开终端。

（方式 B）用 /connect 保存密钥

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

（方式 B）在 opencode.json 中添加 provider

编辑全局配置 ~/.config/opencode/opencode.json（只想在某个项目使用时，放在项目根目录的 opencode.json）：

~/.config/opencode/opencode.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" },
        "glm-5.2": { "name": "GLM-5.2" }
      }
    }
  },
  "model": "codelux/claude-sonnet-5"
}
  • npm: "@ai-sdk/openai-compatible" 表示使用 Chat Completions 接口（/v1/chat/completions）；
  • baseURL 为 Codelux API 地址加上 /v1；
  • models 下的键是 Portal「AI 中心」中的模型 ID，name 只是显示名称；
  • model 以 provider/model 格式设置默认模型。

不使用 /connect 时，也可以在 options 中加入 "apiKey": "{env:CODELUX_API_KEY}"，从环境变量读取密钥。

三、开始使用

选择 Codelux 模型，初始化项目，然后开始对话。

选择模型

在 OpenCode 中输入 /models，列表中会出现 Codelux 分组，选中需要的模型即可。也可以在终端里查看所有可用模型：

终端
opencode models

常用操作

操作作用
/init分析项目并生成 AGENTS.md（建议提交到 Git）
Tab在 Plan（只规划不修改）与 Build 模式之间切换
@模糊搜索文件并加入提示词
/undo · /redo撤销或重做上一次修改
/models切换模型

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

常见问题

/models 里看不到 Codelux 模型？

确认 /connect 时填写的 Provider ID 与 opencode.json 中 provider 下的键名（codelux）一致，然后重启 OpenCode。

报 ProviderModelNotFoundError？

模型引用写错了。请使用 codelux/<模型ID> 格式，并用 opencode models 核对。

请求报 401 或 404？

401：用 opencode auth list 检查密钥，或重新 /connect；404：baseURL 应以 /v1 结尾。

日志在哪里？

在 ~/.local/share/opencode/log/，启动时加 --log-level DEBUG 可以看到更详细的信息。

官方参考资料