1，使用windows10及以上系统

2，内存建议 16GB RAM及以上，存储预留5G可用空间

3，安装Node.js（需要 Node.js v18.0 或更高版本）下载地址：https://nodejs.org/zh-cn/download，windows系统的选择（.msi）下载。

4，安装Git，下载地址：https://git-scm.com/install/windows，下载Gitfor Windows/x64 Setup

5，安装claude code，打开Windows的cmd或PowerShell，输入指令安装

# 下载最新版本

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

# 验证安装

claude --version

# 应输出版本号，表示安装成功

6，跳过官方登录验证

编辑或创建 ~/.claude.json 文件（Windows 路径：C:\Users\<用户名>\.claude.json）

{
  "hasCompletedOnboarding": true
}

这一步确保 Claude Code 启动后不会强制跳转 Anthropic 官方登录页面

7， 配置 API 接入

创建 ~/.claude/settings.json（Windows 路径：C:\Users\<用户名>\.claude\settings.json），写入对应套餐的配置（Coding Plan 示例：）

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://coding-intl.dashscope.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.7-plus"
    }
}

或者开启自动化配置引导，指令为：

npx \@z_ai/coding-helper

8，通用环境变量配置方式

也可以在 shell 配置文件中直接设置环境变量（例如 ~/.bashrc 或 ~/.zshrc）：

export ANTHROPIC_BASE_URL="你的API地址"
export ANTHROPIC_API_KEY="你的API密钥"
export ANTHROPIC_MODEL="你选择的模型"

配置完成后，执行 source ~/.bashrc 或重新打开终端窗口使配置生效。

配置文件目录结构图

~/
├── .claude.json          # 登录状态配置（跳过验证）
└── .claude/
    └── settings.json     # API 接入配置

“Claude Code 的配置集中在用户目录下的 .claude.json 和 .claude/settings.json 中。前者控制登录状态，后者控制 API 接入参数。

9，功能验证

a,基础对话验证

claude "你好"

如果模型正常返回响应，说明配置成功。也可以在 Claude Code 交互界面中执行 /status 命令，检查 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 是否指向正确的 API 地址

b,首次启动成功截图

截取执行 claude "你好" 后收到模型回复的终端画面，以及 /status 命令显示配置信息的输出。“收到模型回复代表配置正确。用 /status 检查环境变量是否按预期生效，是排查配置问题的关键步骤。”