weaponsforge/claude-cli repository overview

⁠claude-cli

Light-weight Docker wrapper for Claude Code CLI, installing it in an isolated container to avoid direct installation in a host machine. Installed with Node.js 24.11.0, Python3 and pip.

GitHub Repository
https://github.com/weaponsforge/claude-cli⁠

⁠📋 Requirements

⁠Anthropic account

Choose between the two (options):

1. Anthropic account with Claude subscription (Pro, Max, Team, or Enterprise)

• No need to have $5 API credits when using the "Claude account with subscription" option on CLI login

2. Anthropic account with at least $5 API credits

• Add funds under Anthropic Console⁠ ⟶ Credits ⟶ Add funds
• Only required when using the ANTHROPIC_API_KEY key and the "Anthropic Console account · API usage billing" option with Claude Code CLI login
• Ensure the ANTHROPIC_API_KEY is linked with a Workspace under your account.
• Generate an Anthropic key at the Anthropic Console

⁠🚀 Usage

⁠1. Pull the "latest" development image

docker pull weaponsforge/claude-cli

⁠2. (Optional) Use an Anthropic API Key

• Create a .env file from the .env.example file.
• Replace the value of the ANTHROPIC_API_KEY with your own Anthropic API key.

⁠3. Run the Claude Code CLI

Prepare the project code folder that which may optionally require a .env file.

‼️ IMPORTANT:
The project folder must be the root of your Node.js application (typically the directory containing package.json and /node_modules), not a parent directory containing the app.

For example if your project is a Node.js/React app under the "my-app" folder:

├─ my-app
│   ├─ .env             # optional
│   ├─ package.json
│   ├─ package-lock.json
│   ├─ node_modules
│   ├─ public
│   ├─ app
│   ├─── favicon.ico
│   ├─── globals.css
│   ├─── layout.tsx
│   ├─── page.tsx
│   ├─ components 
│   ├─── ...

Mount it in the container using:

Bash (with .env file)

docker run -it --rm \
  --name weaponsforge-claude-cli \
  --security-opt no-new-privileges:true \
  --cap-drop ALL \
  -v /path/to/my-app:/opt/app \
  -v /opt/app/node_modules \
  -v /opt/app/.next \
  -v /opt/app/node_modules/.vite \
  -v /opt/app/node_modules/.tmp \
  --env-file /path/to/my-app/.env \
  weaponsforge/claude-cli:latest \
  claude

Bash (no .env file)

docker run -it --rm \
  --name weaponsforge-claude-cli \
  --security-opt no-new-privileges:true \
  --cap-drop ALL \
  -v /path/to/my-app:/opt/app \
  -v /opt/app/node_modules \
  -v /opt/app/.next \
  -v /opt/app/node_modules/.vite \
  -v /opt/app/node_modules/.tmp \
  weaponsforge/claude-cli:latest \
  claude

💡 TIPS:

• Include the ANTHROPIC_API_KEY in the project's .env file if you are using the Anthropic API Key for Claude Code authentication instead of browser sign-in
• IMPORTANT: take note to mount "node_modules" as an anonymous volume "-v /opt/app/node_modules" so that container npm installs don't land in the host file system
• Refer to the project's GitHub README⁠ file for detailed usage information

⁠4. Login to the Claude CLI

• Select the "Claude account with subscription · Pro, Max, Team, or Enterprise" option on CLI login if you have a Claude subscription
• Select the "Anthropic Console account · API usage billing" option on CLI login if you don't have a Claude subscription but have at least $5 API credits and an ANTHROPIC_API_KEY in the .env file

⁠5. Confirm that Claude Code can read the mounted project folder

Ask Claude:

analyze and explain to me this repository.