安装 Claude Code

官方安装脚本在国内网络环境下通常不可用，推荐使用 npm 方式安装。

1. 前置配置

1.1 设置 npm 全局路径

npm config set prefix ~/.npmGlobal

1.2 切换国内镜像源

npm config set registry https://registry.npmmirror.com

2. 安装步骤

全局安装 Claude Code：

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

安装完成后二进制文件位于 ~/.npmGlobal/bin/claude，需要将对应目录加入 shell 路径：

export PATH="$PATH:$HOME/.npmGlobal/bin"

可将上述 export 命令写入 ~/.zshrc 或 ~/.bash_profile 使其永久生效。

3. 配置 API 接入

配置文件位于 ~/.claude.json：

{ "env": { "ANTHROPIC_AUTH_TOKEN": "sk-你的百炼API密钥", "ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/api/v2/apps/claude-code-proxy" }, "hasCompletedOnboarding": true }

3.1 使用魔搭社区（ModelScope）免费额度

魔搭社区提供每天 2000 次免费调用：ModelScope Limits

3.1.1 配置步骤

1. 访问 modelscope.cn 注册并获取 Token
2. 配置环境变量：

# 魔搭社区的模型 export ANTHROPIC_BASE_URL="https://api-inference.modelscope.cn" export ANTHROPIC_AUTH_TOKEN="ms-xxx-xxx" # 模型 ID 需带服务商标识 export ANTHROPIC_MODEL="Qwen/Qwen3-Coder-480B-A35B-Instruct"

3.1.2 支持的千问模型

模型名称	说明
qwen3-coder-plus	编程专用模型（当前推荐）
qwen3-max	通义千问3最大版本
qwen3-coder-480B-A35B-Instruct	480B MoE 编程模型

4. 其他可选方案

4.1 claude-code-router

如果需要同时配置多个模型并灵活切换，可使用第三方路由工具：

# 安装路由工具 npm install -g claude-code-router # 配置多个提供商 ccr setup

4.2 CC Switch

GitHub 上的 cc-switch 工具可以方便地管理多个 API 配置。

5. 常见问题

问题	解决方案
配置后无法连接	检查 API Key 是否正确，确保没有多余空格
模型响应慢	百炼免费用户有速率限制，可升级套餐提升 TPM
需要指定模型	设置 ANTHROPIC_MODEL=qwen3-coder-plus

6. 验证安装

启动 Claude Code 后，输入以下命令查看当前使用的模型：

/model

如果配置成功，即可使用千问大模型进行编程辅助。