跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书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/10/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. 总结

更多推荐文章

查看全部
  • Python 兼职变现指南:爬虫开发与数据服务实战
  • 开源知识库 RAGFlow 部署与实战操作详解
  • Windows 11 下 WSL2 安装 Ubuntu 22.04 完整指南
  • Java SpringBoot 集成 OCR 构建企业级中间件服务
  • Python+PyGame 实现数独游戏:多难度、实时验证与成绩记录
  • Ubuntu 22.04 无法连接外网的故障排查与 DNS 配置修复
  • 稳定扩散 Stable Diffusion 秋叶整合包本地安装与使用指南
  • Llama-2-7B 在昇腾 NPU 上的性能测评与部署指南
  • 跨平台宏定义陷阱与优化:C/C++至HarmonyOS实战解析
  • 前端 SEO 优化实战指南
  • 前端实时数据刷新方案:WebSocket、轮询与 Worker 实战
  • 数据结构:八种常见排序算法详解
  • 鸿蒙应用开发:使用 Swiper 组件实现复杂轮播图
  • PptxGenJS 实战:利用 JavaScript 自动化生成专业 PPT
  • Windows 安装 OpenClaw 配置 Qwen 及 Ollama 本地模型并接入飞书机器人
  • LIBERO:终身机器人学习的综合基准测试平台
  • 本地搭建带知识库的 AI 助手(Ollama + Open WebUI)
  • Git 与 TortoiseGit 详细安装及使用指南
  • llama.cpp Docker 部署:容器化推理服务搭建
  • AIGC 工作流技术资产化与商业化变现指南

相关免费在线工具

  • 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