OpenCode

OpenCode 是一款开源的终端 AI 编程助手。它在终端中运行，能理解你的代码库，并可跨文件编写、修改和调试代码。

OpenCode 使用 OpenAI 兼容的 Chat Completions API，因此与 Token101 的集成非常简便。

前置条件

• Token101 API Key — 订阅用户可直接创建；Free 用户需先在 token.ppthub.shop/settings/apikeys 完成 API 激活
• Node.js 18 或更高版本
• 终端访问权限

步骤一 — 安装 OpenCode

npm install -g opencode-ai

国内用户可使用镜像源加速：

npm install -g opencode-ai --registry=https://registry.npmmirror.com

验证安装：

opencode --version

步骤二 — 配置 Token101 为模型服务商

OpenCode 通过项目目录或 Home 目录下的 opencode.json 文件进行配置。

方案 A — 项目级配置（推荐）

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

{
  "provider": {
    "openai": {
      "name": "Token101",
      "apiKey": "YOUR_TOKEN101_API_KEY",
      "baseURL": "https://token.ppthub.shop/api/v1"
    }
  },
  "model": "openai/gpt-5.2"
}

将 YOUR_TOKEN101_API_KEY 替换为你的实际 API Key。

方案 B — 环境变量

export OPENAI_API_KEY="your-token101-api-key"
export OPENAI_API_BASE="https://token.ppthub.shop/api/v1"

永久生效，请将上述内容添加到你的 Shell 配置文件（~/.bashrc、~/.zshrc 等）。

步骤三 — 验证连接

在终端运行一个简单测试：

opencode "请回复：TOKEN101_OK"

如果看到 TOKEN101_OK 输出，则说明 OpenCode 已成功连接到 Token101。

使用方法

启动交互会话

opencode

OpenCode 将在终端打开交互式对话。它会自动读取项目文件，并在对话中引用它们。

单次提问

opencode "解释这个函数的作用"

引用特定文件

opencode "检查 src/lib/billing.ts 中可能存在的 Bug"

生成代码

opencode "为 src/handlers/users.ts 中的 createUser 函数添加输入验证"

可用模型

在配置文件的 model 字段中填入任意 Token101 支持的模型名称：

完整列表请参阅 支持的模型。

工作原理

OpenCode 向 OpenAI Chat Completions 端点（/v1/chat/completions）发送请求。Token101 接收请求、验证 API Key、路由到相应的模型服务商，并返回响应。

OpenCode → POST /api/v1/chat/completions → Token101 → 模型服务商 → 响应

Token101 的 Chat Completions API 与 OpenAI 完全兼容，只需将 Base URL 指向 Token101 即可，无需其他特殊配置。

常见问题

报错 401 Unauthorized

API Key 无效或未设置。检查方法：

# 使用环境变量时
echo $OPENAI_API_KEY
# 应输出你的 API Key，而不是空

同时对照 设置 → API Keys 确认 Key 与 opencode.json 中的一致。

报错 404 Not Found

Base URL 不正确。请确认使用的是：

https://token.ppthub.shop/api/v1

而不是 https://token.ppthub.shop/api（缺少 /v1）。

模型未找到

确认配置文件中的模型名称与 支持的模型 页面一致（区分大小写）。

响应缓慢

对于较大的代码任务，响应可能需要 30–60 秒，这属于正常情况。如果持续超时，建议：

• 对简单任务改用更轻量的模型（如 claude-haiku-4-5-20251001）
• 将大任务拆分为多个较小的请求

下一步

• 支持的模型 — 查看所有可用模型
• 流式输出 — 了解流式响应的工作方式
• Claude Code 接入 — 使用 Anthropic Messages API 的另一款 CLI 工具
• API 参考 — 完整端点文档