この記事は Flatkey AI 公式アカウントの技術検証メモです。OpenAI 互換 API を使うときの一般的な設定手順を整理します。
背景
Claude Code や Cline のような AI コーディングツールでは、モデル provider を切り替えたい場面があります。
- 高性能モデルと低価格モデルを使い分けたい
- 複数 provider の API key を 1 本にまとめたい
- rate limit や障害時に別モデルへ切り替えたい
- 利用コストをログで見たい
OpenAI 互換 API に対応している Gateway であれば、多くの場合は base_url と api_key を差し替えるだけで検証できます。
最小設定
必要なのは次の 2 つです。
API Key
Base URL
OpenAI SDK では次のような形になります。
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.API_KEY,
baseURL: process.env.BASE_URL,
});
const res = await client.chat.completions.create({
model: "your-model",
messages: [{ role: "user", content: "hello" }],
});
console.log(res.choices[0].message.content);
Cline 側で見るポイント
Cline では、次の点を確認します。
- provider に OpenAI compatible を選べるか
- API key を保存できるか
- Base URL を指定できるか
- model id を手入力できるか
設定後は、まず小さな prompt で確認します。
このリポジトリの package.json を読んで、使っている主要ライブラリを教えてください。
ハマりやすい点
model id が違う
Gateway によって model id の書き方が違います。gpt-4.1 のような短い名前ではなく、provider 名を含む場合もあります。
streaming の差
チャットだけ動いても、streaming が不安定だと UX が悪くなります。Cline では長い処理が多いので、streaming の確認は必要です。
tool use
AI coding tool では tool use が重要です。単純な chat completion だけではなく、実際にファイル編集やコマンド提案が自然に動くかを見ます。
まとめ
Claude Code / Cline の接続先を切り替える検証では、最初から大きな作業を投げずに、次の順で確認すると安全です。
- chat completion が返る
- streaming が安定する
- model id が期待通り解決される
- tool use が崩れない
- コストと rate limit を確認する
Flatkey でも OpenAI 互換 API の設定例を整理しています。検証するときは、まず小さな prompt から始めるのがおすすめです。