OpenAlchemyOpenAlchemy

クイックスタート

コーディングエージェントを OpenAlchemy につなぐ

お使いのエージェントをそのまま — Claude Code、OpenClaw Hermes、Cline、Aider、Continue、あるいは OpenAI に対応した任意のツール。ベース URL を 1 つ指定してキーを入れれば、共有 GPU 上のオープンモデルでコーディングできます。

3 ステップ

ゼロから最初のリクエストまで

  1. 1

    プロジェクトとキーを作成

    コンソールにサインインしてプロジェクトを作成し、API キーを発行します。無料枠はクレジットカード不要です。

  2. 2

    エージェントを向ける

    エージェントの設定にベース URL と API キーを入力します。OpenAI 互換の URL、または Claude Code 用の Anthropic 互換 URL のどちらかです。

  3. 3

    モデルを選んで構築

    llama-3.1-8b-instruct などのモデル ID を選び、リクエストを送るだけ。コードを変えずにいつでもモデルを切り替えられます。

2 つの接続方法

1 つのキー、2 つの互換サーフェス

多くのエージェントは OpenAI API を話します。Claude Code は Anthropic Messages API を話します。OpenAlchemy は両方を公開しているので、どちらのツールでも同じキーが使えます。

OpenAI 互換

OpenAI 互換

この base_url とキーを OpenAI SDK や OpenAI 互換エージェント(Hermes・Cline・Aider・Continue・Codex CLI)に設定するだけ。

ベース URL
https://api.openalchemy.io/v1
API キー(環境変数)
OPENALCHEMY_API_KEY
Anthropic 互換

Anthropic 互換

これを ANTHROPIC_BASE_URL に設定すれば、Claude Code は Messages API の呼び出しをプロキシなしで OpenAlchemy に送ります。

ベース URL
https://api.openalchemy.io
API キー(環境変数)
OPENALCHEMY_API_KEY

エージェント設定

各エージェントのコピペ設定

各スニペットは作成した OPENALCHEMY_API_KEY と例のモデル llama-3.1-8b-instruct を使用します。カタログの任意のモデルに差し替えできます。

Claude Code

Anthropic 互換

Anthropic のターミナル向けコーディングエージェント。Anthropic 互換エンドポイント経由で接続します。

bash
# Claude Code speaks the Anthropic Messages API — point it at
# OpenAlchemy's Anthropic-compatible endpoint and run as usual.
export ANTHROPIC_BASE_URL="https://api.openalchemy.io"
export ANTHROPIC_AUTH_TOKEN="$OPENALCHEMY_API_KEY"
export ANTHROPIC_MODEL="llama-3.1-8b-instruct"

claude
エージェントのドキュメント

OpenClaw Hermes

OpenAI 互換

Hermes の OpenAI 互換プロバイダを OpenAlchemy に向け、モデルを選択します。

bash
# Hermes uses an OpenAI-compatible provider. Export the base URL and
# key, then select the model inside Hermes.
export OPENAI_BASE_URL="https://api.openalchemy.io/v1"
export OPENAI_API_KEY="$OPENALCHEMY_API_KEY"

# Provider:  OpenAI-compatible
# Base URL:  https://api.openalchemy.io/v1
# Model:     llama-3.1-8b-instruct
hermes
エージェントのドキュメント

Cline / Roo Code

OpenAI 互換

VS Code の自律コーダー(Roo Code フォークも)。「OpenAI Compatible」プロバイダを使用します。

ini
# VS Code → Cline (or Roo Code) settings → API Provider:
API Provider   = OpenAI Compatible
Base URL       = https://api.openalchemy.io/v1
API Key        = $OPENALCHEMY_API_KEY
Model ID       = llama-3.1-8b-instruct
エージェントのドキュメント

Aider

OpenAI 互換

ターミナルのペアプログラマー。Aider は OPENAI_API_BASE 経由で openai/llama-3.1-8b-instruct をルーティングします。

bash
export OPENAI_API_BASE="https://api.openalchemy.io/v1"
export OPENAI_API_KEY="$OPENALCHEMY_API_KEY"

aider --model openai/llama-3.1-8b-instruct
エージェントのドキュメント

Continue.dev

OpenAI 互換

オープンソースの IDE アシスタント。カスタム apiBase の openai プロバイダを追加します。

yaml
# ~/.continue/config.yaml
models:
  - name: OpenAlchemy
    provider: openai
    apiBase: https://api.openalchemy.io/v1
    apiKey: ${OPENALCHEMY_API_KEY}
    model: llama-3.1-8b-instruct
エージェントのドキュメント

OpenAI SDK & Codex CLI

OpenAI 互換

OpenAI SDK 上に構築された任意のツール(Codex CLI を含む)は、同じ base_url とキーで接続します。

python
from openai import OpenAI

client = OpenAI(
    base_url="https://api.openalchemy.io/v1",
    api_key="$OPENALCHEMY_API_KEY",
)

resp = client.chat.completions.create(
    model="llama-3.1-8b-instruct",
    messages=[{"role": "user", "content": "Write a haiku about distributed GPUs."}],
)
print(resp.choices[0].message.content)

# Codex CLI: add a custom provider with the same base_url + key.
エージェントのドキュメント

FAQ

開発者からよくある質問

API は OpenAI 互換ですか?

はい。/v1 サーフェスは OpenAI REST API(チャット補完・埋め込み・音声ほか)をミラーしています。既存の OpenAI SDK やツールは base_url とキーを変えるだけで動作します。

Claude Code で使えますか?

はい。OpenAlchemy は Anthropic 互換エンドポイントも公開しています。ANTHROPIC_BASE_URL を https://api.openalchemy.io に、ANTHROPIC_AUTH_TOKEN をキーに設定するだけ。プロキシは不要です。

どのモデルを使えますか?

各モダリティのオープンウェイトモデル — チャット用の Llama・Qwen・DeepSeek・Gemma に加え、Whisper・埋め込み・リランカーなど。GET /v1/models で一覧し、ID をリクエストに渡します。

クレジットカードは必要ですか?

いいえ。無料枠ではカードなしでプロジェクトを 1 つ作成し、最初の 1,000 リクエストを実行できます。

課金とアクセスの範囲は?

使用量・クォータ・リクエストログはプロジェクト単位、レート制限とアクセス制御はドメイン単位で適用されます。キーがそのスコープを自動的に持ちます。

ストリーミングは使えますか?

ストリーミング応答(SSE)は順次対応中で、一部のエンドポイントは現在 stream:true に対して 501 を返します。非ストリーミングのリクエストは現在も完全にサポートされています。

構築をはじめる

数分でエージェントを接続

無料プロジェクトを作成してキーを取得し、Grid 上で動くオープンモデルにエージェントを向けましょう。