mcpField
C
cyrus-setup-claude-auth

cyrus-setup-claude-auth

github.com/cyrusagentsAgent 工作流8791.1k 次安装今天更新
代码仓库

关于 cyrus-setup-claude-auth

为 Cyrus 配置 Claude Code 身份验证的设置技能,涵盖账户凭据、API 密钥、OAuth 令牌和第三方提供商,并避免将密钥暴露在对话中。

主要功能

  1. 01检查现有身份验证
  2. 02指导配置四种身份验证方式
  3. 03保存凭据且不暴露密钥
  4. 04验证配置是否写入

适用场景

  1. 01准备让 Cyrus 运行 Claude Code 会话
  2. 02切换到另一个 Claude 账户
  3. 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 进行身份验证?

  1. 当前账户(最简单)——使用当前 claude CLI 会话中的凭据
  2. API 密钥——来自 console.anthropic.com
  3. 单独的 OAuth 令牌——运行 claude setup-token,为特定账户生成令牌
  4. 第三方提供商——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

告知用户:

  1. 在单独的终端中运行 claude setup-token
  2. 复制命令输出的令牌
  3. 我已打开 ~/.cyrus/.env——找到 CLAUDE_CODE_OAUTH_TOKEN= 这一行
  4. 将令牌粘贴到 = 之后(不要添加空格或换行)
  5. 保存并关闭文件
选项 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

告知用户:

  1. 在另一台计算机上运行 claude setup-token
  2. 复制命令输出的令牌
  3. 我已打开 ~/.cyrus/.env——找到 CLAUDE_CODE_OAUTH_TOKEN=,并将令牌粘贴到 = 之后
  4. 保存并关闭文件
选项 4:第三方提供商

告知用户:

对于第三方提供商,你需要设置提供商专用的环境变量。 详情请参阅第三方集成。

常见配置:

AWS Bedrock:

CLAUDE_CODE_USE_BEDROCK=1
AWS_REGION=us-east-1

Google 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 身份验证已配置。

评论

支持 Markdown