OpenCode 導入ガイド

OpenCode とは

OpenCode は、ターミナルで動く AI コーディングアシスタントです。プロジェクトのコードを理解し、質問に答えたり、コードの生成・修正・説明を対話的に行います。

注意: OpenCode は教員の代わりではありません。生成されたコードは必ず自分で理解し、テストで動作確認してください。AI の出力を鵜呑みにせず、「なぜ動くのか」を考えることが学習の本質です。

node --version

v18.0.0 以上が表示されれば OK です。入っていない場合は以下でインストールします。

# Ubuntu の場合
sudo apt update
sudo apt install nodejs npm

Ubuntu 22.04 の標準パッケージは古いバージョンの場合があります。その場合は NodeSource の手順で最新版を入れてください。

sudo npm install -g opencode-ai

opencode --version

バージョン番号が表示されればインストール成功です。

cd workbook/
opencode

起動すると対話モードになり、プロンプトが表示されます。

日本語で質問を入力し、Enter キーを押すだけです。

> この mycc.py の codegen 関数は何をしていますか？

OpenCode はプロジェクト内のファイルを読み取り、質問に回答します。

特定のファイルについて質問したい場合は、ファイル名を指定します。

> sessions/02_arithmetic_codegen/mycc.py のコードを説明してください

「〜を実装したい」と指示すると、コードを生成します。

> if 文の else 節をコード生成するメソッドを追加してください

生成されたコードは、そのままファイルに適用するかどうかを確認されます。

生成されたコードは必ずテスト（python3 scaffold/test_runner.py）で動作確認してください。AI の出力には誤りが含まれることがあります。

コンパイル結果のアセンブリが期待通りにならないとき、コードと実行結果を OpenCode に見せて相談できます。

> test_runner.py で while のテストが失敗します。
> 生成されたアセンブリを見て、どこが間違っているか指摘してください。

スキャフォールドのコードは教員が書いたものです。OpenCode に「このクラスは何をしているか」「この関数の引数は何か」を質問すると、素早く理解できます。

> scaffold/parser.py の parse_expr 関数は何を返しますか？

「配列のコード生成をどう設計すればいいか」といった設計レベルの相談もできます。

> 配列 a[3] の宣言をスタック上に確保するコードを生成したいです。
> どのようなアセンブリを出力すればいいですか？