Skip to content

Getting Started

Jump to bottom
NebulaRaven edited this page Aug 13, 2026 · 2 revisions

Getting Started

简体中文 · Home

Requirements

  • VS Code ^1.84.0 or newer
  • An API endpoint and credentials for a supported model provider

Install

Install Gray Code from the VS Code Marketplace.

Alternatively, download graycode-*.vsix from GitHub Releases, open the VS Code Command Palette, and run Extensions: Install from VSIX....

Open GrayCode

Select the Gray Code icon in the VS Code Activity Bar, or run GrayCode: Open Chat Panel from the Command Palette.

Configure your first channel

  1. Open Settings from the upper-right corner of the chat panel.
  2. Go to Channels and create a channel.
  3. Choose Gemini, OpenAI Compatible, OpenAI Responses, or Anthropic.
  4. Enter the API URL and API key, then add models manually or fetch the model list.
  5. Save, return to chat, and select the channel and model below the input box.

See Models and Channels if you are unsure which type to choose. Never place API keys in workspace files, chat content, or Issues.

Choose a prompt mode

  • Code for everyday coding, file changes, and tests.
  • Design for requirements, constraints, interfaces, and solution design.
  • Plan for turning an approved solution into steps and TODOs.
  • Ask for explanations and read-only analysis.
  • Review for structured reviews of code or Git changes.

Modes can be copied, edited, or added under Settings → Prompts.

Start a task

State a concrete goal and whether you want analysis before changes. For example:

Read the repository structure and explain the entry points, core modules, and tests. Do not modify files yet.

Investigate this bug. Search the relevant code and show the evidence before fixing it and running tests.

Drop files, folders, selected code, images, PDFs, or other attachments into the input box to define the task's focus.

Review file changes

File tools normally open a native VS Code diff. Accept or reject changes from the editor title area, or use:

  • Accept current block: Ctrl+Shift+Y (Cmd+Shift+Y on macOS)
  • Reject current block: Ctrl+Shift+N (Cmd+Shift+N on macOS)
  • Navigate to the next / previous block with Alt+] / Alt+[.
  • Command Palette: GrayCode: Accept All Changes / GrayCode: Reject All Changes

Control which sensitive tools require confirmation under Settings → Auto Execute.

Update

GrayCode can check GitHub Releases automatically. You can also check or update manually under Settings → General → Automatic Updates. For VSIX installations, download the new file from Releases and run Extensions: Install from VSIX... again.

Next: explore the Feature Overview or Tools and Workflows.

简体中文

English

Clone this wiki locally