ドキュメント · ガイド

StepCode を任意のモデルで

StepCode は StepFun（阶跃星辰）のターミナルのコーディングエージェントで、コマンドは step です。既定のプロバイダーとモデルは config.toml に、プロバイダーは Pi のプロバイダー形式で models.json にあります。magpie が models.json に magpie という名前のプロバイダーを加え、config.toml で既定にすると、StepCode が DeepSeek、GLM、Kimi、Qwen、Claude、ChatGPT サブスクリプションなど magpie の任意のモデルで動きます。

StepCode の設定

  1. magpie にプロバイダーを追加プロバイダー ページで API キーを追加するか、サブスクリプションにサインインします。
  2. エージェント ページで StepCode のモデルを選ぶvia magpie のモデルを選びます。コマンドラインの magpie step も同じエージェントです。
  3. StepCode を起動StepCode は起動時に二つのファイルを読むので、新しいセッションは選んだモデルで始まります。
ターミナル
magpie stepcode deepseek/deepseek-v4-pro

config.toml と models.json

ファイルは ~/.stepcode に、STEP_CODING_AGENT_DIR が絶対パスならその一つ上のフォルダーにあります。STEPCODE_CONFIG_DIR でフォルダー名を変えていれば、このコンピューターではそれに従います。config.toml に magpie が書くのは次のキーだけで、ほかの内容はそのまま残ります：

ターミナル
# ~/.stepcode/config.toml
defaultProvider = "magpie"
defaultModel = "deepseek/deepseek-v4-pro"
enabledModels = ["…", "magpie/deepseek/deepseek-v4-pro"]

models.json に magpie が書くのは providers.magpie だけです。baseUrl はゲートウェイの /v1、api は openai-completions、apiKey は magpie が StepCode 用に出すキーで、models に magpie のモデルが並びます。models.json にはコメントを書けます（JSONC）。magpie は先にこれを確かめ、ルート、providers、providers.magpie がオブジェクトでなければ何も書かず、ファイルを壊しません。

ターミナル
// ~/.stepcode/models.json
{
  "providers": {
    "magpie": {
      "name": "magpie",
      "baseUrl": "http://127.0.0.1:3425/v1",
      "api": "openai-completions",
      "apiKey": "",
      "models": [ { "id": "deepseek/deepseek-v4-pro", … } ]
    }
  }
}

enabledModels の範囲

enabledModels はモデルに当てるパターンの範囲です。StepCode は起動時、範囲のパターンが既定のモデルに当たればそれを使い、当たらなければ範囲の最初のエントリ（:レベル の接尾辞を外したもの）を使います。そのため既定を変えるだけでは足りず、範囲があるときは magpie が選んだモデルを範囲に追加し、自分が加えたことを覚えます。元に戻すときはそれだけを外し、自分で書いた範囲はそのままです。プロバイダーの名前が変わると、範囲のエントリも一緒に変わります。

元に戻す

最初の書き込みの前に、magpie は元の既定のプロバイダー、モデル、範囲、元の providers.magpie の本文、config.toml・models.json・providers がもともとあったかを保存します。元に戻すとこれらをすべて戻し、magpie が作ったファイルは消します。

ターミナル
magpie stepcode default

よくある質問

StepCode で DeepSeek、GLM、ChatGPT サブスクリプションを使えますか？

使えます。magpie のエージェントページで StepCode に via magpie のモデルを選び、StepCode を起動します。

defaultModel を設定したのに StepCode が別のモデルで始まるのはなぜですか？

enabledModels があると、範囲に当たるときだけ既定のモデルが使われます。magpie は選んだモデルを範囲に追加し、元に戻すときはそれだけを外します。

コメント付きの models.json でも使えますか？

使えます。magpie は JSONC として読み、ルート、providers、providers.magpie がオブジェクトでなければ書きません。

元に戻すと設定も戻りますか？

戻ります。元のプロバイダー、モデル、範囲、providers.magpie が戻り、magpie が作ったファイルは消えます。

同じモデルを他のエージェントでも：Avibe を任意のモデルで、MothX を任意のモデルで、Pi を任意のモデルで、omp を任意のモデルで。エラーが出るときは よくあるエラーの直し方、または Discord で質問してください。