# Grok VS Code 配置教程：Cline 插件、API Key 与模型

> 在 VS Code 使用 Cline 接入 Grok，配置 Passion8 /v1 地址、API Key 和模型，验证工具调用，并区分第三方插件与官方 Grok Build。

URL: https://docs.passion8.cc/docs/grok/vscode
Language: zh-CN
Publisher: Passion8
Last updated: 2026-10-11

在 VS Code 中使用本站 Grok，推荐安装 **Cline**，然后填写 Passion8 地址、API Key 和模型。Cline 是第三方编程客户端，Grok 是你选择的模型；不需要把 xAI 登录加入本站流程。

## 1. 安装 Cline

在扩展市场搜索 Cline，核对 ID `saoudrizwan.claude-dev`，或打开 [官方扩展页](https://marketplace.visualstudio.com/items?itemName=saoudrizwan.claude-dev) 安装。打开项目文件夹与 Cline 侧栏，进入设置。

## 2. 使用 OpenAI Compatible

API Provider 选择 **OpenAI Compatible**，保存以下设置：

| 项目 | 配置 |
| --- | --- |
| Base URL | `https://passion8.cc/v1` |
| API Key | 你的 Passion8 API Key |
| Model ID | `grok-4.7`，前提是控制台已为你的账号开放；否则填实际可用 ID |

开启 Plan / Act 独立模型设置时，要分别检查两个模式，不要让 Act 留在旧 Provider。首次配置先保留默认工具格式和人工审批。

## 3. 设置能力与预算

官方 Grok 4.7 支持工具调用、结构化输出，输入为文本和图片，上下文窗口是 **500,000 tokens**。这些是官方模型能力；本站渠道、Cline 的自定义模型元数据与请求格式也会影响实际可用范围。

若 Cline 提供上下文窗口等自定义选项，按实际渠道配置；最大输出不能直接填上下文窗口。先完成文本与文件工具测试，再测试图片。不要强行开启当前渠道未支持的原生工具格式，也不要把模型支持函数调用等同于支持 xAI 托管搜索。

## 4. 验证和开始编程

新建任务发送：“只回复 OK，不读取文件，不运行命令。”在 [控制台](https://passion8.cc) 核对同时间请求与模型，随后发送：

```text
只读检查当前项目。指出启动方式、测试命令和一个与登录相关的文件。
不要修改文件，不要安装依赖，不要执行迁移。
```

批准必要的文件读取，确认它确实使用项目上下文。第二个任务再要求一个范围明确的小改动，审阅 diff 后批准测试。完整操作见 [Grok 编程工作流](https://docs.passion8.cc/docs/grok/workflow)。

## Grok 有官方 VS Code 插件吗

当前核对的 xAI 官方入口是 **Grok Build**：支持终端 TUI、headless 与 ACP 集成。官方 Build 概览和文档目录未给出可直接按本站三项信息配置的独立官方 VS Code 扩展教程。市场中叫“Grok”的扩展需要另外核对发布者，不能仅凭名称认定来自 xAI。

因此本站把 **Cline + Grok** 作为编辑器推荐路径，把 [Grok Build 安装配置](https://docs.passion8.cc/docs/grok) 作为官方 CLI 路径。ACP 是客户端集成协议，也不代表普通 VS Code 默认已带 Grok 插件。

## 费用与常见问题

| 问题 | 操作 |
| --- | --- |
| 模型说自己是 Claude / GPT | 以控制台模型和用量为准；客户端提示词会影响自报身份 |
| 401 / 403 | 检查本站令牌状态、模型权限和余额 |
| 404 | 核对 Base URL 是 `/v1` 根路径，不是完整接口路径 |
| 普通回答正常，工具报错 | 核对模型支持、Cline 工具格式与当前渠道能力；保留错误正文 |
| 长任务费用增长 | 减少整仓文件注入，完成一个目标后开新任务，核对本站用量 |
| 搜索功能失败 | Cline 本地工具与 xAI 托管搜索不同；不要默认本站开放官方搜索工具 |

进阶 API 见 [Grok API 调用](https://docs.passion8.cc/docs/grok/api)，其他模型切换见 [Cline 多模型配置](https://docs.passion8.cc/docs/cline)。

## 核对来源

核对日期：2026-10-11。

- [Grok Build 官方概览](https://docs.x.ai/build/overview)
- [Grok 4.7 模型能力](https://docs.x.ai/developers/models/grok-4.7)
- [xAI 官方文档目录](https://docs.x.ai/llms.txt)
- [Cline OpenAI Compatible](https://docs.cline.bot/provider-config/openai-compatible)