Claude Code Settings Schema

I've been using $schema from Anthropic for a long time and one pet peeve I have had is that there is no autocomplete for environment variables Claude Code supports. Well, this improved schema fixes that.

Paste this at the beginning of your Claude Code ./.claude/settings.json file:

  "$schema": "https://assets.turboai.dev/claude-code-settings.improved.json",

Demo

What It Does

Provides “Intellisense-like” autocomplete for all environment variables in VS Code and compatible editors
Includes descriptions for every configuration option directly in your editor
Extends the official schema with comprehensive env var documentation

Pro tip: Commonly used but not well-known settings include BASH_DEFAULT_TIMEOUT_MS to prevent long-running commands from timing out, DISABLE_NON_ESSENTIAL_MODEL_CALLS to save on API costs, and includeCoAuthoredBy: false to disable Claude attribution in git commits.

How to Use

Add this line to the top of your Claude Code settings.json file:

  "$schema": "https://assets.turboai.dev/claude-code-settings.improved.json",

Your editor will now provide autocomplete suggestions and inline documentation for all Claude Code settings.

Minimal Example

{
  "$schema": "https://assets.turboai.dev/claude-code-settings.improved.json",
  "permissions": {
    "allow": [],
    "deny": [],
  },
}

Full Example with Hooks

This example includes terminal notifications and disables Claude co-author attribution:

{
  "$schema": "https://assets.turboai.dev/claude-code-settings.improved.json",
  "permissions": {
    "allow": [
      "WebSearch",
      "Bash(npm run:*)",
      "Bash(git add:*)",
      "Bash(git commit:*)"
    ]
  },
  "env": {
    "DISABLE_NON_ESSENTIAL_MODEL_CALLS": "1",
    "DISABLE_TELEMETRY": "1",
    "BASH_DEFAULT_TIMEOUT_MS": "300000"
  },
  "includeCoAuthoredBy": false,
  "hooks": {
    "Stop": [
      {
        "command": ["terminal-notifier", "-title", "Claude Code", "-message", "Task completed"]
      }
    ]
  }
}

Features

50+ Env Vars

Complete coverage of all documented environment variables

View docs →

Inline Docs

Every setting includes a description that appears directly in your editor as you type, making it easy to understand what each option does without leaving your workflow

Last Updated

Today