# OpenCode 業務運用マニュアル

## 目次

**【基本操作】**
1. [システム概要](#1-システム概要)
2. [ログイン・ログアウト手順](#2-ログインログアウト手順)
3. [トップページ（TOP画面）](#3-トップページtop画面)

**【業務フローに沿った機能】**
4. [【STEP1】プロジェクト選択・セッション開始](#4-step1プロジェクト選択セッション開始)
5. [【STEP2-3】AIエージェントとの対話・開発作業](#5-step2-3aiエージェントとの対話開発作業)
6. [【STEP3-4】コードレビュー・ファイル操作](#6-step3-4コードレビューファイル操作)
7. [【STEP4-5】ワークスペース管理（管理者向け）](#7-step4-5ワークスペース管理管理者向け)

**【サポート機能】**
8. [ダウンロード・インストール](#8-ダウンロードインストール)
9. [Zenサービス](#9-zenサービス)
10. [設定・カスタマイズ](#10-設定カスタマイズ)

**【運用ガイド】**
11. [日常業務の流れ](#11-日常業務の流れ)
12. [よくある質問と対処法](#12-よくある質問と対処法)
13. [トラブルシューティング](#13-トラブルシューティング)

---

## 1. システム概要

### 1.1 OpenCodeとは

OpenCodeは、AI支援によるソフトウェア開発を実現するプラットフォームです。開発者は自然言語でAIエージェントに指示を与えることで、コードの生成、編集、レビュー、テスト実行などの開発作業を効率的に行うことができます。

主な特徴：
- **AIエージェントによる開発支援**：自然言語での指示に基づき、コード生成・編集を自動実行
- **マルチプラットフォーム対応**：デスクトップアプリ、CLI、TUI（ターミナルUI）、IDE拡張機能を提供
- **複数のAIプロバイダー対応**：Anthropic、OpenAI、Google、Azure等30以上のプロバイダーに対応
- **Language Server Protocol（LSP）統合**：コード診断、定義ジャンプ、参照検索等の高度な機能
- **セッション管理**：対話履歴の保存、セッションフォーク、セッション共有

### 1.2 本システムで行う主要業務

本システムは、主に以下の業務を支援します：

| 業務カテゴリ | 具体的な業務内容 |
|------------|----------------|
| **コード開発** | 新機能の実装、バグ修正、リファクタリング、テストコード作成 |
| **コードレビュー** | 変更差分の確認、インラインコメント、修正提案 |
| **プロジェクト管理** | プロジェクトの選択・切り替え、セッション管理 |
| **チーム協働** | セッション共有、ワークスペース管理、メンバー招待 |
| **リソース管理** | APIキー管理、使用量監視、請求管理 |

### 1.3 業務フロー概要

本システムにおける開発業務は、以下の流れで進行します：

```
+---------------------------------------------------------------------+
|                        開発業務フロー                                 |
+---------------------------------------------------------------------+
|                                                                     |
|  【STEP 1】開発者がプロジェクトを選択し、セッションを開始              |
|      |                                                              |
|  【STEP 2】AIエージェントに開発タスクを指示                           |
|      |                                                              |
|  【STEP 3】AIがコード生成・編集を実行、開発者が確認・修正              |
|      |                                                              |
|  【STEP 4】変更差分のレビュー、必要に応じて追加指示                    |
|      |                                                              |
|  【STEP 5】開発完了、セッション保存・共有（必要に応じて）               |
|                                                                     |
+---------------------------------------------------------------------+
```

**役割別の業務概要：**

| 役割 | 主な業務 |
|------|---------|
| **開発者** | プロジェクト選択、AIへの指示、コードレビュー、変更確認 |
| **管理者** | ワークスペース管理、メンバー管理、APIキー管理、請求管理 |

### 1.4 主な機能

| 機能 | 説明 | 業務フローでの位置 |
|------|------|------------------|
| プロジェクト選択 | 作業対象のプロジェクトディレクトリを選択 | STEP 1 |
| セッション管理 | AIとの対話セッションの作成・管理・共有 | STEP 1-5 |
| AIエージェント | Build/Planモードでの開発作業支援 | STEP 2-4 |
| コードレビュー | 変更差分の表示、インラインコメント | STEP 3-4 |
| ターミナル | コマンド実行結果の表示 | STEP 2-4 |
| ワークスペース管理 | チーム向けのリソース管理 | 随時 |
| Zenサービス | AIモデルアクセスの従量課金サービス | 随時 |

### 1.5 ユーザー種別

システムには以下のユーザー種別があります：

| ユーザー種別 | 説明 |
|-------------|------|
| 開発者（一般ユーザー） | OpenCodeを使用して開発作業を行う。プロジェクト選択、AIとの対話、コードレビューが主な操作 |
| ワークスペース管理者 | Zenサービスのワークスペースを管理。メンバー招待、APIキー管理、請求管理、設定変更が可能 |
| ワークスペースメンバー | 管理者に招待されたユーザー。ワークスペースのリソースを利用可能だが、管理操作は制限される |

### 1.6 対応ブラウザ・環境

**推奨ブラウザ（コンソール利用時）：**
- Google Chrome（最新版）
- Microsoft Edge（最新版）
- Safari（最新版）
- Firefox（最新版）

**対応プラットフォーム（デスクトップアプリ）：**
- macOS（Apple Silicon / Intel）
- Windows（x64）
- Linux（.deb / .rpm）

**対応IDE（拡張機能）：**
- VS Code
- Cursor
- Zed
- Windsurf
- VSCodium

---

## 2. ログイン・ログアウト手順

### 2.1 Zenサービスへのログイン

Zenサービス（Webコンソール）を利用する場合、認証が必要です。

**手順：**

1. ブラウザでOpenCodeのZenページ（https://opencode.ai/zen）にアクセスします
2. 「Sign Up」または「Get Started」ボタンをクリックします
3. 認証ページが表示されます
4. 以下のいずれかの方法でログインします：
   - GitHubアカウントでログイン
   - Googleアカウントでログイン
   - メールアドレスでログイン
5. 認証に成功すると、ワークスペースダッシュボードが表示されます

### 2.2 デスクトップアプリ・CLIの認証

デスクトップアプリやCLIでZenサービスを利用する場合、APIキーによる認証を行います。

**手順：**

1. Webコンソールにログインします
2. ワークスペースの「API Keys」ページに移動します
3. 「Create」ボタンをクリックしてAPIキーを作成します
4. 表示されたAPIキーをコピーします（作成直後のみフルキーが表示されます）
5. デスクトップアプリまたはCLIの設定でAPIキーを入力します

### 2.3 ログアウト方法

**Webコンソールからのログアウト：**

1. 画面右上のユーザーアイコンをクリックします
2. 表示されるメニューから「ログアウト」を選択します
3. ログイン画面に戻ります

---

## 3. トップページ（TOP画面）

### 3.1 デスクトップアプリのホーム画面

デスクトップアプリを起動すると、ホーム画面が表示されます。

**ホーム画面の構成要素：**

| 要素 | 説明 |
|------|------|
| OpenCodeロゴ | アプリケーションロゴ |
| サーバー接続状態ボタン | 接続中のサーバー名と接続状態を表示。クリックでサーバー切り替え |
| 最近開いたプロジェクト一覧 | 最大5件の最近開いたプロジェクトを表示（更新日時順） |
| プロジェクト追加ボタン | 新規プロジェクトを開くためのボタン |

**主な操作：**

- **プロジェクトを開く**：一覧からプロジェクトをクリック、または「プロジェクトを開く」ボタンでディレクトリを選択
- **サーバー切り替え**：サーバー接続状態ボタンをクリックして接続先を変更

### 3.2 Webコンソールのランディングページ

Webコンソール（https://opencode.ai/）のランディングページでは、製品情報とダウンロードリンクが提供されます。

**ランディングページの構成要素：**

| セクション | 説明 |
|-----------|------|
| ヒーローセクション | キャッチコピー、インストールコマンド |
| 機能紹介 | LSP統合、マルチセッション等の機能説明 |
| 成長統計 | GitHub Stars、コントリビューター数、月間ユーザー数 |
| FAQ | よくある質問と回答 |
| Zen CTA | Zenサービスへの誘導 |

### 3.3 ワークスペースダッシュボード

認証後、ワークスペースダッシュボードが表示されます。

**ダッシュボードの構成要素：**

| セクション | 説明 | 表示条件 |
|-----------|------|---------|
| 残高表示 | 現在の残高（$X.XX形式） | 管理者かつ課金有効時 |
| 課金有効化ボタン | Stripe Checkoutへ遷移 | 管理者かつ課金未設定時 |
| 使用量グラフ | Zen使用状況のグラフ | 管理者のみ |
| モデルセクション | 利用可能なAIモデル一覧 | 常時 |
| プロバイダーセクション | プロバイダー設定 | 管理者のみ |
| 使用量セクション | 使用量詳細 | 常時 |

---

## 4. 【STEP1】プロジェクト選択・セッション開始

> **業務フローでの位置**: 開発者がプロジェクトを選択し、AIとの対話セッションを開始するステップです。

### 4.1 プロジェクトを開く

**手順：**

1. デスクトップアプリを起動し、ホーム画面を表示します
2. 以下のいずれかの方法でプロジェクトを開きます：
   - **最近開いたプロジェクト**から選択：一覧に表示されているプロジェクトをクリック
   - **新規プロジェクト**を開く：「プロジェクトを開く」ボタンをクリックし、ディレクトリを選択
3. プロジェクトが開かれ、セッション画面に遷移します

**注意事項：**
- プロジェクトディレクトリはGitリポジトリであることを推奨します（変更追跡機能が利用可能になります）
- 複数のプロジェクトを同時選択することも可能です

### 4.2 セッションを作成する

**手順：**

1. プロジェクトを開いた状態で、サイドバーの「新規セッション」をクリックします
2. 新規セッション画面が表示されます
3. メッセージ入力欄に開発タスクの指示を入力します
4. 「送信」ボタンをクリックするか、Enterキーを押してセッションを開始します

### 4.3 既存セッションを選択する

**手順：**

1. サイドバーのセッション一覧から、再開したいセッションをクリックします
2. セッション画面に遷移し、過去の対話履歴が表示されます
3. メッセージ入力欄から対話を続けることができます

### 4.4 エージェントモードの選択

OpenCodeには2種類のエージェントモードがあります：

| モード | 説明 | 用途 |
|--------|------|------|
| **Build** | デフォルトのフルアクセスエージェント。ファイル編集、コマンド実行が可能 | 新機能実装、バグ修正、リファクタリング |
| **Plan** | 読み取り専用エージェント。ファイル編集を拒否し、コマンド実行前に確認 | コードベース探索、変更計画の立案 |

**モードの切り替え方法：**
- セッション画面のコンポーザー（入力欄）でモードを選択します

---

## 5. 【STEP2-3】AIエージェントとの対話・開発作業

> **業務フローでの位置**: 開発者がAIエージェントに開発タスクを指示し、AIがコード生成・編集を実行するステップです。

### 5.1 AIに指示を送信する

**手順：**

1. セッション画面のメッセージ入力欄に、開発タスクの指示を入力します
2. 必要に応じて、以下のコンテキスト情報を追加します：
   - **ファイル参照**：特定のファイルを参照先として指定
   - **コメント**：ファイルへのインラインコメント
3. 「送信」ボタンをクリックするか、Enterキーを押します
4. AIエージェントが処理を開始し、応答がストリーミング表示されます

**指示の例：**
- 「このファイルにエラーハンドリングを追加して」
- 「ユーザー認証機能を実装して」
- 「テストコードを作成して」
- 「このコードをリファクタリングして」

### 5.2 ツール実行の確認

AIエージェントがツール（ファイル編集、コマンド実行等）を実行する際、権限設定に応じて確認ダイアログが表示される場合があります。

**確認ダイアログの操作：**

| 操作 | 説明 |
|------|------|
| 許可 | ツール実行を許可し、処理を続行 |
| 拒否 | ツール実行を拒否し、処理を停止 |
| フィードバック付き拒否 | 拒否理由を入力し、AIに再検討を促す |

### 5.3 メッセージタイムラインの操作

**タイムラインの機能：**

| 機能 | 操作方法 |
|------|---------|
| メッセージナビゲーション | 上下キーまたはナビゲーションボタンでメッセージ間を移動 |
| スクロール復帰 | 最新メッセージへスクロールボタンで移動 |
| 自動スクロール | 新しいメッセージ追加時に自動的に最下部へスクロール（手動スクロール時は一時停止） |

### 5.4 セッションフォーク

特定の時点からセッションを分岐させたい場合、セッションフォークを使用します。

**手順：**

1. タイムライン上のフォークしたいメッセージを選択します
2. フォークダイアログを開きます
3. 新しいセッションが作成され、選択したメッセージまでの履歴がコピーされます

---

## 6. 【STEP3-4】コードレビュー・ファイル操作

> **業務フローでの位置**: AIが生成・編集したコードをレビューし、必要に応じて追加指示を行うステップです。

### 6.1 変更差分を確認する

**手順：**

1. セッション画面のレビューパネルを開きます
2. 変更されたファイルの一覧が表示されます
3. ファイルをクリックすると、差分（追加/削除/変更）が表示されます

**差分表示モード：**

| モード | 説明 |
|--------|------|
| Unified | 変更箇所を1列で表示（追加は緑、削除は赤） |
| Split | 変更前と変更後を2列で並べて表示 |

**差分の種類：**

| 種類 | 説明 |
|------|------|
| セッション全体 | セッション開始からの全変更 |
| 最後のターン | 直近のAI応答による変更のみ |

### 6.2 ファイルタブを操作する

**ファイルタブの機能：**

| 操作 | 方法 |
|------|------|
| タブを開く | ファイル一覧またはレビューパネルからファイルをクリック |
| アクティブタブの切り替え | タブバーで対象タブをクリック |
| タブを閉じる | タブの閉じるボタン（x）をクリック |

### 6.3 インラインコメントを追加する

レビュー中にコードの特定箇所にコメントを追加し、AIへのフィードバックとして使用できます。

**手順：**

1. ファイル表示でコメントを追加したい行を選択します
2. コメント追加機能を使用してコメントを入力します
3. コメントはコンテキストとしてAIに送信されます

### 6.4 ターミナルパネルを使用する

AIエージェントが実行したコマンドの結果は、ターミナルパネルに表示されます。

**ターミナルパネルの操作：**

| 操作 | 方法 |
|------|------|
| パネルを開く/閉じる | キーボードショートカットまたはボタンでトグル |
| 出力の確認 | PTY出力がリアルタイムで表示される |

### 6.5 変更をリバートする

AIによる変更を元に戻したい場合、リバート機能を使用します。

**手順：**

1. リバートしたいメッセージまたは変更を選択します
2. リバートボタンをクリックします
3. 確認ダイアログで「リバート」を選択します
4. ファイルが以前の状態に復元されます

---

## 7. 【STEP4-5】ワークスペース管理（管理者向け）

> **業務フローでの位置**: 管理者がワークスペースのリソース、メンバー、設定を管理するステップです。

### 7.1 ワークスペースダッシュボード

**アクセス方法：**
1. Webコンソールにログインします
2. ワークスペースを選択します
3. ダッシュボードが表示されます

**ダッシュボードで確認できる情報：**
- 現在の残高
- 使用量グラフ（管理者のみ）
- 利用可能なモデル
- プロバイダー設定（管理者のみ）

### 7.2 APIキー管理

**手順（APIキーの作成）：**

1. ワークスペースナビゲーションから「API Keys」を選択します
2. 「Create」ボタンをクリックします
3. キー名を入力します
4. 「Create」ボタンをクリックしてキーを作成します
5. 表示されたフルキーをコピーします（**重要**：作成直後のみ表示されます）

**手順（APIキーの削除）：**

1. APIキー一覧から削除したいキーを探します
2. 「Delete」ボタンをクリックします
3. キーが削除されます

**注意事項：**
- APIキーのフルキーは作成直後のみ表示されます
- 紛失した場合は新しいキーを作成してください
- 使用しなくなったキーは削除してください

### 7.3 メンバー管理

**手順（メンバーの招待）：**

1. ワークスペースナビゲーションから「Members」を選択します
2. 「Invite」ボタンをクリックします（管理者のみ表示）
3. 招待フォームに以下を入力します：
   - メールアドレス
   - ロール（Admin / Member）
   - 月間利用上限（オプション、空欄で無制限）
4. 「Invite」ボタンをクリックします

**手順（メンバーの編集）：**

1. メンバー一覧から編集したいメンバーの「Edit」ボタンをクリックします
2. ロールまたは月間上限を変更します
3. 「Save」ボタンをクリックします

**手順（メンバーの削除）：**

1. メンバー一覧から削除したいメンバーの「Delete」ボタンをクリックします
2. メンバーが削除されます

**注意事項：**
- 自分自身のロールは変更できません
- 自分自身を削除することはできません
- 月間利用上限は$単位で指定します

### 7.4 請求管理

**手順（課金の有効化）：**

1. ワークスペースダッシュボードで「Enable Billing」ボタンをクリックします
2. Stripe Checkoutページにリダイレクトされます
3. 支払い情報を入力して課金を有効化します

**手順（残高の確認）：**

1. ワークスペースダッシュボードで残高を確認します
2. 残高は$X.XX形式で表示されます

### 7.5 ワークスペース設定

**手順（ワークスペース名の変更）：**

1. ワークスペースナビゲーションから「Settings」を選択します（管理者のみ表示）
2. 現在のワークスペース名が表示されます
3. 「Edit」ボタンをクリックします
4. 新しい名前を入力します
5. 「Save」ボタンをクリックします

---

## 8. ダウンロード・インストール

### 8.1 ダウンロードページにアクセスする

**手順：**

1. ブラウザで https://opencode.ai/download にアクセスします
2. ダウンロードページが表示されます
3. OSが自動検出され、対応するダウンロードボタンが優先表示されます

### 8.2 デスクトップアプリをインストールする

**対応プラットフォーム：**

| プラットフォーム | ファイル形式 |
|-----------------|-------------|
| macOS Apple Silicon | .dmg |
| macOS Intel | .dmg |
| Windows x64 | .exe（NSIS） |
| Linux（Debian系） | .deb |
| Linux（RPM系） | .rpm |

**手順：**

1. 対象プラットフォームの「Download」ボタンをクリックします
2. ダウンロードが開始されます
3. ダウンロードしたファイルを実行し、指示に従ってインストールします

### 8.3 CLIをインストールする

**インストールコマンド：**

| 方法 | コマンド |
|------|---------|
| curl | `curl -fsSL https://opencode.ai/install.sh \| bash` |
| npm | `npm install -g opencode` |
| bun | `bun install -g opencode` |
| brew | `brew install opencode-ai/tap/opencode` |
| paru | `paru -S opencode-bin` |

**手順：**

1. ダウンロードページでインストール方法を選択します
2. 表示されたコマンドをコピーします（コマンドをクリックでコピー）
3. ターミナルでコマンドを実行します

### 8.4 IDE拡張機能をインストールする

**対応IDE：**

| IDE | インストール方法 |
|-----|----------------|
| VS Code | 拡張機能マーケットプレイスからインストール |
| Cursor | 拡張機能マーケットプレイスからインストール |
| Zed | 拡張機能ストアからインストール |
| Windsurf | 拡張機能ストアからインストール |
| VSCodium | 拡張機能マーケットプレイスからインストール |

---

## 9. Zenサービス

### 9.1 Zenサービスとは

Zenは、OpenCodeが提供する従量課金制のAIモデルアクセスサービスです。残高をチャージしてAIモデルを利用します。

**特徴：**
- 複数のAIモデルに対応
- 従量課金制（使用した分だけ課金）
- ワークスペース単位でのリソース管理
- チーム向けのメンバー管理機能

### 9.2 Zenを利用開始する

**手順：**

1. https://opencode.ai/zen にアクセスします
2. 「Sign Up」または「Get Started」ボタンをクリックします
3. 認証を行います
4. ワークスペースが作成されます
5. 「Enable Billing」で課金を有効化します

### 9.3 使用量を確認する

**手順：**

1. ワークスペースダッシュボードにアクセスします
2. 使用量グラフで利用状況を確認します（管理者のみ）
3. 使用量セクションで詳細を確認します

---

## 10. 設定・カスタマイズ

### 10.1 設定ファイル（opencode.json）

OpenCodeの設定は、プロジェクトルートの`opencode.json`または`opencode.jsonc`で管理します。

**主な設定項目：**

| 項目 | 説明 |
|------|------|
| model | 使用するAIモデルの指定 |
| provider | AIプロバイダーの設定 |
| permission | 権限ルールセットの設定 |
| agent | エージェントのカスタマイズ |

### 10.2 テーマの変更

**手順：**

1. サイドバーの設定アイコンをクリックします
2. テーマセクションでカラースキームを選択します
3. テーマが即座に適用されます

### 10.3 言語の変更

OpenCodeは17言語に対応しています。

**手順：**

1. サイドバーの設定アイコンをクリックします
2. 言語セクションで使用言語を選択します
3. UIテキストが選択した言語に切り替わります

---

## 11. 日常業務の流れ

本セクションでは、業務フローに沿った日常業務の流れを説明します。

```
業務フロー概要（再掲）
======================================================
【STEP 1】開発者がプロジェクトを選択し、セッションを開始 --> 4章参照
    |
【STEP 2】AIエージェントに開発タスクを指示 --> 5章参照
    |
【STEP 3】AIがコード生成・編集を実行、開発者が確認 --> 5章参照
    |
【STEP 4】変更差分のレビュー、必要に応じて追加指示 --> 6章参照
    |
【STEP 5】開発完了、セッション保存・共有 --> 7章参照
======================================================
```

### 11.1 【開発者】STEP1: プロジェクト選択とセッション開始

業務開始時に、作業対象のプロジェクトを選択し、セッションを開始します。

**操作手順：**

1. デスクトップアプリを起動します
2. ホーム画面で作業対象のプロジェクトを選択します
   - 最近開いたプロジェクト一覧から選択、または
   - 「プロジェクトを開く」で新規プロジェクトを選択
3. セッション画面に遷移します
4. 新規セッションを開始するか、既存セッションを選択します

### 11.2 【開発者】STEP2-3: AIとの対話と開発作業

AIエージェントに開発タスクを指示し、コード生成・編集を行います。

**操作手順：**

1. メッセージ入力欄に開発タスクの指示を入力します
   - 例：「ユーザー認証機能を追加して」
   - 例：「このバグを修正して」
2. 必要に応じてファイル参照やコメントを追加します
3. 送信してAIの応答を待ちます
4. AIがコード生成・編集を実行します
5. 権限確認ダイアログが表示された場合は、内容を確認して許可/拒否します

### 11.3 【開発者】STEP4: コードレビューと追加指示

AIが生成・編集したコードをレビューし、必要に応じて追加指示を行います。

**操作手順：**

1. レビューパネルを開いて変更差分を確認します
2. 問題がある場合は、追加の指示をAIに送信します
3. 必要に応じてインラインコメントを追加します
4. 変更をリバートする場合はリバート機能を使用します

### 11.4 【開発者】STEP5: 開発完了とセッション保存

開発作業が完了したら、セッションを保存し、必要に応じて共有します。

**操作手順：**

1. 変更内容を最終確認します
2. 必要に応じてセッションを共有します（共有機能を使用）
3. サイドバーからセッションを管理します（アーカイブ等）

### 11.5 【管理者】リソース管理業務

管理者は定期的にワークスペースのリソースを管理します。

**日常業務：**

| 業務 | 頻度 | 操作 |
|------|------|------|
| 残高確認 | 毎日 | ダッシュボードで残高を確認 |
| 使用量確認 | 週次 | 使用量グラフで利用状況を確認 |
| メンバー管理 | 随時 | 新規メンバーの招待、権限変更 |
| APIキー管理 | 随時 | 不要なキーの削除、新規キーの発行 |

---

## 12. よくある質問と対処法

### 12.1 プロジェクト・セッションに関するQ&A

**Q: プロジェクトを開けません**

A: 以下を確認してください：
- ディレクトリパスが正しいか確認してください
- ディレクトリへのアクセス権限があるか確認してください
- サーバー接続状態を確認してください（ホーム画面の接続状態ボタン）

**Q: セッション履歴が表示されません**

A: 以下を確認してください：
- 正しいプロジェクトを選択しているか確認してください
- サーバー接続が正常か確認してください
- アプリを再起動してみてください

### 12.2 AIエージェントに関するQ&A

**Q: AIの応答が遅いです**

A: 以下を確認してください：
- ネットワーク接続を確認してください
- 使用しているモデルを確認してください（モデルによって応答速度が異なります）
- タスクの複雑さによっては時間がかかる場合があります

**Q: AIがファイルを編集できません**

A: 以下を確認してください：
- Buildモードを使用しているか確認してください（Planモードは読み取り専用）
- 権限設定を確認してください
- ファイルへの書き込み権限があるか確認してください

**Q: 権限確認ダイアログが頻繁に表示されます**

A: 以下を確認してください：
- 設定ファイル（opencode.json）の権限ルールを確認してください
- 必要に応じてルールを調整してください

### 12.3 Zenサービスに関するQ&A

**Q: 残高が不足しています**

A: 以下を確認してください：
- ワークスペースダッシュボードで残高を確認してください
- 「Enable Billing」で追加チャージを行ってください

**Q: APIキーが動作しません**

A: 以下を確認してください：
- APIキーが正しくコピーされているか確認してください
- APIキーが削除されていないか確認してください
- ワークスペースの残高が十分か確認してください

---

## 13. トラブルシューティング

### 13.1 エラーメッセージと対処法

| エラーメッセージ | 原因 | 対処法 |
|----------------|------|--------|
| 「サーバー接続に失敗しました」 | サーバーへの接続ができない | ネットワーク接続を確認、サーバー設定を確認 |
| 「プロジェクトが見つかりません」 | 指定したディレクトリが存在しない | ディレクトリパスを確認 |
| 「権限がありません」 | 操作に必要な権限がない | 管理者に権限付与を依頼 |
| 「セッション履歴の読み込みに失敗しました」 | データベースエラー | アプリを再起動、サポートに連絡 |
| 「コンテキスト長を超過しました」 | 会話履歴が長すぎる | 新しいセッションを開始、またはコンパクション機能を使用 |

### 13.2 よくあるトラブルと解決方法

**トラブル: アプリが起動しない**

解決方法：
1. 最新版にアップデートしてください
2. アプリを再インストールしてください
3. ログファイルを確認してください

**トラブル: 変更が保存されない**

解決方法：
1. ファイルへの書き込み権限を確認してください
2. ディスク容量を確認してください
3. Gitリポジトリの状態を確認してください

**トラブル: AIの応答が途中で止まる**

解決方法：
1. ネットワーク接続を確認してください
2. セッションを再開してください
3. 別のモデルを試してください

### 13.3 サポートへの連絡方法

問題が解決しない場合は、以下の方法でサポートに連絡してください：

- **ドキュメント**：https://opencode.ai/docs
- **GitHub Issues**：https://github.com/opencode-ai/opencode/issues
- **エンタープライズサポート**：https://opencode.ai/enterprise

---

## 改訂履歴

| 版数 | 改訂日 | 改訂内容 |
|-----|--------|---------|
| 1.0 | 2026-02-24 | 初版作成 |

---

*本マニュアルは、OpenCodeのエンドユーザー向け業務運用マニュアルです。*
*システムの更新により、画面や操作方法が変更される場合があります。*
