OpenCode 配置教程

OpenCode 是一款开源的 AI 编程助手，支持终端 TUI、多会话并行和 75+ 模型提供商。本教程将详细介绍如何安装和配置 OpenCode 接入闪电API。

系统要求

Node.js 18+（推荐使用最新版本）
Windows 用户：建议使用 WSL2 环境
网络：能够访问 npm 仓库

1. 安装 OpenCode

macOS

方案 A：官方安装脚本（推荐）

bash

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

方案 B：Homebrew

bash

brew install opencode

方案 C：npm

bash

npm install -g opencode-ai

Linux

方案 A：官方安装脚本（推荐）

bash

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

方案 B：包管理器

bash

# Arch Linux
paru -S opencode-bin

# 或使用 npm
npm install -g opencode-ai

Windows

强烈建议使用 WSL2，体验更佳。

方案 A：WSL2 中安装（推荐）

bash

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

方案 B：Chocolatey

bash

choco install opencode

方案 C：Scoop

bash

scoop install opencode

安装验证

bash

opencode --version

2. 配置文件位置

OpenCode 配置文件路径：

Linux/macOS: ~/.config/opencode/opencode.json
Windows: %USERPROFILE%\.config\opencode\opencode.json

也可以在项目根目录放置 opencode.json 作为项目级配置（优先级更高）。

3. 配置闪电API

方式 A：使用 CC-Switch（推荐）

CC-Switch 是官方推荐的配置工具，操作简单直观。

安装 CC-Switch

参考 CC-Switch 配置教程完成安装。

添加闪电API供应商

打开 CC-Switch，选择 OpenCode 配置项
点击"添加供应商"
填写配置信息：

配置项	说明
预设供应商	选择自定义
供应商标识	自定义名称，如 `flashapi-gpt`
接口格式	Claude选择 Anthropic GPT选择 OpenAI Gemini选择 Google (Gemini)
API Base URL	`https://ai.flashapi.top/v1`
API Key	你的闪电API密钥
额外选项	`{"setCacheKey":true}`

保存配置并重启终端

方式 B：手动配置

如果不使用 CC-Switch，可以手动编辑配置文件。

创建配置目录

bash

# Linux/macOS
mkdir -p ~/.config/opencode

# Windows (PowerShell)
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.config\opencode"

配置示例

创建 ~/.config/opencode/opencode.json：

json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "flashapi-gpt": {
      "npm": "@ai-sdk/openai",
      "name": "flashapi-gpt",
      "options": {
        "baseURL": "https://ai.flashapi.top/v1",
        "setCacheKey": true,
        "apiKey": "你的闪电API密钥"
      },
      "models": {
        "gpt-5.2": {
          "name": "GPT-5.2",
          "limit": {
            "context": 272000,
            "output": 128000
          },
          "cost": {
            "input": 1.75,
            "output": 14,
            "cache_read": 0.175,
            "cache_write": 1.75
          },
          "options": {
            "instructions": "You are a coding agent running in OpenCode, a terminal-based coding assistant. You are expected to be precise, safe, and helpful.",
            "include": ["reasoning.encrypted_content"],
            "parallel_tool_calls": true,
            "store": false
          },
          "variants": {
            "xhigh": {
              "reasoningEffort": "xhigh",
              "reasoningSummary": "auto"
            },
            "high": {
              "reasoningEffort": "high", 
              "reasoningSummary": "auto"
            },
            "medium": {
              "reasoningEffort": "medium",
              "reasoningSummary": "auto"
            },
            "low": {
              "reasoningEffort": "low",
              "reasoningSummary": "auto"
            }
          }
        },
        "gpt-5.2-codex": {
          "name": "GPT-5.2 Codex",
          "limit": {
            "context": 272000,
            "output": 128000
          },
          "cost": {
            "input": 1.75,
            "output": 14,
            "cache_read": 0.175,
            "cache_write": 1.75
          },
          "options": {
            "instructions": "You are a coding agent specialized for programming tasks. Focus on writing clean, efficient code with proper documentation.",
            "include": ["reasoning.encrypted_content"],
            "parallel_tool_calls": true,
            "store": false
          }
        }
      }
    },
    "flashapi-claude": {
      "npm": "@ai-sdk/anthropic",
      "name": "flashapi-claude",
      "options": {
        "baseURL": "https://ai.flashapi.top/v1",
        "apiKey": "你的闪电API密钥"
      },
      "models": {
        "claude-sonnet-4-6": {
          "name": "Claude Sonnet 4.6",
          "limit": {
            "context": 200000,
            "output": 64000
          },
          "cost": {
            "input": 3.0,
            "output": 15.0
          }
        },
        "claude-opus-4-6": {
          "name": "Claude Opus 4.6",
          "limit": {
            "context": 200000,
            "output": 32000
          },
          "cost": {
            "input": 15.0,
            "output": 75.0
          }
        }
      }
    },
    "flashapi-gemini": {
      "npm": "@ai-sdk/google",
      "name": "flashapi-gemini",
      "options": {
        "baseURL": "https://ai.flashapi.top/v1",
        "apiKey": "你的闪电API密钥"
      },
      "models": {
        "gemini-2.5-pro": {
          "name": "Gemini 2.5 Pro",
          "limit": {
            "context": 1000000,
            "output": 32000
          },
          "cost": {
            "input": 1.25,
            "output": 5.0
          }
        }
      }
    }
  }
}

配置说明

字段	说明
`baseURL`	闪电API地址：`https://ai.flashapi.top/v1`
`apiKey`	你的闪电API密钥
`npm`	对应的SDK包名
`limit.context`	模型上下文长度
`limit.output`	最大输出长度
`cost`	模型计费价格（实际通过闪电API计费）

4. 启动和验证

启动 OpenCode

bash

opencode

验证配置

在 OpenCode TUI 界面中输入：

/models

如果能看到配置的模型列表，说明配置成功。

切换模型

/model flashapi-claude/claude-sonnet-4-6

5. 基本使用

项目初始化

bash

cd /path/to/project
opencode

在 TUI 中执行：

/init

这会生成 AGENTS.md 文件，帮助 AI 理解项目结构。

常用命令

命令	说明
`/models`	查看可用模型
`/model <name>`	切换模型
`/connect`	连接提供商
`/init`	初始化项目
`/undo`	撤销上次修改
`/help`	查看帮助

引用文件

使用 @ 符号搜索和引用项目文件：

@README.md 帮我优化这个文档

6. 高级配置

模型变体

可以为模型定义不同的变体：

json

{
  "models": {
    "gpt-5.2": {
      "name": "GPT-5.2",
      "variants": {
        "fast": {
          "reasoningEffort": "low"
        },
        "deep": {
          "reasoningEffort": "high"
        }
      }
    }
  }
}

项目级配置

在项目根目录创建 opencode.json：

json

{
  "defaultModel": "flashapi-claude/claude-sonnet-4-6",
  "systemPrompt": "你是这个项目的专属编程助手..."
}

7. 常见问题

配置不生效？

确认配置文件路径正确
检查 JSON 格式是否有效
重启 OpenCode

模型调用失败？

确认 API 密钥正确
检查网络连接
验证 baseURL 设置

Windows 下体验不佳？

建议使用 WSL2
确保终端支持 Unicode
考虑使用 Windows Terminal

8. 平台差异建议

macOS

安装体验最佳
支持桌面版和 CLI 同时使用
终端拖拽文件体验良好

Windows

强烈推荐 WSL2
文件路径和权限更简单
脚本执行更稳定

Linux

最适合服务器和远程开发
性能表现最佳
长期使用首选

9. 下一步

查看 CC-Switch 教程 - 图形化配置工具
查看 API 文档 - 了解支持的模型
获取帮助 - 遇到问题联系我们
OpenCode 官方文档 - 更多高级功能

OpenCode 配置教程 ​

系统要求 ​

1. 安装 OpenCode ​

macOS ​

方案 A：官方安装脚本（推荐） ​

方案 B：Homebrew ​

方案 C：npm ​

Linux ​

方案 A：官方安装脚本（推荐） ​

方案 B：包管理器 ​

Windows ​

方案 A：WSL2 中安装（推荐） ​

方案 B：Chocolatey ​

方案 C：Scoop ​

安装验证 ​

2. 配置文件位置 ​

3. 配置闪电API ​

方式 A：使用 CC-Switch（推荐） ​

安装 CC-Switch ​

添加闪电API供应商 ​

方式 B：手动配置 ​

创建配置目录 ​

配置示例 ​

配置说明 ​

4. 启动和验证 ​

启动 OpenCode ​

验证配置 ​

切换模型 ​

5. 基本使用 ​

项目初始化 ​

常用命令 ​

引用文件 ​

6. 高级配置 ​

模型变体 ​

项目级配置 ​

7. 常见问题 ​

配置不生效？ ​

模型调用失败？ ​

Windows 下体验不佳？ ​

8. 平台差异建议 ​

macOS ​

Windows ​

Linux ​

9. 下一步 ​

OpenCode 配置教程

系统要求

1. 安装 OpenCode

macOS

方案 A：官方安装脚本（推荐）

方案 B：Homebrew

方案 C：npm

Linux

方案 A：官方安装脚本（推荐）

方案 B：包管理器

Windows

方案 A：WSL2 中安装（推荐）

方案 B：Chocolatey

方案 C：Scoop

安装验证

2. 配置文件位置

3. 配置闪电API

方式 A：使用 CC-Switch（推荐）

安装 CC-Switch

添加闪电API供应商

方式 B：手动配置

创建配置目录

配置示例

配置说明

4. 启动和验证

启动 OpenCode

验证配置

切换模型

5. 基本使用

项目初始化

常用命令

引用文件

6. 高级配置

模型变体

项目级配置

7. 常见问题

配置不生效？

模型调用失败？

Windows 下体验不佳？

8. 平台差异建议

macOS

Windows

Linux

9. 下一步