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

Ubuntu 24 安装 Claude Code

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

字节跳动发布于 2026/3/25更新于 2026/5/2324K 浏览
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. 总结
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

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

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

更多推荐文章

查看全部
  • 双足机器人 2-RSS-1U 并联踝关节设计与运动学分析
  • MySQL 表约束实战指南:从概念到落地
  • Spring Boot 毕业设计实战:智驿 AI 系统架构与功能解析
  • Qwen3 与 Qwen Agent 智能体开发实战:接入 MCP 工具
  • AIGC 版权争议:生成内容归属、侵权与保护路径
  • 基于Spring Boot+Vue的餐饮外卖订单管理系统设计与实现
  • Windows 安装 SDKMAN 及 JDK 多版本管理
  • CSS 盒子模型详解:边框、内边距与外边距实战
  • 网络安全入门教程:基础原理与实战指南
  • Reachy Mini 机器人硬件架构深度解析
  • Qwen2.5-32B-Instruct 本地部署指南:快速搭建 AI 写作助手
  • 深入理解 LLM 调用与 Prompt 编写:构建基础智能体
  • AudioLDM-S 为 AR 教学应用生成交互式触发声效
  • Flutter eth_sig_util 在鸿蒙端的适配与 Web3 签名实战
  • AI 辅助编程的边界探索:当 Copilot 学会写测试
  • DeepSeek 系列版本演进:从 V1 到 R1 的核心差异与选型指南
  • Uptime Kuma 结合 cpolar 实现远程运维监控
  • Java 集合框架进阶:Map 接口核心原理与实战
  • DeepSeek 满血版模型推理与 API 调用实战
  • 国产 AI 智能体工具盘点:Claw 系列收录与官网指引

相关免费在线工具

  • 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