◈
学习 Claude

Windows 安装与配置 Claude Code 指南

2026-06-03 00:11 3 分钟 1096 字

Claude Code 是目前公认的顶尖 AI Agent 软件之一。本教程将指导你在 Windows 系统上完成安装与基础配置。

一、安装 Claude Code

1. 回到桌面，右键空白处，选择 “在终端中打开”。
2. 在弹出的终端窗口中输入以下命令并回车：

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

3. 等待安装完成即可。

二、基础配置（使用国内模型）

为了让 Claude Code 顺利运行，我们需要创建一份配置文件。

1. 显示隐藏文件


  • 进入路径：C:\Users\你的用户名

  • 点击顶部菜单的 “查看”。

  • 勾选 “隐藏的项目”（显示隐藏文件夹）。

  • 勾选 “文件扩展名”。

    • 2. 创建配置文件


  • 在上述目录下，右键 → 新建 → 文本文档。

  • 将文件名改为 .claude.json（确保去掉了 .txt 后缀）。

  • 双击该文件，选择用 记事本 打开。

    • 3. 编辑配置内容


    将以下内容复制到文件中：

    {
  "hasCompletedOnboarding": true,
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API Key",
    "ANTHROPIC_BASE_URL": "模型厂商的URL",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
    "ENABLE_TOOL_SEARCH": false
  }
}

    三、获取并填写 API 信息

    1. 获取 API Key


  • 登录任意一家支持 Claude 模型的国内大模型厂商（如deepseek、kimi等）。

  • 进入 “控制台” → “API 密钥管理”。

  • 点击 “新建 API Key”，随意命名并创建。

  • 复制生成的 Key，粘贴替换配置中的 "你的API Key"。

    • 2. 获取 Base URL


  • 在该厂商的文档中心，查找 “第三方应用接入” 或 “API 文档”。

  • 找到对应的 Base URL（通常形如 https://api.xxx.com/v1）。

  • 复制该地址，粘贴替换配置中的 "模型厂商的URL"。

    • 3. 保存配置


  • 按 Ctrl + S 保存文件。

  • 关闭记事本。

    • 四、启动与测试

    1. 再次回到桌面，右键 → 在终端中打开。
    2. 输入以下命令启动 Claude Code：

    claude

    3. 程序启动后，尝试发送一条消息（例如：“你好”）。
    4. 如果收到回复，恭喜你，配置成功！🎉