学习笔记-ClaudeCode快速安装配置上手

本方为基于Windows下的安装实操过程记录，安装配置的方式有多种，本方仅记录自己走通安装配置的一条途径（接入百炼大模型），供后续翻阅参考。

一、安装claude-code

以管理员身份打开 Powershel1

bash 复制代码

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

因为使用的是-g全局安装，可以免去path环境变量的配置；

安装完成后，验证安装

bash 复制代码

claude --version

二、配置Claude-code

安装完启动 Claude Code ，界面会显示以下提示：

"Unable to connect to Anthropic services. Failed to connect to api.anthropic.com: ERR_BAD_REQUEST"

原因是Claude Code在尝试连接 Anthropic 官方服务而非阿里云百炼。接下来我们需要创建/修改配置来解决这个问题。

跳过登录验证

编辑或新建 ~/.claude.json（Windows 路径：C:\Users<用户名>.claude.json）

将 hasCompletedOnboarding 设为 true，跳过 Anthropic 官方登录验证。

bash 复制代码

{
  "hasCompletedOnboarding": true
}

配置接入凭证

新建 ~/.claude/settings.json（Windows 路径：C:\Users<用户名>.claude\settings.json），

写入对应套餐的配置：

bash 复制代码

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "DeepSeek-v4-Flash",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.7-max",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.7-max",
        "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-max"
    }
}

配置项说明：

配置项	值	含义
ANTHROPIC_AUTH_TOKEN	YOUR_API_KEY	认证密钥。注意：这里虽然名字带"ANTHROPIC"，但实际填的是百炼平台的 API Key （格式通常是 `sk-xxx`）。Claude Code 会把这个 Key 放到请求头里发给百炼。
ANTHROPIC_BASE_URL	https://dashscope.aliyuncs.com/apps/anthropic	API 端点。这是百炼提供的 Anthropic 兼容接口。Claude Code 以为自己在调 Anthropic，实际上请求发到了百炼。这个路径 `/apps/anthropic` 就是百炼模拟 Anthropic API 格式的入口。
ANTHROPIC_MODEL	DeepSeek-v4-Flash	默认模型。Claude Code 在没有指定具体角色时使用的模型。这里指定了百炼上的 DeepSeek-v4-Flash（目前性价比较最高的轻量快速模型）。
ANTHROPIC_DEFAULT_HAIKU_MODEL	qwen3.6-flash	轻量任务模型。当 Claude Code 内部判断某个任务适合用"Haiku"（轻量、快速、低成本）时，实际调用的是 `qwen3.6-flash`。
ANTHROPIC_DEFAULT_SONNET_MODEL	qwen3.7-max	平衡任务模型。当 Claude Code 判断需要"Sonnet"级别（中等能力、平衡速度质量）时，实际调用 `qwen3.7-max`。
ANTHROPIC_DEFAULT_OPUS_MODEL	qwen3.7-max	复杂任务模型。当 Claude Code 判断需要"Opus"级别（最强能力、复杂推理）时，同样映射到 qwen3.7-max。
CLAUDE_CODE_SUBAGENT_MODEL	qwen3.7-max	子代理模型。Claude Code 在执行某些任务时会创建"子代理"（subagent）并行处理，这个配置指定子代理用的模型。

最核心两项内容：

YOUR_API_KEY：

替换为阿里云百炼API Key。

ANTHROPIC_BASE_URL：

https://dashscope.aliyuncs.com/apps/anthropic

其它是针对不同场景下配置的不同模型，根据自己的需求配置即可。套餐后缀大致含义：

sonnet（平衡型）、opus（最强型，贵）、haiku（轻量型）

三、配置完成

配置完成后，如果已有Powershell窗口，需要关闭后重新开启让配置生效。可以在只需要在工作目录下启动Claude即可：

bash 复制代码

Claude

学习笔记-ClaudeCode快速安装配置上手