【工具分享】OpenCode 完全指南

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

npm install -g opencode-ai
# 或
bun install -g opencode-ai
# 或
pnpm install -g opencode-ai
# 或
yarn global add opencode-ai

brew install anomalyco/tap/opencode

sudo pacman -S opencode           # 稳定版
paru -S opencode-bin              # AUR 最新版

# Chocolatey
choco install opencode

# Scoop
scoop install opencode

# NPM
npm install -g opencode-ai

# Docker
docker run -it --rm ghcr.io/anomalyco/opencode

# Mise
mise use --pin -g ubi:sst/opencode

# 从 GitHub Releases 下载二进制文件
# https://github.com/anomalyco/opencode/releases

/connect
# 选择 Anthropic，输入 API Key
# 注册地址：https://console.anthropic.com/

/connect
# 选择 OpenAI，输入 API Key
# 注册地址：https://platform.openai.com/

/connect
# 选择 DeepSeek，输入 API Key
# 注册地址：https://platform.deepseek.com/

/connect
# 选择 Google，输入 API Key
# 注册地址：https://aistudio.google.com/

/connect
# 选择 OpenRouter，输入 API Key
# 注册地址：https://openrouter.ai/

# 方式 1：AWS 访问密钥
AWS_ACCESS_KEY_ID=XXX AWS_SECRET_ACCESS_KEY=YYY opencode

# 方式 2：AWS 配置文件中的 named profile
AWS_PROFILE=my-profile opencode

# 方式 3：Bedrock bearer token
AWS_BEARER_TOKEN_BEDROCK=XXX opencode

/connect
# 选择 Azure，输入 API Key

# 设置资源名称环境变量
AZURE_RESOURCE_NAME=XXX opencode

# 或添加到 bash profile
export AZURE_RESOURCE_NAME=XXX

/connect
# 依次输入：Account ID、Gateway ID、API Token

# 或通过环境变量
export CLOUDFLARE_ACCOUNT_ID=your-account-id
export CLOUDFLARE_GATEWAY_ID=your-gateway-id
export CLOUDFLARE_API_TOKEN=your-api-token

/connect
# 选择 GitLab，可选 OAuth 或 Personal Access Token
# 需要 Premium 或 Ultimate 订阅

# 示例：在 bash profile 中添加
export ANTHROPIC_API_KEY=your-key
export OPENAI_API_KEY=your-key
export DEEPSEEK_API_KEY=your-key
export GOOGLE_GENERATIVE_AI_API_KEY=your-key
export OPENROUTER_API_KEY=your-key

<TAB>   # 切换到 Plan 模式

# 然后输入需求描述，例如：
"当用户删除笔记时，我们想在数据库中将其标记为已删除。
然后创建一个页面显示所有近期删除的笔记。
用户可以从这个页面恢复或永久删除笔记。"

# 例如提供设计参考图片：
"我希望新页面参考之前的设计风格。
[Image #1] 看看这张图片，以此为参考。"

<TAB>   # 切换回 Build 模式

"方案看起来不错，开始实施吧！"

"我们需要给 /settings 路由添加认证。
参考 @packages/functions/src/notes.ts 中的处理方式，
在 @packages/functions/src/settings.ts 中实现相同的逻辑。"

# 启动 OpenCode TUI
opencode

# 直接运行任务（无需进入 TUI）
opencode run "Hello world"

# 启动 HTTP 服务器（IDE 集成）
opencode serve

# 启动 Web 界面
opencode web

# 调试配置
opencode debug config

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-4-5",
  "small_model": "anthropic/claude-haiku-4-5",
  "autoupdate": true
}

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://your-proxy.example.com/v1",
        "timeout": 600000,
        "chunkTimeout": 30000
      }
    }
  }
}

{
  "$schema": "https://opencode.ai/config.json",
  "server": {
    "port": 4096,
    "hostname": "0.0.0.0",
    "mdns": true,
    "cors": ["http://localhost:5173"]
  }
}

{
  "$schema": "https://opencode.ai/config.json",
  "tools": {
    "write": false,
    "bash": false
  }
}

{
  "$schema": "https://opencode.ai/config.json",
  "share": "manual"
}

{
  "$schema": "https://opencode.ai/tui.json",
  "theme": "tokyonight",
  "scroll_speed": 3,
  "scroll_acceleration": { "enabled": true },
  "diff_style": "auto",
  "mouse": true
}

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

<!-- 文件：.opencode/commands/test.md -->
---
description: 运行测试并显示覆盖率
agent: build
model: anthropic/claude-3-5-sonnet-20241022
---
Run the full test suite with coverage report.
Focus on the failing tests and suggest fixes.

{
  "command": {
    "test": {
      "template": "Run the full test suite...",
      "description": "Run tests with coverage",
      "agent": "build",
      "model": "anthropic/claude-3-5-sonnet-20241022"
    }
  }
}

<!-- .opencode/commands/component.md -->
---
description: 创建新组件
---
Create a new React component named $ARGUMENTS
with TypeScript support.

<!-- 使用：/component Button -->

<!-- .opencode/commands/review-changes.md -->
---
description: 审查近期更改
---
Recent git commits:
!`git log --oneline -10`
Review these changes and suggest improvements.

<!-- .opencode/commands/review-component.md -->
---
description: 审查组件
---
Review the component in @src/components/Button.tsx.
Check for performance issues and suggest improvements.

mkdir -p .opencode/skills/git-release

---
name: git-release
description: Create consistent releases and changelogs
license: MIT
compatibility: opencode
metadata:
  audience: maintainers
  workflow: github
---

## What I do

- Draft release notes from merged PRs
- Propose a version bump
- Provide a copy-pasteable `gh release create` command

## When to use me

Use this when you are preparing a tagged release.
Ask clarifying questions if the target versioning scheme is unclear.

/git-release

<available_skills>
  <skill>
    <name>git-release</name>
    <description>Create consistent releases and changelogs</description>
  </skill>
</available_skills>

{
  "permission": {
    "skill": {
      "*": "allow",
      "pr-review": "allow",
      "internal-*": "deny",
      "experimental-*": "ask"
    }
  }
}

---
permission:
  skill:
    "documents-*": "allow"
---

{
  "agent": {
    "plan": {
      "permission": {
        "skill": {
          "internal-*": "allow"
        }
      }
    }
  }
}

---
tools:
  skill: false
---

{
  "agent": {
    "plan": {
      "tools": {
        "skill": false
      }
    }
  }
}

cd /path/to/project
opencode
/init

"认证是如何在 @packages/functions/src/api/index.ts 中处理的？"

/undo    # 撤销上一次修改
/undo    # 可以多次撤销
/redo    # 重做被撤销的修改

{
  "agent": {
    "code-reviewer": {
      "description": "Reviews code for best practices",
      "model": "anthropic/claude-sonnet-4-5",
      "prompt": "You are a code reviewer...",
      "tools": {
        "write": false,
        "edit": false
      }
    }
  }
}

{
  "mcp": {
    "my-server": {
      "type": "stdio",
      "command": "node",
      "args": ["path/to/server.js"]
    }
  }
}

{
  "model": "anthropic/claude-sonnet-4-5",
  "small_model": "anthropic/claude-haiku-4-5"
}

{
  "permission": {
    "*": "ask",
    "bash": {
      "*": "ask",
      "rm -rf *": "deny"
    }
  }
}

opencode : The term 'opencode' is not recognized as the name of a cmdlet, function,
script file, or operable program.

npm config get prefix

npm list -g opencode-ai

$env:Path += ";C:\Users\你的用户名\AppData\Roaming\npm"
opencode

# 获取当前用户的 PATH
$currentPath = [Environment]::GetEnvironmentVariable("Path", "User")

# 添加 npm 全局路径（替换为你的实际路径）
$newPath = $currentPath + ";C:\Users\你的用户名\AppData\Roaming\npm"

# 写入用户环境变量
[Environment]::SetEnvironmentVariable("Path", $newPath, "User")

npx opencode-ai