跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像AI 生图工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / BashNode.jsAI

Ubuntu 24 安装 Claude Code

介绍在 Ubuntu 24 系统上安装 Claude Code 的方法。若遇到'app-unavailable-in-region'错误,表明服务存在地区限制。推荐使用 npm 方式安装以绕过限制,也可使用 Homebrew 或检查网络环境。安装完成后运行 claude 命令验证,首次启动需登录账户。

字节跳动发布于 2026/3/25更新于 2026/7/2424K 浏览
Ubuntu 24 安装 Claude Code

在这里插入图片描述

报错 app-unavailable-in-region

这个错误说明 Claude Code 在你所在的地区不可用。返回的 HTML 页面是'App unavailable in region'(应用在该地区不可用)的提示页面,而不是安装脚本。

问题原因

Anthropic 目前对 Claude Code 的可用性有地区限制,你的 IP 地址所在地区可能不在支持范围内。

解决方案

方案 1:使用 npm 安装(绕过地区限制)

npm 弃用的核心原因是 Anthropic 希望提供一个不依赖 Node.js 生态、能自动更新、更稳定的独立工具,而非与 npm 有技术冲突。

如果 curl 安装脚本被地区屏蔽,可以直接使用 npm 安装:

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

要求:Node.js 18.0 或更高版本

方案 2:使用 Homebrew(macOS/Linux)
brew install --cask claude-code

注意:Homebrew 版本不会自动更新,需要手动运行 brew upgrade claude-code

方案 3:检查地区支持

Claude Code 并非在所有国家/地区都可用。官方文档明确指出,如果出现'App unavailable in region'错误,说明该服务在你所在国家不可用。

你可以:

  • 查看 Anthropic 官方支持的国家/地区列表
  • 使用支持地区的网络环境重新尝试 curl 安装
方案 4:Windows 用户替代方案

如果在 Windows 上遇到此问题,可以尝试:

  • PowerShell 安装:irm https://claude.ai/install.ps1 | iex
  • 使用 WSL:在 WSL 内部运行 Linux 安装命令

安装后验证

无论使用哪种方法,安装完成后运行:

claude

首次启动会提示浏览器登录,支持以下账户类型:

  • Claude Pro / Max / Teams / Enterprise
  • Anthropic Console(API 账户)
  • AWS Bedrock / Google Vertex AI(企业云提供商)

总结

安装方式命令适用场景
npm(推荐)npm install -g @anthropic-ai/claude-code地区受限时最可靠
Homebrewbrew install --cask claude-codemacOS/Linux 用户
原生安装`curl -fsSL https://claude.ai/install.shbash`

npm 方式通常能绕过地区检测,因为它是通过 Node.js 包管理器分发,而非 Anthropic 的官网脚本。

目录

  1. 报错 app-unavailable-in-region
  2. 问题原因
  3. 解决方案
  4. 方案 1:使用 npm 安装(绕过地区限制)
  5. 方案 2:使用 Homebrew(macOS/Linux)
  6. 方案 3:检查地区支持
  7. 方案 4:Windows 用户替代方案
  8. 安装后验证
  9. 总结
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • 声源定位算法 1:CBF 原理与时延补偿模型
  • GitHub Actions 集成 PyTorch-CUDA-v2.6 镜像实现 CI/CD 自动化
  • llama.cpp 高效部署与使用指南
  • 数组算法总结:二分查找、快慢指针、双指针与滑动窗口
  • Whisper 语音识别技术:本地部署与使用指南
  • Stable Diffusion v1.5 风格迁移实战:照片转油画/水彩/像素风
  • JeecgBoot 低代码平台 AI 功能与零代码开发指南
  • 利用 AI 自动生成符合 xxxxxl19d18–19 规范的 Python 项目结构
  • 自然语言处理在客户服务领域的实战应用
  • VS Code 中 GitHub Copilot 代理与 AI 编程实战指南
  • IntelliJ IDEA 打包 Web 项目 WAR 包及 Tomcat 部署指南
  • Claude Code 本地环境配置与使用指南
  • AWS Kiro 账号池管理系统:OpenAI 兼容代理服务,支持多账号与 OIDC 认证
  • 配置 Cursor 编辑器高效开发 C++ 项目
  • Java 核心面试题与答案详解
  • SpringBoot 整合 LangChain4j 实现 RAG 检索实战
  • Python 核心数据结构:集合与冻结集合
  • 钉钉 Webhook 完全指南:@用户通知与多语言实现
  • Coze 打造专属 AI 应用:从智能体开发到 Web 部署
  • KingbaseES 内核级 SQL 防火墙:白名单机制实现精准防护

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online