OpenCodeのインストールとDeepSeekの接続

Written by

in

OpenCode は、ターミナル内に常駐するオープン プログラミング エージェントです。プロジェクト ファイルの読み取り、コードの編集、コマンドとテストの実行、リポジトリの検索、git の操作が可能です。これは、Claude Code や他のコンソール エージェントが行うこととほぼ同じです。主な違いは、OpenCode が 1 つのモデル プロバイダーに関連付けられていないことです。DeepSeek を含む数十のプロバイダーを OpenCode 経由で接続できます。この投稿では、エージェントのインストールと DeepSeek への接続について説明します。

必要なもの

作業するには次の 2 つのことだけが必要です。

  • 最新の端末。 WezTerm、Alacritty、Ghostty、Kitty などの端末を使用できます。
  • プロバイダーの API キー。 この場合は、DeepSeek。

標準のインストール スクリプトを使用してエージェントをインストールする場合、Node.js は必要ありません。バイナリは既製の状態で届きます。

インストール

最も簡単な方法は、公式のインストール スクリプトです。

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

プラットフォーム自体を検出し、実行可能ファイルを PATH に配置します。インストール後、すべてが所定の位置にあることを確認する必要があります。

opencode --version

コマンドでバージョンが表示されれば、インストールは成功しています。

他の方法を使用したインストール

パッケージ マネージャーを使用したい場合は、いくつかのオプションがあります。 Node.js経由:

npm install -g opencode-ai

Bun、pnpm、Yarn でも同じことができます。

bun install -g opencode-ai
pnpm install -g opencode-ai
yarn global add opencode-ai

macOS と Linux には Homebrew があります。注意してください: これは開発者からの提案であり、公式の公式ではなく推奨されています。更新頻度は低くなります。

brew install anomalyco/tap/opencode

Arch Linux の場合:

sudo pacman -S opencode
paru -S opencode-bin

最初のコマンドはリポジトリから安定バージョンをインストールし、2 番目のコマンドは AUR から最新バージョンをインストールします。

Windows へのインストール

Windows では、WSL を介して作業することをお勧めします。これにより、パフォーマンスが向上し、エージェントの機能との互換性が完全になります。ただし、ネイティブメソッドもあります。 Chocolatey、Scoop、または npm 経由:

choco install opencode
scoop install opencode
npm install -g opencode-ai

Docker コンテナーだけでなく、Mise を介したオプションもあります。

mise use -g github:anomalyco/opencode
docker run -it --rm ghcr.io/anomalyco/opencode

最後に、完成したバイナリは、GitHub のリリース ページからいつでも取得できます。

ディープシーク キー

キーは DeepSeek 個人アカウントで作成されます。 platform.deepseek.com に移動し、API キーのセクションを開き、[新しいキーの作成] をクリックします。結果の文字列はすぐに保存することをお勧めします。表示されるのは 1 回だけです。

ディープシーク接続

その後、すべてがエージェント自体の内部で行われます。ターミナルで OpenCode を起動します。

opencode

インターフェイスで接続コマンドを実行します。

/connect

開いたプロバイダーのリストで DeepSeek を探し、選択して API キーを挿入します。この方法で追加されたキーはファイルに保存されます。

~/.local/share/opencode/auth.json

接続後は、次のコマンドでモデルを選択するだけです。

/models

deepseek-v4-pro、deepseek-flash、deepseek-v4-flash などの DeepSeek モデルがリストで利用可能になります。リポジトリでの日常的な作業には、フラッシュ オプションで十分です。複雑なタスクの場合は、プロに切り替えるのが合理的です。

config による設定

マスターを介してキーを保存したくない場合、または独自の API アドレスを設定する必要がある場合は、プロバイダーは opencode.json 構成ファイルに直接記述されます。

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "deepseek": {
      "options": {
        "baseURL": "https://api.deepseek.com"
      }
    }
  }
}

baseURL フィールドは、プロキシまたは独自のゲートウェイを経由する場合に便利です。この場合、キー自体を環境変数に転送すると便利です。

export DEEPSEEK_API_KEY=ваш_ключ_deepseek
opencode

このオプションは CI および 1 回限りの起動に適しています。キーは最終的にストレージに保存されず、プロセスの環境内にのみ存在します。

プロジェクトでの最初の起動

プロジェクト ディレクトリに移動し、エージェントを起動します。

cd ваш_проект
opencode

最初のステップはそれを初期化することです。

/init

OpenCode はプロジェクト構造を分析し、エージェントへの指示に相当するファイル AGENTS.md を作成します。このファイルは git にコミットする価値があります。エージェントがプロジェクトで採用されている規則とパターンを理解するのに役立ちます。

使用方法

この作業は他のエージェントとほぼ同じように構成されています。今すぐ知っておくべきいくつかのトリック:

  • 計画モード。 Tab キーは、エージェントを計画モードと組み立てモードの間で切り替えます。最初の例では、問題の解決方法を提案するだけで、何も変更しません。変更を加える前にアイデアを確認すると便利です。
  • ファイルへのリンク。 @ キーを使用すると、プロジェクト ファイルのあいまい検索が開き、コンテキスト内のエージェントに特定のファイルが転送されます。
  • 変更のロールバック。 /undo コマンドは最後の編集を取り消して元のリクエストを返し、/redo コマンドはそれらを返します。複数のステップを連続してロールバックできます。
  • 会話の共有。 /share コマンドは、現在の会話へのリンクを作成し、クリップボードにコピーします。デフォルトでは、会話はどこにも公開されません。

単純な変更の場合は、計画モードに切り替える必要はなく、すぐに何を行う必要があるかを記述し、@ でファイルを指定します。

注意すべきこと

実践的なポイントをいくつか紹介します。 OpenCode はサブスクリプションを必要としません。トークンを使用するときにプロバイダーに直接料金を支払うため、DeepSeek での長時間セッションは上位モデルよりも予想通り安価です。キーはローカルの auth.json に保存されます。これは共有マシン上で検討する価値がありますが、他の人の環境では環境変数の方が信頼性が高くなります。

そしてもう 1 つ、複雑なアーキテクチャ上の問題に対する答えの質は、異なるクラスのモデル間で異なるため、設計では、より強力なモデルを採用し、ルーチンを迅速で安価なモデルに譲るのが理にかなっています。

リンク

https://opencode.ai/
https://opencode.ai/docs/
https://opencode.ai/docs/providers/
https://github.com/anomalyco/opencode
https://platform.deepseek.com/api_keys
https://api-docs.deepseek.com

ソース

https://opencode.ai/docs/
https://opencode.ai/docs/providers/#deepseek
https://github.com/anomalyco/opencode/releases
https://models.dev/

Comments

Leave a Reply

Your email address will not be published. Required fields are marked *