[BUG] Claude Code Offline Installation

Resolved 💬 1 comment Opened Apr 28, 2026 by boboz2 Closed May 30, 2026

Preflight Checklist

  • [x] I have searched existing issues and this hasn't been reported yet
  • [x] This is a single bug report (please file separate reports for different bugs)
  • [x] I am using the latest version of Claude Code

What's Wrong?

I am reaching out regarding an issue I am encountering while attempting to install Claude Code in an offline/air-gapped environment.

Since my environment has no internet access, I downloaded the Claude Code binary directly from the following URL:
https://downloads.claude.ai/claude-code-releases/2.1.117/linux-x64/claude

What Should Happen?

I can install Claude Code with oo internet access

Error Messages/Logs

When attempting to run the installation, I receive the following error:
Failed to fetch version from https://downloads.claude.ai/claude-code-releases/stable: 
timeout of 30000ms exceeded
This is expected behavior given the lack of internet connectivity. However, I have also tried running the command with the --force flag as suggested in the error output, but unfortunately this does not resolve the issue either.

Steps to Reproduce

Environment details:

  • OS: Linux x64
  • Binary version: 2.1.117
  • Network: No internet access (air-gapped)

Download https://downloads.claude.ai/claude-code-releases/2.1.117/linux-x64/claude
Copy to the machine and test install

Claude Model

None

Is this a regression?

Yes, this worked in a previous version

Last Working Version

2.1.89

Claude Code Version

2.1.117

Platform

Google Vertex AI

Operating System

Ubuntu/Debian Linux

Terminal/Shell

Other

Additional Information

  • Is there an officially supported method to install and run Claude Code in a fully offline or air-gapped environment?
  • Is it possible to bypass the version check that is triggering this timeout?
  • Are there any additional configuration files, environment variables, or flags that could allow the binary to run without attempting to reach external endpoints?

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗