Claude Code 使用教程

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

请先按照上述内容按需配置代理，再执行：

powershell

$ claude update

npm 安装要求 Node.js 22 或更高版本。请先检查本机 Node.js 版本：

powershell

$ node --version

安装 Claude Code

powershell

$ npm install -g @anthropic-ai/claude-code

更新 Claude Code

powershell

$ npm install -g @anthropic-ai/claude-code@latest

✓ npm 安装完成后同样使用 claude 启动，后续步骤 2–4 与 Native 安装方式相同。

2

首次启动 Claude Code

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

powershell

$ claude

✓ 首次启动会进入引导流程。若出现登录提示，可先关闭窗口，完成步骤 3、4 后再重新启动。

⚠ 如果提示 claude 不是内部或外部命令，先完全关闭并重新打开终端再试。仍然无效时，按 Win 键搜索 环境变量，打开 编辑账户的环境变量 或 编辑系统环境变量，在 用户变量 中编辑 Path，新建一项 %USERPROFILE%\.local\bin。保存后关闭并重新打开终端，再执行 claude。

Path 变量值

%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，直接通过插件设置完成配置。

在 VS Code 中按 Ctrl+Shift+X 打开扩展面板，搜索并安装 Claude Code 插件
点击插件的设置图标，进入插件设置页
找到 Environment Variables 一项，点击 在 settings.json 中编辑
在打开的 settings.json 中，将下方配置粘贴进去并保存
找到 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。

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 为默认终端

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

PS

cc启用powershell工具

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

PowerShell 工具配置

{
  "env": {
    "CLAUDE_CODE_USE_POWERSHELL_TOOL": "1"
  }
}

使用优势：开启此配置后，Claude Code 可在 Windows 中直接调用 PowerShell 执行命令，不再依赖 Git Bash 转发，更适合运行 PowerShell 脚本及处理 Windows 系统管理任务。

适用场景：未安装 Git Bash 的 Windows 系统会自动启用该工具；已安装 Git Bash 的 Windows 系统可通过此配置主动启用。

⚠ 如果 settings.json 中已有 env 字段，请只将 CLAUDE_CODE_USE_POWERSHELL_TOOL 合并到现有对象中，不要覆盖已有配置。

MD

CLAUDE.md 位置说明

CLAUDE.md 用于为 Claude Code 提供持久化指令。它会在会话中作为上下文加载；不同位置决定指令的适用范围。

用户级：所有项目通用

C:\Users\你的用户名\.claude\CLAUDE.md

适合存放个人编码偏好、常用工作流和工具使用习惯，对当前计算机上的所有项目生效。

项目级：团队共享规则

项目根目录\CLAUDE.md
或
项目根目录\.claude\CLAUDE.md

适合存放项目架构、编码规范、构建与测试命令等团队约定，通常应随项目提交到版本控制。

项目级私有：个人项目偏好

项目根目录\CLAUDE.local.md

适合存放仅供自己使用的项目配置，例如本地测试地址和个人偏好。建议将 CLAUDE.local.md 加入 .gitignore，避免提交到版本控制。

目录级：局部范围规则

项目根目录\子目录\CLAUDE.md

适合为特定模块或子目录补充局部规则。当 Claude Code 读取该目录中的文件时，会按需加载对应的 CLAUDE.md。

加载顺序：Claude Code 会将发现的 CLAUDE.md 内容组合到上下文中。用户级指令先加载，项目与当前工作目录附近的指令随后加载；越接近当前工作目录的文件越靠后，因此更具体的规则应放在更接近目标代码的位置。

⚠ CLAUDE.md 中的内容是行为指令，不是强制配置。建议保持具体、简洁，避免不同层级出现相互冲突的规则；可通过 /context 查看当前会话实际加载的文件。

BP

启用 bypassPermissions mode

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

CLI 启用方式

{
  "permissions": {
    "defaultMode": "bypassPermissions"
  }
}

IDE 插件启用方式

打开 VS Code 的 Claude Code 插件设置页
找到 Claude Code: Allow Dangerously Skip Permissions 选项
勾选该选项后，重启 VS Code 或重新打开 Claude Code 插件面板

CLI 文件位置： C:\Users\你的用户名\.claude\settings.json

如果文件中已有其他字段，请只追加 permissions 字段，不要覆盖原有配置。

⚠ 在 Claude Code 界面中按 Shift+Tab 可以切换权限模式；若要切到 bypassPermissions，需先完成上方启用配置。

AC

设置自动压缩上下文

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

自动压缩上下文配置

{
  "env": {
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "272000",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "272000"
  }
}

推荐值：CLAUDE_CODE_MAX_CONTEXT_TOKENS 和 CLAUDE_CODE_AUTO_COMPACT_WINDOW 设置上下文最大限制与自动压缩触发阈值；数值不宜设置过大，否则会增加 Token 成本，并可能因上下文过长影响模型对关键信息的聚焦与任务表现。保存后重新启动 Claude Code 生效。

⚠ 如果 settings.json 中已有 env 字段，请将配置合并到 env 对象中，不要覆盖原有内容。

TUI

启用 TUI Fullscreen 显示模式

Fullscreen 是 Claude Code 的终端渲染模式：它像 vim 或 htop 一样使用终端的备用屏幕缓冲区绘制界面，并不是最大化 Windows Terminal 窗口。

查看当前模式

powershell

$ /tui

启用 Fullscreen

powershell

$ /tui fullscreen

回到经典模式

powershell

$ /tui default

Fullscreen 的优势

更少闪烁：只绘制当前可见消息，减少每次刷新发送到终端的数据量。
长会话更稳定：渲染树只保留可见内容，内存不会随对话长度持续增长。
阅读与输入更连续：工具输出持续出现时，输入框仍固定在屏幕底部；向上滚动时新输出不会强行拉回底部。
交互更直接：可用鼠标滚轮回看对话、点击展开工具结果、选择文本复制，并在 Windows 中按住 Ctrl 点击链接或文件路径。
会话内搜索：按 Ctrl+O 进入 transcript mode 后，输入 / 即可搜索当前对话；输入搜索词后按 Enter 确认，在搜索界面按 N 可导航至上一处匹配。

WF

修复 WebFetch 报错

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

WebFetch 配置

{
  "skipWebFetchPreflight": true
}

原理说明：WebFetch 获取 URL 前，会将请求的主机名发送到 api.anthropic.com，与 Anthropic 维护的安全拦截列表进行检查；不会发送完整 URL、路径或页面内容。检查结果会按主机名缓存 5 分钟。

当网络策略拦截 api.anthropic.com 时，这个预检查会导致 WebFetch 请求失败。配置 skipWebFetchPreflight: true 后，WebFetch 会跳过该检查并直接请求目标 URL。保存配置后重新启动 Claude Code 生效。

⚠ 如果 settings.json 中已有其他字段，请在根对象中合并 skipWebFetchPreflight，不要覆盖原有内容。

ML

自定义 Model 列表与 Subagent 模型绑定（进阶配置）

在终端使用 Claude Code 时，通过 /model 命令可以快速切换模型。在 settings.json 中配置 modelPicker，即可自定义候选模型选择菜单，自由接入任意第三方兼容模型（如 Gemini、GPT 系列等）。

1. 配置 modelPicker（自定义模型选择菜单）

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

modelPicker 配置

{
  "modelPicker": {
    "options": [
      {
        "model": "gemini-3.8-flash-high",
        "label": "gemini-3.8-flash",
        "description": "自定义描述信息"
      },
      {
        "model": "gpt-6-astra",
        "label": "gpt-6-astra",
        "description": "自定义描述信息"
      }
    ],
    "replaceBuiltInOptions": true
  }
}

配置参数说明

options：自定义模型列表数组。每个条目包含 model（实际请求的 API 模型 ID）、label（交互菜单中显示的名称）、description（右侧补充的描述信息）。
replaceBuiltInOptions：是否覆盖官方内置列表。设为 true 时将完全覆盖官方默认模型（Opus / Sonnet / Haiku），/model 菜单仅展示你自定义的模型；设为 false 时则将自定义模型追加在官方列表下方。

文件位置： C:\Users\你的用户名\.claude\settings.json

⚠ 关键注意事项与避坑：即使主会话选择了自定义模型，Claude Code 内置的 Subagent（如 Explore 代码探索、statusline-setup 状态栏配置、claude-code-guide 官方指南等）仍会默认尝试调用官方的 opus、sonnet 或 haiku。若使用的第三方中转 API 不支持官方原生模型，Subagent 触发时将直接报错。

2. 解决 Subagent 调用的三种方案

根据你的实际需求，选择以下任意一种方案进行适配：

方案一：指定所有 Subagent 统一走固定模型

{
  "env": {
    "CLAUDE_CODE_SUBAGENT_MODEL_FORCE": "1",
    "CLAUDE_CODE_SUBAGENT_MODEL": "gemini-3.8-flash-high"
  }
}

方案一说明：在 settings.json 的 env 中加入 "CLAUDE_CODE_SUBAGENT_MODEL_FORCE": "1" 并通过 "CLAUDE_CODE_SUBAGENT_MODEL" 指定具体模型。此时所有 Subagent（无论后台代码检索、工具调用还是快速探索）都将强制使用该指定模型，适合指定一个响应迅速、成本低廉的高性价比模型。

方案二（推荐）：让 Subagent 动态跟随所选主模型

{
  "env": {
    "CLAUDE_CODE_SUBAGENT_MODEL_FORCE": "1"
  }
}

方案二核心步骤：配置环境变量并覆盖默认 Explore Agent
1. 在 settings.json 的 env 中加入 "CLAUDE_CODE_SUBAGENT_MODEL_FORCE": "1"。
2. 重要原因：官方内置的 Explore 内部硬编码了强制使用 opus 的内部指令，不会被 CLAUDE_CODE_SUBAGENT_MODEL_FORCE 自动覆盖成主模型；因此必须在 .claude\agents 中新建自定义的 Explore 文件来覆盖默认配置（参考官方：Claude Code 编写 Subagent 官方文档）。
3. 在用户目录 C:\Users\你的用户名\.claude\agents\explore.md（若没有 agents 文件夹需手动创建）中新建文件，写入以下配置内容：

explore.md 配置

---
name: Explore
description: Quickly and read-only explore a codebase for files, symbols, implementations, call paths, configuration, and relevant tests.
model: inherit
tools: Read, Glob, Grep
---

You are a fast, read-only codebase exploration agent.

Use the requested exploration depth:
- quick: locate a specific file, symbol, configuration value, or implementation detail.
- medium: trace the relevant implementation and its immediate dependencies.
- very thorough: survey all relevant locations, conventions, and call paths before reaching a conclusion.

Do not modify files, run shell commands, or perform any external side effects.

Return a concise, actionable summary. Cite relevant paths and 1-based line numbers when available. Explain important relationships, assumptions, ambiguities, and any notable gaps in the codebase. Do not dump full files unless explicitly requested.

方案三：配置默认模型映射（内置 Subagent 走映射，其余走主模型）

{
  "env": {
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gpt-6-astra",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-5.6-terra",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gemini-3.8-flash-high"
  }
}

方案三说明：在 settings.json 的 env 中配置 ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL 与 ANTHROPIC_DEFAULT_HAIKU_MODEL 映射环境变量：
1. 内置 Subagent 精确走映射模型：Claude Code 内置的各 Subagent 会请求官方对应的模型档位。配置上述映射变量后：

Explore（代码探索，内部固定调用 Opus）将自动映射调用 ANTHROPIC_DEFAULT_OPUS_MODEL 所指定的模型（如 gpt-6-astra），无需额外创建 explore.md 文件覆盖；
statusline-setup（状态栏配置）和 claude-code-guide（官方指南）等将自动映射调用 ANTHROPIC_DEFAULT_SONNET_MODEL 或 ANTHROPIC_DEFAULT_HAIKU_MODEL 所指定的模型。

2. 其余 Subagent 自动走主模型：其他未硬编码特定官方等级的 Subagent（如通用代理或自定义未指定模型的 Subagent）会自动继承主会话当前所选的主模型。
3. 适用场景：适合既希望为代码探索、官方指南等内置 Subagent 精细化分配高性价比或专项模型，又希望其它交互继续动态跟随当前主模型的场景。