cyrus-setup-claude-auth

Configure Claude Code authentication credentials for Cyrus via API key, OAuth token, or third-party provider.

794|163|Updated Apr 19, 2025
One-click install
npx skills add https://github.com/ceedaragents/cyrus --skill cyrus-setup-claude-auth
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cyrus-setup-claude-auth
Source: https://github.com/ceedaragents/cyrus/tree/main/skills/cyrus-setup-claude-auth
Command: npx skills add https://github.com/ceedaragents/cyrus --skill cyrus-setup-claude-auth

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Setting up Claude Code credentials for Cyrus requires writing secrets to ~/.cyrus/.env without exposing them in the AI conversation, which is error-prone when done manually.

Core Features & Use Cases

  • Existing Auth Detection: Checks ~/.cyrus/.env for existing ANTHROPIC_API_KEY or CLAUDE_CODE_OAUTH_TOKEN entries and skips reconfiguration when present.
  • Four Auth Methods: Supports current claude CLI session credentials, Anthropic Console API keys, separate OAuth tokens via claude setup-token, and third-party providers like AWS Bedrock and Google Vertex AI.
  • Secret-Safe Handling: Uses clipboard-to-env shell commands and GUI editor windows so tokens never appear in the conversation context.
  • Use Case: During a fresh self-hosted Cyrus installation, run this skill to write your Anthropic API key into ~/.cyrus/.env and verify it was saved before starting the agent.

Quick Start

Ask the agent to set up Claude Code authentication for Cyrus and choose your preferred credential method when prompted.

Frequently Asked Questions about cyrus-setup-claude-auth

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure Claude Code authentication for Cyrus?

Run the setup skill and choose one of four methods: reuse your current claude CLI session, paste an Anthropic Console API key, generate a separate OAuth token with claude setup-token, or configure a third-party provider. The credential is written to ~/.cyrus/.env.

How do I add an Anthropic API key to Cyrus without exposing it?

Copy the key from console.anthropic.com, then use the clipboard-to-env command such as printf with pbpaste on macOS or xclip on Linux to append ANTHROPIC_API_KEY to ~/.cyrus/.env. The key never passes through the conversation.

Does Cyrus support AWS Bedrock or Google Vertex AI for Claude Code?

Yes, third-party providers are supported by setting provider-specific environment variables in ~/.cyrus/.env, such as CLAUDE_CODE_USE_BEDROCK=1 with AWS_REGION, or CLAUDE_CODE_USE_VERTEX=1 with CLOUD_ML_REGION and ANTHROPIC_VERTEX_PROJECT_ID.

Why does the skill avoid reading the Cyrus env file directly?

The skill forbids Read, Edit, or Write tools on ~/.cyrus/.env so secrets are never loaded into the AI conversation context. Only Bash commands like grep and printf are used to check for and append credential lines.

What happens if Claude Code auth is already configured in Cyrus?

The skill counts existing ANTHROPIC_API_KEY or CLAUDE_CODE_OAUTH_TOKEN lines in ~/.cyrus/.env and skips setup if one exists. To reconfigure, remove the existing key from the file and re-run the skill.