https://github.com/aipcc-cicd/claudio
Portable Claude Code Setup
https://github.com/aipcc-cicd/claudio
ai ai-agents claude-code
Last synced: 22 days ago
JSON representation
Portable Claude Code Setup
- Host: GitHub
- URL: https://github.com/aipcc-cicd/claudio
- Owner: aipcc-cicd
- License: apache-2.0
- Created: 2025-09-11T14:48:52.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-01-26T05:50:19.000Z (23 days ago)
- Last Synced: 2026-01-26T17:00:03.154Z (22 days ago)
- Topics: ai, ai-agents, claude-code
- Language: Shell
- Homepage:
- Size: 37.1 KB
- Stars: 9
- Watchers: 0
- Forks: 4
- Open Issues: 21
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# claudio
OCI image to make claude code portable; the model is being setup to use through Google Vertex AI API.
The image includes the Slack MCP server for communication, along with `glab` and `kubectl` CLIs. Additional functionality is provided through the [claudio-skills marketplace](https://github.com/aipcc-cicd/claudio-skills).
# Integrations
## Slack
To manage slack integration claudio will use https://github.com/korotovsky/slack-mcp-server,
To get values for them the easiest way is to authenticate to your slack workspace in chrome/chromium browser
On same page go to More Tools -> Developer Tools
On Developer Tools go to:
* XOXC: Application -> Storage -> Local Storage -> https>//app.slack.com -> localConfig_v2 (key) -> 'token' key inside the json value
* XOXD: Application -> Storage -> Cookies -> https>//app.slack.com -> d (key)
Since it is slack enterpise we need to get value for User-Agent. To get it from same place we check Networking and check request headers to get the value,
it should be something similar to `Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/139.0.0.0 Safari/537.36`
Disclaimer, the first time you reuse those Tokens you will probably be signed off as precaution, the second time you sign in the tokens should last.
## GitLab
GitLab integration is provided through the `glab` CLI tool and the claudio-skills marketplace. The `glab` CLI is pre-installed in the container.
## Kubernetes / OpenShift
Kubernetes and OpenShift management is handled through `kubectl` (pre-installed) and skills from the claudio-skills marketplace.
# Build
To build the container run the command:
```bash
make oci-build
```
This builds for the native architecture of the current platform.
You can customize the image name and tag:
```bash
IMAGE_REPO=ghcr.io/myorg/claudio IMAGE_TAG=latest make oci-build
```
By default, the Makefile uses Podman. To use Docker instead:
```bash
CONTAINER_MANAGER=docker make oci-build
```
Available targets:
- `oci-build` - Build container image for native architecture
- `oci-push` - Push container image
- `oci-tag` - Tag existing image with new tag
- `oci-manifest-build` - Create multi-arch manifest from arch-tagged images
- `oci-manifest-push` - Push manifest to registry
# Usage
In order to make claudio OpenShift compliant the default user for the container is default, it is also part of the root group, under some circumstances when mapping host volumes podman is not able to access the volume (even with the right permissions), to avoid that siatuion we suggest when running locally to use `--user 0` to enforce default behavior by podman.
## Working with Local Projects
Claudio supports mounting your local project directory for interactive development. When you mount a directory to `/home/default/workdir`, claudio will automatically change to that directory before starting the Claude session, allowing you to work with your local files.
Example mounting your current directory:
```bash
podman run -it --rm --user 0 \
-v ${PWD}:/home/default/workdir:z \
-v claudio-gcp:/root/.config/gcloud:Z \
-v claudio-mcp-slack:/root/claude/mcp/slack:Z \
-e GITLAB_TOKEN='...' \
-e ANTHROPIC_VERTEX_PROJECT_ID=... \
-e ANTHROPIC_VERTEX_PROJECT_QUOTA=... \
-e SLACK_MCP_XOXC_TOKEN='xoxc-...' \
-e SLACK_MCP_XOXD_TOKEN='xoxd-...' \
-e K8S_MCP_KUBECONFIG_PATH=/opt/k8s/kubeconfig \
quay.io/redhat-aipcc/claudio:v1.0.0-dev
```
This allows you to use claudio with your local codebase, making file edits, running commands, and interacting with your project files directly.
## Basic Setup
```bash
# Create a volume to hold the auth for gcloud
podman volume create claudio-gcp
# Create a volume to hold cache for mcp slack
podman volume create claudio-mcp-slack
# Run claudio
podman run -it --rm --user 0 \
-v ${PWD}/kubecofing:/opt/k8s/kubeconfig:z \
# Optional
-v claudio-gcp:/root/.config/gcloud:Z \
# Optional
-v claudio-mcp-slack:/root/claude/mcp/slack:Z \
-e GITLAB_TOKEN='...' \
-e ANTHROPIC_VERTEX_PROJECT_ID=... \
-e ANTHROPIC_VERTEX_PROJECT_QUOTA=... \
-e SLACK_MCP_XOXC_TOKEN='xoxc-...' \
-e SLACK_MCP_XOXD_TOKEN='xoxd-...' \
-e K8S_MCP_KUBECONFIG_PATH=/opt/k8s/kubeconfig \
quay.io/aipcc-cicd/claudio:v1.0.0-dev
```
Claudio on a host where user is already logged in on gcloud:
```bash
# Run claudio
podman run -it --rm -user 0 \
-v ${PWD}/kubecofing:/opt/k8s/kubeconfig:z \
-v /home/$USER/.conf/gcloud:/root/.config/gcloud:z \
-e GITLAB_TOKEN='...' \
-e ANTHROPIC_VERTEX_PROJECT_ID=... \
-e ANTHROPIC_VERTEX_PROJECT_QUOTA=... \
-e SLACK_MCP_XOXC_TOKEN='xoxc-...' \
-e SLACK_MCP_XOXD_TOKEN='xoxd-...' \
-e K8S_MCP_KUBECONFIG_PATH=/opt/k8s/kubeconfig \
quay.io/aipcc-cicd/claudio:v1.0.0-dev
```
Claudio one-time prompt
```bash
# Run claudio
podman run -it --rm -user 0 \
-v ${PWD}/kubecofing:/opt/k8s/kubeconfig:z \
-v /home/$USER/.conf/gcloud:/root/.config/gcloud:z \
-e GITLAB_TOKEN='...' \
-e ANTHROPIC_VERTEX_PROJECT_ID=... \
-e ANTHROPIC_VERTEX_PROJECT_QUOTA=... \
-e SLACK_MCP_XOXC_TOKEN='xoxc-...' \
-e SLACK_MCP_XOXD_TOKEN='xoxd-...' \
-e K8S_MCP_KUBECONFIG_PATH=/opt/k8s/kubeconfig \
quay.io/aipcc-cicd/claudio:v1.0.0-dev \
-p "do something for me Claudio"
```