Claude Code 本地化接入魔搭社区指南
AI 编程工具如 GitHub Copilot 和 Cursor 已广泛应用。Anthropic 推出的 Claude Code 以'AI Agent'形态提供终端级代码交互能力。官方版本依赖海外 API,存在网络访问障碍和成本问题。本指南介绍如何通过配置环境变量,将 Claude Code 接入魔搭社区(ModelScope)API,实现国内稳定、低成本的 AI 编程辅助。
1. 方案优势
- 网络无障碍:无需特殊网络工具,利用国内魔搭社区服务,获得稳定高速的体验。
- 工作流无缝集成:直接在终端通过
claude命令启动,无需浏览器登录或切换工具。
2. 准备工作
确保系统已安装以下基础环境:
- Node.js 和 npm:Claude Code CLI 基于 Node.js。请从官网下载并安装 LTS 版本。
- 魔搭社区账号:用于获取免费 API 服务。请访问魔搭社区官网注册登录。
3. 获取 API Key
这是连接 Claude Code 与魔搭模型的凭证。
- 登录魔搭社区个人中心,点击右上角头像选择【个人中心】。
- 在左侧菜单找到【访问令牌】,点击【新建访问令牌】。
- 输入名称(如
claude-code-key),点击【新建令牌】。 - 注意:生成的 Key 仅显示一次,请立即复制保存。
4. 安装 Claude Code CLI
打开终端执行全局安装命令:
npm install -g @anthropic-ai/claude-code
安装完成后,可在任意目录使用 claude 命令。
5. 配置环境变量
设置环境变量指向魔搭社区 API 端点并使用获取的 Key。
macOS / Linux:
export ANTHROPIC_BASE_URL="https://api-inference.modelscope.cn"
export ANTHROPIC_AUTH_TOKEN="sk-替换为你的 API-Key"
export ANTHROPIC_MODEL="Qwen/Qwen3-Coder-480B-A35B-Instruct"
Windows (CMD):
set ANTHROPIC_BASE_URL=https://api-inference.modelscope.cn
set ANTHROPIC_AUTH_TOKEN=sk-替换为你的 API-Key
set ANTHROPIC_MODEL=Qwen/Qwen3-Coder-480B-A35B-Instruct
Windows (PowerShell):
$env:ANTHROPIC_BASE_URL="https://api-inference.modelscope.cn"
$env:ANTHROPIC_AUTH_TOKEN="sk-替换为你的 API-Key"
$env:ANTHROPIC_MODEL="Qwen/Qwen3-Coder-480B-A35B-Instruct"
说明:
- 请将
sk-替换为你的 API-Key替换为实际 Key。 - 环境变量在当前会话有效,关闭终端后失效。如需永久生效,请添加到 shell 配置文件(如 )或系统设置中。

