在国内使用Claude Code(DMXAPI)
本文介绍了如何配置ClaudeCode连接DMXAPI(中国多模态大模型API聚合平台)的开发流程。主要内容包括:1)安装Node.js和NPM环境;2)通过npm全局安装ClaudeCode;3)重点说明Windows平台的两种安装方案(推荐WSL方案);4)配置关键环境变量(API密钥、模型参数等);5)项目启动流程和VSCode集成方法。文章特别强调Windows用户需注意权限管理和环境兼容
在开发过程中,我们经常需要让不同的工具和 API 服务进行无缝对接。本文将详细介绍如何配置 Claude Code,使其能够连接到 DMXAPI,实现高效的开发协作流程。
什么是 DMXAPI?
DMXAPI 是一个提供中国多模态大模型API聚合平台的 API 服务,通过它可以纯正官转、模型多、并发足、不封号、无网络要求访问大模型API。要让 Claude Code 能够调用 DMXAPI,我们需要进行一些环境配置。
安装Node.js和NPM
Windows系统
从Node.js官网下载安装包(https://nodejs.org),选择LTS版本(长期支持版)。运行下载的安装程序,按照向导完成安装,默认会包含NPM。
安装完成后,打开命令提示符或PowerShell,输入以下命令验证安装是否成功:
node -v
npm -v
Linux系统(Ubuntu/Debian)
通过官方提供的二进制包安装:
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
安装Claude Code
Claude Code 通过 npm
进行全局安装。打开您的终端(在 Windows 上,请使用 WSL 或 Git Bash),然后运行以下命令:
npm install -g @anthropic-ai/claude-code
安装完成后,可通过执行 claude --version
命令来验证安装是否成功。请注意,切勿使用 sudo
权限安装 npm 包(如 sudo npm install -g...
),这可能导致文件权限混乱及安全漏洞。若遇到权限错误(如 EACCES),建议重新配置 npm 权限设置,而非直接使用管理员权限。
Windows 上安装 Claude Code 完整指南
尽管 Claude Code 的核心命令具有一定通用性,但在 Windows 系统中安装时,受限于其对 Unix-like 环境的依赖,需注意特殊差异与额外操作。本文将聚焦 Windows 平台,提供两种主流安装方案,尤其推荐功能最完整的 WSL 方案,帮你避开常见坑点。
一、Windows 安装前的核心认知
Claude Code 并非原生 Windows 应用,其设计深度依赖 Unix-like 环境的 Shell 工具(如 bash
、awk
)与命令行行为。因此 Windows 用户无法直接双击安装,必须通过 “兼容层” 运行 —— 目前主流选择是 WSL(Windows Subsystem for Linux,Windows Linux 子系统) 或 Git Bash。
其中,WSL 方案功能最完整、稳定性最高(提供完整 Linux 内核),适合需要全功能 Claude Code 的用户;Git Bash 则更轻量,适合仅需基础命令的简单场景。下文优先详解推荐的 WSL 方案。
二、方法 A:使用 WSL(推荐)—— 功能最全、最稳定
WSL 能在 Windows 中嵌入完整 Linux 环境,完美模拟 Claude Code 依赖的 Unix-like 生态,是官方隐含推荐的 Windows 安装方式。
步骤 1:安装 WSL 与默认 Ubuntu 发行版
- 以 管理员身份 打开 PowerShell(按下
Win
键,搜索 “PowerShell”,右键选择 “以管理员身份运行”); - 执行以下命令,系统会自动启用 WSL 功能、下载并安装 默认的 Ubuntu 发行版(无需手动下载 ISO 文件):
wsl --install
安装完成后,按提示重启电脑(这一步必须重启,否则 WSL 无法生效)。
-
步骤 2:关键!设置 Ubuntu 为默认 WSL 发行版 这是 Windows 安装 Claude Code 的 高频坑点:若你之前安装过 Docker Desktop、WSL 版 Kali Linux 等工具,它们可能会将自身的 WSL 实例设为默认,导致后续 Claude Code 安装路径错乱、命令执行失败。 务必执行以下操作确认默认发行版:
-
重启后,打开任意终端(PowerShell 或 CMD),执行命令查看已安装的 WSL 发行版:
wsl --list --verbose
首次启动
配置两个关键的环境变量:API 令牌和 API 地址
项目启动流程:
- 进入项目根目录
- 打开终端窗口
- 执行环境变量导出命令
- 运行启动命令激活 Claude Code
cd your-project-folder
export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxxxxxxxx"
export ANTHROPIC_MODEL="claude-sonnet-4-5-20250929"
export CLAUDE_MAX_TOKENS="4096"
export CLAUDE_TEMPERATURE="0.7" # 严谨--创意性程度 (0-1)
export ANTHROPIC_BASE_URL="https://www.dmxapi.cn"
export CLAUDE_TIMEOUT="3000" # 请求超时时间(秒)
export CLAUDE_MAX_RETRIES="3" # 最大重试次数
claude
Visual Studio Code 集成
-
安装步骤:推荐使用自动安装方式。在项目根目录下打开VS Code集成终端,执行claude命令即可。系统会自动识别VS Code环境并引导您完成官方扩展的安装。
更多推荐
所有评论(0)