安装 OpenCode

##系统要求

在安装 OpenCode 之前，请确保你具备以下条件：

• 操作系统: macOS、Linux 或 Windows (WSL2)
• 终端: 现代终端模拟器
• API 密钥: 来自你首选 AI 提供商的 API 密钥（Anthropic、OpenAI 等）

##安装方法

###快速安装（推荐）

使用我们的安装脚本是安装 OpenCode 最快的方式：

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

此脚本会自动检测你的系统并安装相应的二进制文件。

###使用 Go 安装

如果你已安装 Go（版本 1.21+），可以直接安装：

go install github.com/opencode-ai/opencode@latest

###使用 Homebrew (macOS)

brew install opencode-ai/tap/opencode

###手动安装

1. 从 GitHub Releases 下载最新版本
2. 解压存档
3. 将二进制文件移动到 PATH 中的目录

# Linux/macOS 示例
tar -xzf opencode_linux_amd64.tar.gz
sudo mv opencode /usr/local/bin/

##验证安装

安装后，验证 OpenCode 是否正确安装：

opencode --version

你应该看到类似以下的输出：

OpenCode version 0.1.0

##配置

###设置 API 密钥

OpenCode 支持多个 AI 提供商。将你的 API 密钥设置为环境变量：

# Anthropic Claude
export ANTHROPIC_API_KEY="your-api-key-here"

# OpenAI
export OPENAI_API_KEY="your-api-key-here"

# Google Gemini
export GOOGLE_API_KEY="your-api-key-here"

Note

提示: 将这些导出命令添加到你的 shell 配置文件（~/.bashrc、~/.zshrc 等）以使其永久生效。

###配置文件

OpenCode 还支持位于 ~/.config/opencode/config.yaml 的配置文件：

# 默认使用的模型
model: claude-3-5-sonnet

# API 提供商设置
providers:
  anthropic:
    api_key: ${ANTHROPIC_API_KEY}
  openai:
    api_key: ${OPENAI_API_KEY}

# 编辑器设置
editor:
  theme: terminal
  tab_size: 2

##故障排除

###命令未找到

如果安装后出现"命令未找到"错误：

1. 检查二进制文件是否在你的 PATH 中
2. 尝试重启终端
3. 验证安装路径

###权限被拒绝

在 Linux/macOS 上，你可能需要使二进制文件可执行：

chmod +x /usr/local/bin/opencode

###API 密钥问题

如果遇到 API 认证错误：

1. 验证你的 API 密钥是否正确
2. 检查环境变量是否已设置：echo $ANTHROPIC_API_KEY
3. 确保你的 API 密钥具有必要的权限

##下一步

现在你已经安装了 OpenCode，请前往入门指南学习如何有效地使用它。