Claude Code 安装与多层级配置

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
claude --version
# 看到版本号，就是安装成功，后续更新命令：
npm update -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

此时，直接执行 claude，会提示 Unable to connect to Anthropic services，另外，还如果进入初次引导流程，可以使用配置跳过。

跳过初次引导流程

编辑或新增 ~/.claude.json 文件（在PowerShell里，也能使用~代表$env:userprofile了），新增 hasCompletedOnboarding 参数

{
  "hasCompletedOnboarding": true
}

安装 VS Code 扩展

在扩展里，直接搜索 Claude Code for VS Code 安装就可以了。

安装 Git for Windows

Claude Code 需要 bash 环境支持，下载安装Git for Windows；如果在安装是，没有选择在Path中添加路径，需要使用CLAUDE_CODE_GIT_BASH_PATH变量设置，注意值是完整路径，比如：C:\Users\xxx\AppData\Local\Programs\Git\bin\bash.exe，在Json文件里是需要使用\\

多层级配置理解

没有~/.claude/settings.local.json配置位置，可以官方文档中查到
可用环境变量：官方文档，可以在所有位置配置
后加载的配置会覆盖前面的值，具体加载顺序：
- CLI：用户的环境变量 → 全局 → 项目 → 项目本地，
- VS Code 扩展：用户的环境变量 → VS Cod用户设置 → 全局 → 项目 → 项目本地
  - 从115版本开始？26/4/13 发现的
  - 2026/4/28 发现，Claude Code for VS Code 里能识别到用户的环境变量里的信息了
所以，可以为每个项目，在<project>/.claude/settings[.local].json里，使用不同的 Model 与 Key

位置	路径	Git 同步	适用场景
VS Code 的用户设置	`%AppData%\Code\User\settings.json`		VS Code 的 Claude Code 扩展
机器/用户的环境变量	`HKEY_CURRENT_USER\Environment`		机器特定配置，VS Code扩展不支持
claude 全局设置	`~/.claude/settings.json`	看实际需要	用户通用配置
claude 项目设置	`<project>/.claude/settings.json`	可同步	项目共享配置
claude 项目本地设置	`<project>/.claude/settings.local.json`	不同步	项目+机器/用户的特定配置

配置格式

HKCU\Environment按Windows方式配置就可以，或者到系统属性–>环境变量中配置是一样的。

VS Code 的json设置Key是："claudeCode.environmentVariables"，不参与VS Code去同步方法

    "claudeCode.environmentVariables": [
        {
            "name": "名",
            "value": "值"
        },
        {
            "name": "名",
            "value": "值"
        }
    ]

Claude 的json设置Key是："env"

    "env": {
        "名": "值",
        "名": "值"
    }

Claude Code 里的官方 Model 了解

Opus [旗舰推理] 需要深度推理和复杂代码生成。在推理能力和多步骤任务的处理上具有明显优势，特别适合需要深度学习和复杂推理的任务，如金融分析、法律文档生成等。它能够支持高并发和大规模数据处理，适用于企业级应用。
Sonnet [均衡主力] 日常编程辅助和文本处理，性价比最高。提供了一个理想的性能与成本平衡，适用于中等复杂度的文本生成任务。它在稳定性、响应速度和任务处理能力上表现优异，特别适合那些需要稳定输出的任务，如常规文案创作、博客写作等。
Haiku [轻量高速] 高并发、低成本的分类/提取任务。最轻量级的模型，适合需要高频率请求和快速响应的场景。它主要面向短文本生成任务和快速问答，成本最低，适合预算有限的小型团队或单一任务需求。

在使用兼容协议的大模型时，有二种配置方法：只能二选一使用

一、各自指定：claude code [Agent]会自动评估任务，使用对应的model

    "env": {
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "GLM-4.5-air",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "GLM-4.7",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "GLM-5.1"
    }

二、使用统一

    "env": {
        "ANTHROPIC_MODEL": "GLM-5.1"
    }

这组环境变量的生效优先级为：会话内指令（/model） > 启动参数（--model） > 多层级配置支持。

配置使用其他 Model

Claude 的json设置

~/.claude/settings.json
<project>/.claude/settings.json
<project>/.claude/settings.local.json

火山方舟

    "env": {
        "ANTHROPIC_AUTH_TOKEN": "You KEY",
        "ANTHROPIC_BASE_URL": "https://ark.cn-beijing.volces.com/api/coding",
        "ANTHROPIC_MODEL": "doubao-seed-2.0-code"
    }

GLM

    "env": {
        "ANTHROPIC_AUTH_TOKEN": "You KEY",
        "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
        "ANTHROPIC_MODEL": "GLM-5.1"
    }

VS Code 的json设置

%AppData%\Code\User\settings.json，其中，”settingsSync.ignoredSettings”表示不同步的内容。

    "settingsSync.ignoredSettings": [
        "claudeCode.environmentVariables"
    ],
    "claudeCode.preferredLocation": "sidebar",
    "claudeCode.environmentVariables": [
        {
            "name": "ANTHROPIC_BASE_URL", // 兼容 anthropic 协议的 API URL
            "value": "https://open.bigmodel.cn/api/anthropic"
        },
        {
            "name": "ANTHROPIC_AUTH_TOKEN", // API KEY
            "value": "You KEY"
        },
        {
            "name": "ANTHROPIC_MODEL", // 模型ID
            "value": "GLM-5.1"
        },
        {
            "name": "CLAUDE_CODE_GIT_BASH_PATH",   // git bash.exe 路径不在系统path里，要配置
            "value": "C:\\Users\\xxx\\AppData\\Local\\Programs\\Git\\bin\\bash.exe"
        }
    ],
	"chat.disableAIFeatures": true

用户的环境变量设置

PS D:\Downloads> reg add HKCR\Environment /v CLAUDE_CODE_GIT_BASH_PATH /t REG_SZ /d "$Env:USERPROFILE\AppData\Local\Programs\Git\bin\bash.exe" /f
PS D:\Downloads> reg query HKCU\Environment

HKEY_CURRENT_USER\Environment
    POWERSHELL_UPDATECHECK    REG_SZ    Off
    CLAUDE_CODE_GIT_BASH_PATH    REG_SZ    C:\Users\jm015089\AppData\Local\Programs\Git\bin\bash.exe
    ANTHROPIC_AUTH_TOKEN    REG_SZ    You-KEY
    ANTHROPIC_BASE_URL    REG_SZ    https://open.bigmodel.cn/api/anthropic
    ANTHROPIC_DEFAULT_HAIKU_MODEL    REG_SZ    GLM-4.5-Air
    ANTHROPIC_DEFAULT_SONNET_MODEL    REG_SZ    GLM-4.7
    ANTHROPIC_DEFAULT_OPUS_MODEL    REG_SZ    GLM-5.1
#    ANTHROPIC_MODEL    REG_SZ    GLM-5.1

其他推荐配置

使用时，要删除注释；建议放在 ~/.claude/settings.json，CLI与VS Code扩展都有效。

    "env": {
        "API_TIMEOUT_MS": "3000000",  // 8.33小时
        "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1  // 等同于设置 `DISABLE_AUTOUPDATER`、`DISABLE_FEEDBACK_COMMAND`、`DISABLE_ERROR_REPORTING` 和 `DISABLE_TELEMETRY`
    }

配置后，Claude code 中没有GLM显示

配置成功后是“服务端模型映射”，即你在界面上看到的是 Claude 模型名称，但实际调用的是 GLM 模型。Claude Code 内部的环境变量会自动将 Claude 模型指向对应的 GLM 模型。

在新的版本中，已经可以直接看到；或者你可以通过以下步骤验证配置是否生效：

启动 Claude Code CLI 后，在对话界面中输入命令 /status；注意：老版本有卡顿，需要3~5秒才会显示出来。
查看输出信息中关于当前 模型（Model） 的显示。如果配置成功，它会显示实际调用的模型名称，例如 glm-4.7 或你配置的其他模型。

/model的显示信息

多台设备之间 Rclone 或 Git 的双向同步

需要全局或项目的共享配置放在 ~/.claude/settings.json 或项目 .claude/settings.json 中同步
需要项目+机器的特定配置放在.claude/settings.json，在 rclone.filter 或 .gitignore 中排队
需要用户全局的特定配置（如 CLAUDE_CODE_GIT_BASH_PATH）放在 用户的环境变量 或 VS Code 的json设置+不同步Key 中。

~/.claude/rclone.filter

# .claude 要同步的内容
+ /skill/**
+ /rules/**
+ /memory/**
+ /settings.json
+ /CLAUDE.md

# 兜底
- /**