AI エージェントのセットアップ

ステップ 1: Claude Code のインストール

Claude Code セットアップガイドに従って Claude Code をインストールします。このガイドでは、インストール、GitLab アカウントでの認証、承認済みの利用ポリシーについて説明しています。

インストールを確認します。

claude --version

インストールされたバージョン番号が表示されるはずです。

ステップ 2: analytics リポジトリから Claude Code を起動

jump analytics
claude

ステップ 3: GitLab MCP サーバーを追加

GitLab MCP セットアップガイドに従って GitLab MCP サーバーを追加します。

GitLab MCP サーバーにより、エージェントはセッション中に GitLab を直接操作できます。Issue の読み取り、マージリクエストの作成と更新、レビューコメントの読み取り、パイプラインとジョブのステータス確認が可能になります。Data Team のスキルのいくつかはこのサーバーに依存しています。

接続を確認するには、Claude Code 内で /mcp を実行します。GitLab サーバーが接続済みとして表示されるはずです。

ステップ 4: plan をデフォルトモードに設定

Claude Code セッション内で /config を実行して、設定を確認、変更します。ここで変更した内容はすべて Claude Code の設定ファイルに自動的に書き込まれるため、設定ファイルを手動で編集する必要はありません。

defaultMode を plan に設定します。これにより、デフォルトでより安全で慎重なモードに留まります。実行する準備ができたら、明示的に編集モードに切り替えます。これは、以下で説明する OpenCode のデフォルトエージェント設定に相当する Claude Code の設定です。

あわせて /config でモデルと出力スタイルも確認するとよいでしょう。

ステップ 5: エージェント利用ガイドの確認

Claude Code の使用を開始する前に、エージェント利用ガイドを確認して、以下を理解してください。

• エージェントと MCP の仕組み
• 設定のベストプラクティス（グローバル対プロジェクトレベル）
• Plan モードを使うタイミング
• プロンプト入力のベストプラクティスとコンテキスト管理
• 利用可能なスキルとエージェント

ステップ 1: OpenCode のインストール

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

ステップ 2: インストールの確認

OpenCode が PATH で利用可能であることを確認します。

which opencode

which opencode が何も返さない場合、次を実行して OpenCode を PATH に追加します。

echo 'export PATH=~/.opencode/bin:$PATH' >> ~/.zshrc && source ~/.zshrc

次に、インストールを確認します。

opencode --version

インストールされたバージョン番号が表示されるはずです。

ステップ 3: analytics リポジトリから OpenCode を起動

jump analytics
opencode

ステップ 4: GitLab Duo を AI プロバイダーとして設定

GitLab Duo は OAuth を使用します。作成や管理が必要なトークンはありません。

1. OpenCode 内で /connect を実行し、GitLab Duo を選択します
2. OpenCode が OAuth フローを完了するためにブラウザを開きます
3. @gitlab.com アカウントでサインインし、アプリを承認します
4. 自動的に OpenCode にリダイレクトされます

接続したら、hi と入力して OpenCode が応答することを確認してテストします。

ステップ 5: Golden Config の適用

OpenCode Golden Pathの設定を適用します。

注: opencode.json ではなく ~/.config/opencode/opencode.jsonc を使用してください。.jsonc 拡張子はコメントを許可するため、設定に注釈を付けるのに便利です。

ステップ 6: plan をデフォルトエージェントに設定

~/.config/opencode/config.json（これはステップ 5 の opencode.jsonc Golden Config とは別のファイルです）を開き、default_agent を追加します。

{
  "$schema": "https://opencode.ai/config.json",
  ...
  "default_agent": "plan"
}

これにより、デフォルトでより安全で慎重なモードに留まります。実行する準備ができたら、明示的に Build に切り替えます。

ステップ 7: エージェント利用ガイドの確認

OpenCode の使用を開始する前に、エージェント利用ガイドを確認して、以下を理解してください。

• エージェントと MCP の仕組み
• 設定のベストプラクティス（グローバル対プロジェクトレベル）
• Plan モードと Build モードの使い分け
• プロンプト入力のベストプラクティスとコンテキスト管理
• 利用可能なスキルとエージェント

ビデオリソース

GitLab Unfiltered アカウントの使用が必要です。

• OpenCode セットアップチュートリアル（3 分 30 秒）
• OpenCode デモ（5 分 30 秒）