文章

Claude Code 安装配置

Claude Code 安装配置

vscode安装

nodejs安装

npm-pnpm 安装指南

git安装

claude code安装

1
2
3
# 使用npm安装claude

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

方案1 使用Claude订阅官方模型配置

image-20260413164203998

选择第一个。

image-20260413164237056

方案2 使用qwen模型配置

阿里云官方教程

这里以qwen 3.6 plus模型为例。

获取qwen模型api

阿里云官方教程:新人免费额度与计费FAQ-大模型服务平台百炼-阿里云-大模型服务平台百炼(Model Studio)-阿里云帮助中心

模型控制台:大模型服务平台百炼控制台

点击大模型服务平台百炼控制台

image-20260409153901150

选择api key,创建自己的key。

image-20260409154012719

image-20260409154016421

信息可填可不填,然后点击确定,一定要保存好api key,不要忘记了,最好放在记事本保存起来。

ubuntu24.04配置方法

  1. 打开配置文件(Ubuntu 默认使用 Bash):

    1
    
    nano ~/.bashrc
    

    注:如果你使用的是 Zsh,请修改 ~/.zshrc

  2. 在文件末尾添加以下内容

    1
    2
    3
    4
    
    # Jianhui Claude Configuration
    export ANTHROPIC_BASE_URL=https://dashscope.aliyuncs.com/apps/anthropic
    export ANTHROPIC_API_KEY="你的实际Key内容"
    export ANTHROPIC_MODEL=qwen3.6-plus
    
  3. 保存并退出

    Ctrl + O 保存,按 Enter 确认,再按 Ctrl + X 退出。

  4. 使配置立即生效

    1
    
    source ~/.bashrc
    
  5. 在终端中执行下列命令,查看环境变量是否生效:

    1
    2
    3
    
    echo $ANTHROPIC_BASE_URL
    echo $ANTHROPIC_API_KEY
    echo $ANTHROPIC_MODEL
    

windows配置方法

  1. 打开 命令提示符 (CMD),依次输入以下三条命令:

    1
    2
    3
    
    setx ANTHROPIC_BASE_URL "https://dashscope.aliyuncs.com/apps/anthropic"
    setx ANTHROPIC_API_KEY "你的实际Key内容"
    setx ANTHROPIC_MODEL "qwen3.6-plus"
    
  2. 生效机制

    • 使用 setx 设置后,必须关闭当前的终端窗口并重新打开一个新的窗口,环境变量才会生效。
    • 如果你在IDE(如PyCharm, VS Code)中运行代码,通常也需要重启IDE才能读取到新的系统环境变量。
  3. 打开一个新的 CMD 窗口,运行以下命令,检查环境变量是否生效:

    1
    2
    3
    
    echo %ANTHROPIC_API_KEY%
    echo %ANTHROPIC_BASE_URL%
    echo %ANTHROPIC_MODEL%
    

运行 claude code

进入项目目录,在终端执行claude命令。

1
claude

初次使用 claude code 时,可能会强制要求登录 Anthropic 账户。请按以下步骤操作以跳过该流程:

img

  1. 定位用户主目录下的 .claude.json 文件,具体路径如下:

    • macOS / Linux: ~/.claude.json
    • Windows: C:\Users\%USERNAME%\.claude.json
  2. hasCompletedOnboarding 字段的值设置为 true,如果没有这个字段添加即可

    1
    2
    3
    
    {
      "hasCompletedOnboarding": true
    }
    
  3. 保存文件,然后在新终端中重新运行 claude

  4. 如果vscode的claude插件还是要求登录,将这个插件卸载重新安装,重新打开vscode即可。

    1
    2
    3
    4
    5
    6
    7
    
    /home/jianhuichang/.vscode-server/extensions
       
    jianhuichang@ubuntubt:~/.vscode-server/extensions$ ll
    total 112
    drwx------ 24 jianhuichang jianhuichang  4096  4月 10 10:14 ./
    drwxrwxr-x  6 jianhuichang docker        4096  4月 10 10:14 ../
    drwxrwxr-x  4 jianhuichang jianhuichang  4096  4月 10 08:47 anthropic.claude-code-2.1.98-linux-x64/
    

    删除anthropic.claude-code-2.1.98-linux-x64/这个文件夹。

更多配置模型的方式(可选)

Claude Code 支持以下模型配置方式,按优先级从高到低排列,优先级高的配置会覆盖优先级低的配置。

  1. 对话期间:执行/model <模型名称>命令切换模型。适用于临时切换模型。

    1
    
    /model qwen3.6-plus
    
  2. 启动 claude code 时:执行claude --model <模型名称>指定模型。适用于单次会话。

    1
    
    claude --model qwen3.6-plus
    
  3. 设置环境变量:可按任务复杂度配置不同级别的模型,Claude Code 会根据任务类型自动选择合适的模型。适用于全局生效。

    1
    2
    3
    
    export ANTHROPIC_DEFAULT_OPUS_MODEL="qwen3.6-plus"
    export ANTHROPIC_DEFAULT_SONNET_MODEL="qwen3.6-plus"
    export ANTHROPIC_DEFAULT_HAIKU_MODEL="qwen3-coder-next"
    

    其中:

    • ANTHROPIC_DEFAULT_OPUS_MODEL:用于复杂推理、架构设计等高难度任务。
    • ANTHROPIC_DEFAULT_SONNET_MODEL:用于代码编写、功能实现等日常任务。
    • ANTHROPIC_DEFAULT_HAIKU_MODEL:用于语法检查、文件搜索等简单任务。
  4. 在 setting.json 配置文件中永久设置:在项目根目录或用户主目录创建settings.json文件,并写入模型配置信息,可分别进行项目级或用户级的永久配置。

    1
    2
    3
    4
    5
    6
    7
    
    {
      "env": {
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.6-plus",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.6-plus",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3-coder-next"
      }
    }
    

错误码

image-20260409163022432

常见问题

image-20260409163051394

问题3:vscode中的claude插件需要登录

打开vscode中的claude插件设置选项:

image-20260413164909441

image-20260413165457087

在这里添加ANTHROPIC_BASE_URL, ANTHROPIC_API_KEY, ANTHROPIC_MODEL三个配置的内容。

本文由作者按照 CC BY 4.0 进行授权