Windows 环境下的安装、终端设置与使用配置指南

1
安装 Claude Code

选择一种安装方式即可；安装完成后均可继续执行步骤 2–4。

Windows Native 安装方式会直接在本机安装 claude.exe。启动 PowerShell 执行下方命令。

powershell 
$ irm https://claude.ai/install.ps1 | iex
✓ 在地址栏输入 %USERPROFILE%\.local\bin 并回车（这通常是官方脚本默认的安装路径）。里面有 claude.exe 这个文件则代表安装成功。
⚠ 若提示网络错误可尝试打开代理软件 TUN 模式并选择清除系统代理。或者在 PowerShell 中临时设置网络环境变量，运行以下命令（请把 10809 替换成你实际的代理端口）。
powershell 
$ $env:HTTP_PROXY="http://127.0.0.1:10809"

更新 Claude Code

TUN 环境下会自动更新。若需立即手动更新，请先按需配置代理，再执行：

powershell 
$ claude update
2
首次启动 Claude Code

在任意目录打开终端，输入 claude 即可启动交互式命令行。

bash 
$ claude
✓ 首次启动会进入引导流程。若出现登录提示，可先关闭窗口，完成步骤 3、4 后再重新启动。
⚠ 如果提示 claude 不是内部或外部命令，先完全关闭并重新打开终端再试。仍然无效时，按 Win 键搜索 环境变量，打开 编辑账户的环境变量 或 编辑系统环境变量，在 用户变量 中编辑 Path，新建一项 %USERPROFILE%\.local\bin。保存后关闭并重新打开终端，再执行 claude。
bash 
$ %USERPROFILE%\.local\bin
3
配置 settings.json（选择模型提供商）

在 📁 C:\Users\你的用户名\.claude\settings.json 中添加下方 API 服务配置（无该文件时请手动创建）。 如果文件中已有 env 字段，请把环境变量合并进去，避免覆盖已有配置。

API 服务推荐配置 
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.example.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的 API Key",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "你的 Opus 模型 ID",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "你的 Sonnet 模型 ID",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "你的 Haiku 模型 ID"
  }
}
文件位置： C:\Users\你的用户名\.claude\settings.json
⚠ 若 API 服务默认自带 Opus、Sonnet、Haiku 映射，可以不添加 ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL。
4
修改 .claude.json（跳过引导）

在 📁 C:\Users\你的用户名\.claude.json 中添加以下字段，让 Claude Code 跳过首次引导。

.claude.json 配置 
{
  // ... 其他已有字段保持不变 ...
  "hasCompletedOnboarding": true
}
⚠ 注意是用户目录下的 .claude.json（有点号），不是 .claude 文件夹。如果文件不存在，创建它并写入 {"hasCompletedOnboarding": true}。
✓ 再次打开终端，输入 claude 即可。
⚠ 如果你只需要 VS Code 插件，不需要执行步骤 1-4，直接看下方 IDE 插件安装方式即可。
IDE
安装 VS Code IDE 插件

IDE 插件安装方式适合只在 VS Code 侧边栏里使用 Claude Code，仅使用插件时可以跳过步骤 1-4，直接通过插件设置完成配置。

  1. 在 VS Code 中按 Ctrl+Shift+X 打开扩展面板，搜索并安装 Claude Code 插件
  2. 点击插件的 设置 图标，进入插件设置页
  3. 找到 Environment Variables 一项，点击 在 settings.json 中编辑
  4. 在打开的 settings.json 中，将下方配置粘贴进去并保存
  5. 找到 Preferred Location 一项，修改为 sidebar，让 Claude Code 出现在左侧侧边栏
API 服务推荐配置 
"claudeCode.environmentVariables": [
  {
    "name": "ANTHROPIC_BASE_URL",
    "value": "https://api.example.com"
  },
  {
    "name": "ANTHROPIC_AUTH_TOKEN",
    "value": "sk-你的 API Key"
  },
  {
    "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC",
    "value": "1"
  },
  {
    "name": "CLAUDE_CODE_ATTRIBUTION_HEADER",
    "value": "0"
  },
  {
    "name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
    "value": "你的 Opus 模型 ID"
  },
  {
    "name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
    "value": "你的 Sonnet 模型 ID"
  },
  {
    "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
    "value": "你的 Haiku 模型 ID"
  }
]
说明： 将上方配置粘贴到 settings.json 的根对象中，注意 JSON 格式（若已有其他配置，在末尾添加逗号后追加此项）。保存后重启 VS Code 即可生效。仅使用 VS Code 插件时无需安装 Claude Code CLI；若还要在终端中使用 claude，仍需完成 CLI 安装方式。
⚠ 若 API 服务默认自带 Opus、Sonnet、Haiku 映射，可以不添加 ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL。
⚠ 此方式不使用 CLI，因此无需执行步骤 1-4。若后续也想使用命令行，再补充完成步骤 1-4 即可。
⚠ 如果你同时使用 CLI 和 VS Code 插件，只需要配置用户目录下的 settings.json 即可；若用户目录下的 settings.json 和插件的 Environment Variables 都有配置，插件会优先读取 settings.json。
BP
启用 bypassPermissions mode

如果你希望 Claude Code 跳过权限确认，可以按使用方式选择 CLI 或 IDE 插件中的一种配置。此模式会降低操作确认保护，仅在你明确理解风险时开启。

CLI 启用方式 
{
  "permissions": {
    "defaultMode": "bypassPermissions"
  }
}
IDE 插件启用方式
  1. 打开 VS Code 的 Claude Code 插件设置页
  2. 找到 Claude Code: Allow Dangerously Skip Permissions 选项
  3. 勾选该选项后，重启 VS Code 或重新打开 Claude Code 插件面板
CLI 文件位置： C:\Users\你的用户名\.claude\settings.json

如果文件中已有其他字段，请只追加 permissions 字段，不要覆盖原有配置。
⚠ 在 Claude Code 界面中按 Shift+Tab 可以切换权限模式；若要切到 bypassPermissions，需先完成上方启用配置。
AC
设置自动压缩上下文

在 📁 C:\Users\你的用户名\.claude\settings.json 的根对象中添加以下配置。

自动压缩上下文配置 
{
  "autoCompactEnabled": true,
  "autoCompactWindow": 220000
}
推荐值：autoCompactEnabled 用于启用自动压缩；建议将 autoCompactWindow 设置为模型上下文的约 80%， 220000 为示例值，请按实际模型上下文调整。保存后重新启动 Claude Code 生效。
⚠ 如果 settings.json 中已有其他字段，请在根对象中合并以上配置，不要覆盖原有内容。
PS
安装 PowerShell 7（推荐）

建议使用 PowerShell 7 运行 Claude Code。它持续更新、兼容更现代的命令与脚本，终端体验更完善；并且可与系统自带的 Windows PowerShell 并存。

使用 Windows 包安装器 Winget 安装 PowerShell 7

powershell 
$ winget install --id Microsoft.Powershell --source winget

查看更新

powershell 
$ winget list --id Microsoft.PowerShell --upgrade-available

更新 PowerShell 7

powershell 
$ winget upgrade --id Microsoft.PowerShell

设置 PowerShell 7 为默认终端

  1. 打开 Windows Terminal，在终端窗口顶部点击下箭头。
  2. 在展开菜单中点击设置。
  3. 打开启动，将默认配置文件选择为 PowerShell。