Getting Started zh CN

快速开始

English · 返回首页

环境要求

• VS Code ^1.84.0 或更高版本
• 一个受支持模型渠道的 API 地址与凭据

安装

推荐在 VS Code 插件市场 搜索 Gray Code 并安装。

也可以从 GitHub Releases 下载 graycode-*.vsix，在 VS Code 命令面板执行 Extensions: Install from VSIX... 后选择文件。

打开 GrayCode

点击 VS Code 活动栏中的 Gray Code 图标。也可以打开命令面板，执行 GrayCode: 打开聊天面板。

配置首个渠道

1. 打开聊天面板右上角的设置。
2. 进入 渠道，选择 新建渠道。
3. 选择 Gemini、OpenAI Compatible、OpenAI Responses 或 Anthropic。
4. 填写 API URL 与 API Key，添加或从服务端拉取模型列表。
5. 保存后回到聊天页，在输入框底部选择渠道和模型。

如果不确定渠道类型，请阅读模型与渠道。不要把 API Key 写进工作区文件、对话正文或 Issue。

选择 Prompt 模式

• Code：日常编码、修改文件、运行测试。
• Design：分析需求、约束、接口和方案，适合先设计后实现。
• Plan：把已确认方案拆成步骤和 TODO。
• Ask：解释、问答和只读分析，默认尽量不修改文件。
• Review：审查代码或 Git 改动，输出结构化发现。

模式可以在 设置 → 提示词 中复制、修改或新增。

发起第一个任务

从具体目标开始，并告诉 AI 你希望它先分析还是直接修改。例如：

阅读项目结构，解释入口、核心模块和测试布局，先不要修改文件。

定位这个异常。先搜索相关代码并给出证据，确认方案后再修复并运行测试。

你可以把文件、目录、选中代码、图片、PDF 或其他附件拖入输入框，明确本轮重点上下文。

审阅文件改动

文件修改通常会打开 VS Code Diff。你可以在编辑器标题区接受或拒绝，也可以使用：

• 接受当前块：Ctrl+Shift+Y（macOS：Cmd+Shift+Y）
• 拒绝当前块：Ctrl+Shift+N（macOS：Cmd+Shift+N）
• 下一块 / 上一块：Alt+] / Alt+[
• 命令面板：GrayCode: Accept All Changes / GrayCode: Reject All Changes

敏感工具是否需要确认，可在 设置 → 自动执行 中调整。

更新

GrayCode 可以自动检查 GitHub Releases。也可以在 设置 → 通用 → 自动更新 中手动检查或一键更新。若使用 VSIX，可从 Releases 下载新版本后再次执行 Extensions: Install from VSIX...。

下一步：浏览功能概览或工具与工作流。