opencode 簡介與安裝

摘要

本章將帶你認識 opencode——一個開源的 AI 編碼代理工具。你將了解它與傳統 AI 程式助手的差異、如何在你的開發環境中安裝與設定，以及建立第一個專案的基本流程。無論你是個人開發者還是團隊成員，本章都是你進入 opencode 世界的第一步。

學習目標

• 理解 opencode 的核心概念與定位
• 掌握 3 種以上的安裝方式
• 了解系統需求與環境準備
• 學會執行 /init 初始化專案
• 能區分 opencode 與 Claude Code 的差異
• 完成第一個 AI 協作任務

什麼是 opencode？

opencode 是一個由 Anthropic（前身為 Claude 團隊核心成員）主導開發的開源 AI 編碼代理。與一般的 AI 聊天工具不同，opencode 被設計為一個主動的開發夥伴——它能夠直接在你的終端機中讀取、編輯檔案，執行指令，並與你的 Git 工作流程整合。

核心特點

• 代理式協作：不像傳統 AI 只被動回答問題，opencode 可以主動規劃、執行程式碼修改，並即時顯示結果。
• TUI 介面：Terminal User Interface，在終端機中提供豐富的互動操作，無需離開命令列。
• 多模型支援：支援 75+ 模型提供商，包含 Anthropic Claude、OpenAI、Google Gemini 等，也可使用本機模型。
• 完全開源：原始碼在 GitHub 上公開，社群可自由審查、修改與貢獻。
• 可擴展架構：支援 MCP（Model Context Protocol）、外掛系統、自訂工具與代理。

運作方式

opencode 在終端中作為一個 TUI 應用程式執行。當你啟動它後，會進入一個對話式介面，你可以在其中提出需求、給出指示或問問題。opencode 會根據你的輸入，自主決定需要執行哪些步驟——包括閱讀檔案、執行程式碼、修改檔案、搜尋網路等——並向你報告結果。

與 Claude Code 的差異

opencode 常被拿來與 Anthropic 的另一個工具 Claude Code 比較。以下是兩者的主要差異：

簡單來說：opencode 更靈活、更開放、支援更廣泛的平台與模型，適合需要高度客製化的開發者；Claude Code 則整合在 Anthropic 生態系中，開箱即用。

系統需求

• 作業系統：macOS 12+、Linux（主要發行版）、Windows 10/11
• Node.js：版本 18.0.0 或以上（建議使用 LTS 版本）
• npm：9.0.0 或以上（隨 Node.js 安裝）
• Git：2.30+（建議安裝，非強制）
• 終端機：支援 TUI 的現代終端（iTerm2、Windows Terminal、kitty、Alacritty 等）
• API Key：至少一個模型提供商的 API 金鑰（如 Anthropic、OpenAI）

安裝方式

方式一：npm 全域安裝（推薦）

透過 npm 安裝是最簡單也最常用的方式：

npm install -g @opencode-ai/opencode

安裝完成後，執行以下指令確認版本：

opencode --version

方式二：npx 即時執行（不需安裝）

如果你只是想快速嘗試，不需要全域安裝：

npx @opencode-ai/opencode

npx 會自動下載並執行最新版本，不會在你的系統中留下永久套件。

方式三：從原始碼建置

進階使用者可以從 GitHub 克隆並自行建置：

git clone https://github.com/anthropics/opencode.git
cd opencode
npm install
npm run build
npm link

這會將 opencode 指令連結到你的 PATH 中。

方式四：透過 Homebrew（macOS / Linux）

brew install opencode

初始化流程

步驟 1：準備 API Key

視你選擇的模型提供商，取得 API 金鑰並設為環境變數：

# Anthropic Claude
export ANTHROPIC_API_KEY=sk-ant-xxxxx

# OpenAI
export OPENAI_API_KEY=sk-xxxxx

建議將 API Key 寫入 .bashrc、.zshrc 或使用 dotenv 管理。

步驟 2：啟動 opencode

在你的專案目錄中執行：

opencode

首次啟動時，opencode 會引導你完成基本設定，包括選擇模型與 API Key 配置。

步驟 3：執行 /init

在 opencode 的 TUI 中輸入斜線指令：

/init

這會在目前目錄生成一個 AGENTS.md 檔案，作為專案的規則基礎。opencode 會根據你的專案類型自動填入適當的寫作規則與風格指引。

步驟 4：開始協作

現在你可以直接提出需求：

請幫我建立一個 Express.js 的 REST API 專案結構

opencode 會規劃步驟、建立檔案，並即時呈現結果。

實戰練習