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

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

一、安装claude-code

以管理员身份打开 Powershel1

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

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

安装完成后，验证安装

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 官方登录验证。

{
  "hasCompletedOnboarding": true
}

配置接入凭证
新建 ~/.claude/settings.json（Windows 路径：C:\Users<用户名>.claude\settings.json），
写入对应套餐的配置：

{
    "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"
    }
}

配置项说明：

最核心两项内容：
YOUR_API_KEY：
替换为阿里云百炼API Key。

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

其它是针对不同场景下配置的不同模型，根据自己的需求配置即可。套餐后缀大致含义：
sonnet（平衡型）、opus（最强型，贵）、haiku（轻量型）

三、配置完成

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

Claude

相关资料

• cc-switch下载（图形化工具用于快速切换模型厂商）
• 百炼在线文档（各大工具集成都有详细说明）