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

本文介绍如何在 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

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

命令行

{
 "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(设置)按钮

"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`

编程笔记