关于 cyrus-setup-claude-auth
为 Cyrus 配置 Claude Code 身份验证的设置技能,涵盖账户凭据、API 密钥、OAuth 令牌和第三方提供商,并避免将密钥暴露在对话中。
主要功能
- 01检查现有身份验证
- 02指导配置四种身份验证方式
- 03保存凭据且不暴露密钥
- 04验证配置是否写入
适用场景
- 01准备让 Cyrus 运行 Claude Code 会话
- 02切换到另一个 Claude 账户
- 03配置 API 密钥或第三方提供商访问
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ cyrusagents/ cyrus --skill cyrus-setup-claude-auth安装后在 Claude Code 中输入/cyrus-setup-claude-auth确认已加载。
详细介绍
关键:绝不要对 ~/.cyrus/.env 或 ~/.cyrus/ 中的任何文件使用 Read、Edit 或 Write 工具。只能使用 Bash 命令(grep、printf >> 等)与环境变量文件交互——绝不能将机密读入对话上下文。
设置 Claude Auth
配置 Claude Code 凭据,以便 Cyrus 可以运行 AI 会话。
步骤 1:检查现有身份验证
检查是否已配置凭据:
grep -c -E '^(ANTHROPIC_API_KEY|CLAUDE_CODE_OAUTH_TOKEN)=' ~/.cyrus/.env 2>/dev/null || echo "0"
如果计数 >= 1,请告知用户:
Claude Code 身份验证已配置。跳过此步骤。 要重新配置,请从
~/.cyrus/.env中移除现有密钥,然后重新运行此技能。
跳至完成部分。
步骤 2:选择身份验证方式
询问用户:
你想如何对 Claude Code 进行身份验证?
- 当前账户(最简单)——使用当前
claudeCLI 会话中的凭据- API 密钥——来自 console.anthropic.com
- 单独的 OAuth 令牌——运行
claude setup-token,为特定账户生成令牌- 第三方提供商——Vertex AI、AWS Bedrock、Azure 等
步骤 3:配置凭据
关键:机密绝不能出现在对话中。 不要在 ~/.claude/ 中查找凭据文件。只能使用以下方法。
检测操作系统,以选择正确的剪贴板命令:
uname -s
选项 1:当前账户
检查此计算机上的 claude 是否已通过身份验证:
claude auth status
如果已通过身份验证,请指示用户运行 claude setup-token,该命令会输出一个令牌。
为安全地捕获令牌,先在环境变量文件中追加一行占位内容,然后在 GUI 窗口中打开该文件,以便用户粘贴令牌:
grep -q '^CLAUDE_CODE_OAUTH_TOKEN=' ~/.cyrus/.env || echo 'CLAUDE_CODE_OAUTH_TOKEN=' >> ~/.cyrus/.env
然后在单独的窗口中打开该文件——使用任何可用的 GUI 编辑器:
# macOS: VS Code if available, otherwise TextEdit
code --new-window ~/.cyrus/.env 2>/dev/null || open -a TextEdit ~/.cyrus/.env
# Linux
code ~/.cyrus/.env 2>/dev/null || xdg-open ~/.cyrus/.env
告知用户:
- 在单独的终端中运行
claude setup-token- 复制命令输出的令牌
- 我已打开
~/.cyrus/.env——找到CLAUDE_CODE_OAUTH_TOKEN=这一行- 将令牌粘贴到
=之后(不要添加空格或换行)- 保存并关闭文件
选项 2:API 密钥
指示用户从 Anthropic Console 复制 API 密钥,然后提供相应的命令:
macOS:
printf 'ANTHROPIC_API_KEY=%s\n' "$(pbpaste)" >> ~/.cyrus/.env
Linux:
printf 'ANTHROPIC_API_KEY=%s\n' "$(xclip -selection clipboard -o)" >> ~/.cyrus/.env
通用备用方案:
read -s -p "Paste your Anthropic API key: " val && printf 'ANTHROPIC_API_KEY=%s\n' "$val" >> ~/.cyrus/.env && echo " ✓ Saved"
选项 3:单独的 OAuth 令牌
当用户想为与当前登录账户不同的账户生成令牌时,使用此选项(例如,在另一台计算机上运行 claude setup-token)。
追加占位内容,然后打开文件,让用户粘贴令牌:
grep -q '^CLAUDE_CODE_OAUTH_TOKEN=' ~/.cyrus/.env || echo 'CLAUDE_CODE_OAUTH_TOKEN=' >> ~/.cyrus/.env
# macOS
code --new-window ~/.cyrus/.env 2>/dev/null || open -a TextEdit ~/.cyrus/.env
# Linux
code ~/.cyrus/.env 2>/dev/null || xdg-open ~/.cyrus/.env
告知用户:
- 在另一台计算机上运行
claude setup-token- 复制命令输出的令牌
- 我已打开
~/.cyrus/.env——找到CLAUDE_CODE_OAUTH_TOKEN=,并将令牌粘贴到=之后- 保存并关闭文件
选项 4:第三方提供商
告知用户:
对于第三方提供商,你需要设置提供商专用的环境变量。 详情请参阅第三方集成。
常见配置:
AWS Bedrock:
CLAUDE_CODE_USE_BEDROCK=1 AWS_REGION=us-east-1Google Vertex AI:
CLAUDE_CODE_USE_VERTEX=1 CLOUD_ML_REGION=us-east5 ANTHROPIC_VERTEX_PROJECT_ID=your-project-id
引导用户使用“剪贴板到环境变量文件”的方式,将相应变量添加到 ~/.cyrus/.env。
步骤 4:验证
用户运行命令后,验证密钥是否已写入:
grep -c -E '^(ANTHROPIC_API_KEY|CLAUDE_CODE_OAUTH_TOKEN|CLAUDE_CODE_USE_BEDROCK|CLAUDE_CODE_USE_VERTEX)=' ~/.cyrus/.env
如果计数为 0,则凭据未保存。请让用户重试。
完成
✓ Claude Code 身份验证已配置。