Featured image of post Claude Code(1)在 WSL Ubuntu 上安装和配置指南
AI IDE 教程

Claude Code(1)在 WSL Ubuntu 上安装和配置指南

本文介绍如何在 Windows Subsystem for Linux (WSL) Ubuntu 环境中安装和配置 Claude Code，以及如何使用第三方大模型 API。

本文介绍如何在 Windows Subsystem for Linux (WSL) Ubuntu 环境中安装和配置 Claude Code，以及如何使用第三方大模型 API。

前置要求

在开始之前，请确保您已准备好：

  • WSL Ubuntu - 已安装并配置好 WSL Ubuntu 环境
  • 终端访问权限 - 打开 WSL 终端
  • 代码项目 - 准备一个要处理的项目目录
  • API 访问权限 - 拥有 Claude 订阅或第三方 LLM API 密钥

安装 Claude Code

这是最简单的安装方式，支持自动后台更新：

1

curl -fsSL https://claude.ai/install.sh | bash

安装完成后，claude 命令将被添加到系统 PATH 中。

有npm的话也可以这样安装

1

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

验证安装

安装完成后，验证安装是否成功：

1

claude --version

配置

使用 Claude 订阅登录

首次启动 Claude Code 时，需要登录账户：

1
2

claude
# 首次使用时会提示登录

支持的账户类型：

  • Claude Pro/Max/Teams/Enterprise（推荐）
  • Claude Console（使用 API 预付费额度）
  • 企业云提供商：Amazon Bedrock、Google Vertex AI、Microsoft Foundry

登录后，凭据将保存在系统中，无需重复登录。如需切换账户，使用 /login 命令。

跳过登录（使用第三方 API）

如果您只想使用第三方 LLM API 而不登录 Claude 账户，需要配置环境变量（见下文）。

使用第三方 LLM API

  1. 在~/.claude/settings.json (命令行下使用claude code) 中配置
  2. 在vscode安装claude code插件,点击插件配置会在vscode配置文件中配置

命令行 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

{
 "theme":"light",
 "env":{
    "ANTHROPIC_API_KEY":"sk--你的api key",
    "ANTHROPIC_BASE_URL":"https://api.qnaigc.com",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "z-ai/glm-4.5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "z-ai/glm-4.6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "z-ai/glm-5",
    "ANTHROPIC_MODEL": "z-ai/glm-4.5",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "API_TIMEOUT_MS": "3000000"
 },
 "hasCompletedOnboarding": true
}
  • ANTHROPIC_BASE_URL,第三方大模型api 地址,我这里使用七牛云的,点击注册免费获取1000万token
  • hasCompletedOnboarding 必须配置,不然一直提示需要claude code账户
  • ANTHROPIC_DEFAULT_HAIKU_MODEL,简单快速任务指定模型
  • ANTHROPIC_DEFAULT_SONNET_MODEL,日常编码任务模型
  • ANTHROPIC_DEFAULT_OPUS_MODEL,复杂推理任务模型
  • ANTHROPIC_MODEL,默认模型

vscode中claude code 插件配置

找不到配置文件位置,请点击claude code插件的Settings(设置)按钮

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

    "claudeCode.environmentVariables": [
        {"name":"ANTHROPIC_API_KEY","value": "sk-你的api key"},
        {"name":"ANTHROPIC_BASE_URL","value": "https://api.qnaigc.com"},
        {"name":"ANTHROPIC_DEFAULT_HAIKU_MODEL","value": "z-ai/glm-4.5"},
        {"name":"ANTHROPIC_DEFAULT_SONNET_MODEL","value": "z-ai/glm-4.7"},
        {"name":"ANTHROPIC_DEFAULT_OPUS_MODEL","value": "z-ai/glm-5"},
        {"name":"ANTHROPIC_MODEL","value": "z-ai/glm-4.6"},
    ],
    "claudeCode.disableLoginPrompt": true,
    "claudeCode.hideOnboarding": true

在插件中,使用 claudeCode.disableLoginPrompt,禁用插件的登录提示,开启后配置了第三方api就不会提示你登录claude code账户

常用命令

命令 说明 示例
claude 启动交互模式 claude
claude "任务" 执行一次性任务 claude "修复构建错误"
claude -p "查询" 执行单次查询后退出 claude -p "解释这个函数"
claude -c 继续当前目录最近对话 claude -c
claude -r 恢复之前的对话 claude -r
/clear 清除对话历史 /clear
/help 显示可用命令 /help
exit 或 Ctrl+C 退出 Claude Code exit

获取帮助