Claude Code 安装、使用及 GLM/DeepSeek 配置

概述

本报告基于 2026 年 3 月的最新信息,详细阐述 Claude Code(Anthropic 的终端 AI 编程助手)在 Windows 系统上的安装和使用步骤,以及如何配置国内模型 GLM(智谱 AI)和 DeepSeek(深度求索)以替换官方 Anthropic API。Claude Code 支持无缝接入兼容 API 的模型,提供高效的编程辅助。配置 GLM 和 DeepSeek 可以显著降低成本、提升国内网络稳定性,并保持高编程能力。

报告分为以下部分:

  • Claude Code 的安装步骤
  • Claude Code 的基本使用
  • 配置 GLM 模型的操作
  • 配置 DeepSeek 模型的操作
  • 常见问题与优化建议

前提条件(适用于所有部分):

  • Windows 10/11(最新版推荐)。
  • 已安装 Node.js 18+(LTS 版)。
  • 已安装 Git for Windows(必须,用于 Bash 支持)。
  • 网络能访问相关 API(GLM/DeepSeek 官网无需梯子)。

1. Claude Code 的安装步骤

Claude Code 支持原生 Windows 安装,无需 WSL。推荐使用官方一键脚本,确保以普通用户身份运行。

步骤详解

  1. 安装 Git for Windows(必备,否则安装失败):

    • 下载地址:https://git-scm.com/download/win。
    • 安装时勾选“Use Git from the Windows Command Prompt”和“Enable Git Credential Manager”。
    • 验证:打开 PowerShell,输入 git --version,看到版本号即可。
  2. 执行安装脚本

    • 打开 PowerShell 或 Windows Terminal(推荐)。
    • 运行命令:
      irm https://claude.ai/install.ps1 | iex
      
    • 或者用 CMD:
      curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
      
    • 安装过程会下载依赖(如 Node.js 包),若网络慢,可提前设置 npm 镜像:
      npm config set registry https://registry.npmmirror.com
      
  3. 验证安装

    • 重新打开终端,输入:
      claude --version
      
    • 显示版本号(如 2.x.x)即成功。
    • 如果命令找不到,检查 PATH 是否包含 C:\Users\你的用户名\.local\bin;或重启电脑。
  4. 可选:WSL 备用安装(如果原生失败):

    • 启用 WSL:wsl --install
    • 在 Ubuntu 子系统中运行:
      curl -fsSL https://claude.ai/install.sh | bash
      

2. Claude Code 的基本使用

安装后,Claude Code 可在终端中交互式编程,支持代码生成、调试、重构等。

步骤详解

  1. 登录(若用官方模型):

    claude login  # 浏览器扫码或输入 API Key
    
  2. 初始化项目(推荐首次使用):

    • 进入项目目录:
      cd D:\你的项目路径
      
    • 初始化:
      claude /init
      
    • 这会创建配置文件,并引导设置模型。
  3. 启动交互模式

    claude
    
    • 进入后,可输入自然语言指令,如:“帮我写一个 Python 的快速排序函数”。
    • 常用命令:
      • /model <模型名>:切换模型。
      • /help:查看帮助。
      • /exit:退出。
  4. 集成 IDE(可选,提升效率):

    • VS Code / Cursor:安装 “Claude Code” 或 “Continue.dev” 插件。
    • 配置插件中的 API Key 和 Base URL(与终端配置类似)。
  5. 高级用法

    • 支持文件上传/分析:直接在聊天中提到文件路径。
    • 上下文保持:会记住项目文件和先前对话。
    • 限额:免费版有限,建议订阅或用国内模型。

3. 配置 GLM 模型的操作

GLM(智谱 AI / bigmodel.cn)系列高度兼容 Anthropic API,推荐 GLM-4.7(主力)和 GLM-4.5-Air(快速版)。配置后,Claude Code 会自动映射模型。

步骤详解

  1. 注册并获取 API Key

    • 访问 https://open.bigmodel.cn。
    • 创建 API Key。
    • 购买 GLM Coding Plan(20 元/月起,推荐)。
  2. 配置方式(推荐环境变量,永久生效)

    • PowerShell:
      [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的 GLM API Key", "User")
      [Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://open.bigmodel.cn/api/anthropic", "User")
      [Environment]::SetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "1", "User")
      
    • 重启终端生效。
  3. 备选:修改 settings.json

    • 路径:C:\Users\你的用户名\.claude\settings.json(新建如果没有)。
    • 内容:
      {
        "env": {
          "ANTHROPIC_AUTH_TOKEN": "你的 GLM API Key",
          "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
          "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.7",
          "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
          "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
        }
      }
      
  4. 验证

    • 启动 Claude Code:claude
    • 输入:“你现在用的是哪个模型?”。
    • 应回复类似 “GLM-4.7” 或确认 GLM 底层。
    • 切换:/model glm-4.7
  5. 优化

    • 若界面显示 Claude 名但实际用 GLM:正常(映射机制)。
    • 检查智谱控制台:看 token 消耗。

4. 配置 DeepSeek 模型的操作

DeepSeek 系列性价比高,推荐 deepseek-reasoner(推理强)和 deepseek-chat(快速)。API 兼容 Anthropic,支持自动 fallback。

步骤详解

  1. 注册并获取 API Key

    • 访问 https://platform.deepseek.com/api_keys。
    • 创建 Key(免费额度有限,建议充值)。
  2. 配置方式(推荐环境变量)

    • PowerShell:
      [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的 DeepSeek API Key", "User")
      [Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.deepseek.com", "User")
      [Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_SONNET_MODEL", "deepseek-reasoner", "User")
      [Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_HAIKU_MODEL", "deepseek-chat", "User")
      [Environment]::SetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "1", "User")
      
    • 重启终端。
  3. 备选:修改 settings.json

    {
      "env": {
        "ANTHROPIC_AUTH_TOKEN": "你的 DeepSeek API Key",
        "ANTHROPIC_BASE_URL": "https://api.deepseek.com",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-reasoner",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-chat",
        "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
      }
    }
    
  4. 验证

    • 启动:claude
    • 输入:“你现在用的模型底层是什么?”。
    • 应提到 “DeepSeek-V3.2” 或类似。
    • 切换:/model deepseek-reasoner
  5. 优化

    • 无独立 coder 模型:代码能力已整合进 reasoner/chat。
    • Speciale 变体不推荐:兼容性差。

5. 常见问题与优化建议

问题类型 常见表现 解决方法
安装失败 命令找不到 / 卡住 检查 Git/Node.js;换 npm 源;重启终端。
配置无效 仍显示 Claude 名 正常(映射);问模型确认底层。
登录/Key 错误 Invalid API Key 重新生成 Key;检查订阅。
性能问题 慢 / 上下文漂移 用 chat 模式(快);加 DISABLE_NONESSENTIAL_TRAFFIC。
兼容性 模型 fallback 确保 Base URL 正确;优先官方映射。

建议

  • 初次配置后,测试简单任务(如生成代码)。
  • 轮换模型:GLM 稳,DeepSeek 便宜。
  • 更新:定期检查官网,Claude Code 可能有新版。
  • 工具:用 CC-Switch 图形化配置(适合新手)。
Logo

有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

更多推荐