asahiluna/opencode-omo-baidu-qianfan

Public

WeChat Login

Code Issues Pull requests Events Packages Insights

master

Branch

Tag

marcus<marcus@alpgo.cc>

docs: simplify README, focus on qf-env alias usage

e9077c38

11 commits

.claude
opencode-source
.env.local.example
.gitignore
.opencode
AGENTS.md
CLAUDE.md
README.md
install.sh

OpenCode AI + Baidu Qianfan (Coding Plan)

This project demonstrates OpenCode AI configured with Baidu Qianfan Coding Plan as the LLM provider.

OpenCode Version

Version: 1.2.26
Git Tag: v1.2.26
Commit: d954026d
Source: https://github.com/anomalyco/opencode

Source Code

OpenCode 源码位于 opencode-source/ 目录，用于自定义构建。

# 从源码构建
cd opencode-source
bun install
bun run build

详见 opencode-source/SOURCE.md

Modifications for Baidu Qianfan

本项目通过配置文件实现百度千帆集成，未修改 OpenCode 源码。如需深度定制，可在 opencode-source/ 中修改。

配置修改说明

文件	修改内容
`.opencode/opencode.json`	设置 `provider.anthropic.options.baseURL` 指向百度千帆
`.opencode/oh-my-opencode.json`	配置 Agent 模型映射，使用千帆支持的模型名称
`.env.local`	存储 `QIANFAN_API_KEY`

关键配置

// .opencode/opencode.json
{
  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://qianfan.baidubce.com/anthropic/coding/v1"
      }
    }
  }
}

Baidu Qianfan Coding Plan - Supported Models

百度千帆 Coding Plan 支持以下模型：

Model ID	Description	Best For
`qianfan-code-latest`	千帆编程专用模型	编码、Debug、代码生成
`kimi-k2.5`	Kimi K2.5 (262K context)	代码探索、长文档分析
`deepseek-v3.2`	DeepSeek V3.2	复杂推理、架构决策
`glm-5`	GLM-5	中文创意、写作
`minimax-m2.5`	MiniMax M2.5	前端/UI、多模态任务

Model Name Format

在配置中使用 anthropic/<model-id> 格式：

{
  "agents": {
    "oracle": {
      "model": "anthropic/deepseek-v3.2"
    },
    "explore": {
      "model": "anthropic/kimi-k2.5"
    }
  }
}

百度千帆网关会将请求路由到对应的模型。

Quick Start

Prerequisites

OpenCode AI CLI installed (v1.2.26+)
Baidu Qianfan Coding Plan API key
Node.js 18+

Setup

# Clone repository
git clone <repo-url>
cd opencode-omo-baidu-qianfan

# Install dependencies
cd .opencode && npm install && cd ..

# Configure API key
cp .env.local.example .env.local
# Edit .env.local with your QIANFAN_API_KEY

Environment Variables

# .env.local
QIANFAN_API_KEY=bce-v3/ALTAKSP-...

# Optional: AK/SK authentication
# QIANFAN_ACCESS_KEY=
# QIANFAN_SECRET_KEY=

Quick Start with qf-env

在 ~/.zshrc 或 ~/.bashrc 中添加以下 alias，使用千帆模型启动 OpenCode（带 oh-my-opencode 配置）：

# 使用百度千帆模型启动 OpenCode
alias qf-env='source ~/.local/bin/opencode-qf 2>&1 || echo "---" && echo "OPENCODE_CONFIG_DIR=$OPENCODE_CONFIG_DIR"'

添加后运行 source ~/.zshrc 生效。

作用：qf-env 会设置 OPENCODE_CONFIG_DIR 环境变量，指向本项目的 .opencode 配置目录，使 OpenCode 使用百度千帆模型和 oh-my-opencode 的 Agent 模型映射。

Project Structure

.
├── .claude/                       # Claude Code 配置 (符号链接为 .opencode)
│   ├── opencode.json              # Provider config (Baidu Qianfan)
│   └── oh-my-opencode.json        # Agent model mappings
├── .opencode -> .claude           # 符号链接
│   └── skills/                    # Skills 符号链接 (可选)
│       ├── feishu-progress-reporter -> ~/.config/opencode/skills/...
│       ├── multi-agent-orchestrator -> ~/.config/opencode/skills/...
│       └── worktree-branch -> ~/.config/opencode/skills/...
├── opencode-source/               # OpenCode 源码 (v1.2.26)
│   ├── packages/opencode/         # 核心 CLI 代码
│   ├── SOURCE.md                  # 源码说明
│   └── ...
├── .env.local                     # API credentials (gitignored)
├── .env.local.example             # API credentials template
├── opencode-qf                    # 本地启动脚本
├── install.sh                     # 安装脚本
├── AGENTS.md                      # Agent model assignments
├── CLAUDE.md                      # Claude Code project guide
└── README.md                      # This file

Agent Model Assignments

Agent	Model	Use Case
sisyphus	qianfan-code-latest	Main worker, coding
oracle	deepseek-v3.2	Architecture consulting
explore	kimi-k2.5	Code exploration (262K context)
visual-engineering	minimax-m2.5	Frontend/UI tasks
artistry/writing	glm-5	Creative/writing tasks

See AGENTS.md for complete model assignments.

How It Works

Request Flow: OpenCode → Baidu Qianfan Gateway → Backend Model
Model Routing: Gateway maps anthropic/* requests to Qianfan models
Authentication: API key passed via Authorization header

┌─────────────┐     ┌─────────────────────────┐     ┌──────────────┐
│  OpenCode   │────▶│  Baidu Qianfan Gateway  │────▶│  Model APIs  │
│  (anthropic)│     │  (anthropic/coding)     │     │  (千帆模型)  │
└─────────────┘     └─────────────────────────┘     └──────────────┘