# 验证流程 > 来源：[Claude 代码设置]()、[API 密钥管理]() ## MVP 状态 **AuthManager 未实现。** MVP 使用SetupWizard 在运行时收集凭据（无持久性）。凭证直接传递给 IPC 处理程序。当前流程：用户在SetupWizard中输入密钥→传递给`window.api.startRun()`→注入沙箱环境变量。 ** ** ## 问题 Claude Code 需要基于浏览器的 OAuth 身份验证，但 Daytona 沙箱是无头的（无浏览器访问）。 ## 环境变量变量|描述 |认证方式 ---|---|--- `ANTHROPIC_API_KEY` |来自 console.anthropic.com 的 API 密钥 |按量付费 API `CLAUDE_CODE_OAUTH_TOKEN` |来自本地身份验证的 OAuth 令牌 |基于订阅 **优先级**：如果两者都设置了，`ANTHROPIC_API_KEY` 将覆盖 OAuth 令牌。 **警告**：设置“ANTHROPIC_API_KEY”会绕过 API 即用即付费率的任何订阅和费用。 ## 沙箱的身份验证选项 ### 选项 1：API 密钥（推荐用于沙箱）对于无头环境最可靠。 1. 从 [console.anthropic.com]() 获取 API 密钥 2. 安全储存（Electron safeStorage） 3. 作为环境变量注入沙盒中： const sandbox = 等待 daytona.create({ 语言：'打字稿'，环境变量：{ ANTHROPIC_API_KEY：凭证.apiKey } }) **优点**：简单、可靠，没有 OAuth 复杂性 **缺点**：即用即付定价（无订阅使用） ### 选项 2：OAuth 令牌传输从经过身份验证的本地计算机传输 OAuth 凭据。 1. 用户在本地进行身份验证：“claude”（打开浏览器） 2. 令牌存储在：`~/.config/claude-code/auth.json` 3. 用户向应用程序提供令牌 4.应用程序作为环境变量注入： const sandbox = 等待 daytona.create({ 语言：'打字稿'，环境变量：{ CLAUDE_CODE_OAUTH_TOKEN：凭证.oauthToken } }) **优点**：使用订阅计划 **缺点**：令牌可能过期，需要手动提取 ### auth.json 位置和格式〜/.config/claude-code/auth.json 令牌可跨机器移植（不受 IP/机器限制）。 **安全**：像密码一样对待。如果通过 Claude.ai 帐户设置受到损害，请立即撤销。 ## AuthManager 实现从“电子”导入{安全存储} 接口凭证{ daytonaApiKey：字符串 authMethod: 'api_key' | authMethod: 'api_key' | 'oauth_token' anthropicApiKey？：字符串 claudeOAuthToken？：字符串 } 类 AuthManager { 私有只读 STORAGE_KEY = '多重凭证' 异步 loadCredentials(): Promise { 尝试{ const 加密 = 等待 this.readFromStorage() if (!加密) 返回 null const 解密 = safeStorage.decryptString(加密) 返回 JSON.parse(解密) } 抓住 { 返回空值 } } 异步 saveCredentials(凭证: 凭证): Promise { const 加密 = safeStorage.encryptString(JSON.stringify(credentials)) 等待 this.writeToStorage（加密） } 异步 validateApiKey(apiKey: string): Promise { 尝试{ const 响应 = 等待 fetch('https://api.anthropic.com/v1/messages', { 方法：'POST'，标题：{ 'x-api-key': apiKey, '人类版本': '2023-06-01', '内容类型'：'应用程序/json' }, 正文：JSON.stringify({ 型号: 'claude-3-haiku-20240307', 最大令牌数：1，消息：[{角色：'用户'，内容：'嗨'}] }) }) 返回响应.ok || response.status === 400 // 400 = 有效密钥，错误请求 } 抓住 { 返回错误 } } 异步 validateDaytonaKey(apiKey: string): Promise { 尝试{ const { Daytona } =等待导入（'@daytonaio/sdk'） const Daytona = new Daytona({ apiKey }) wait daytona.list({}, 1, 1) // 简单的列表调用来验证返回真 } 抓住 { 返回错误 } } getEnvVarsForSandbox（凭证：凭证）：记录<字符串，字符串> { if (credentials.authMethod === 'api_key' && credentials.anthropicApiKey) { 返回 { ANTHROPIC_API_KEY：凭证.anthropicApiKey } } 如果（credentials.claudeOAuthToken）{ 返回 { CLAUDE_CODE_OAUTH_TOKEN：凭证.claudeOAuthToken } } 返回{} } 异步clearCredentials(): Promise { 等待 this.deleteFromStorage() } // 平台特定的存储方法私有异步 readFromStorage(): Promise { // 使用电子存储或类似的实现 } 私有 async writeToStorage(data: Buffer): Promise { // 实现 } 私有异步deleteFromStorage(): Promise { // 实现 } } 导出 const authManager = 新 AuthManager() ## 设置向导流程 ┌──────────────────────────────────────────┐ │ 欢迎使用 Multishot │ │ │ │ 输入您的 Daytona API 密钥： │ │ [____________________________________] │ │ │ │ 获取密钥：app.daytona.io │ └──────────────────────────────────────────┘ ↓ ┌──────────────────────────────────────────┐ │ 克劳德认证 │ │ │ │ ○ API Key（推荐用于沙箱）│ │ - 按量付费定价 │ │ - 最可靠 │ │ │ │ ○ OAuth 令牌 │ │ - 使用订阅计划 │ │ - 可能需要刷新 │ │ │ │ [继续] │ └──────────────────────────────────────────┘ ↓ ┌──────────────────────────────────────────┐ │ （如果选择了 API 密钥） │ │ │ │ 人择 API 密钥： │ │ [____________________________________] │ │ │ │ 获取密钥：console.anthropic.com │ │ │ │ [验证并保存] │ └──────────────────────────────────────────┘ ↓ ┌──────────────────────────────────────────┐ │ （如果选择了 OAuth 令牌） │ │ │ │ 1. 在本地运行“claude”进行身份验证 │ │ 2. 在以下位置查找令牌： │ │ ~/.config/claude-code/auth.json │ │ 3. 将令牌粘贴到下面： │ │ │ │ [____________________________________] │ │ │ │ [验证并保存] │ └──────────────────────────────────────────┘ ## 凭证存储 **要求：** * 切勿将明文凭证存储在数据库或文件中 * 使用 Electron 的 `safeStorage` API（操作系统钥匙串集成） * 环境变量仅在沙箱生命周期内存在 * 编辑日志中的凭据从“电子”导入{安全存储} // 检查加密是否可用如果（safeStorage.isEncryptionAvailable（））{ // 存储前加密 const 加密 = safeStorage.encryptString(JSON.stringify(credentials)) // 读取时解密 const 解密 = safeStorage.decryptString(加密) const 凭证 = JSON.parse(解密) } ## 错误检测和恢复注意沙箱输出中的这些模式：错误模式 |原因 |行动 ---|---|--- `“身份验证失败”` |凭证无效 |重新提示设置向导 `“OAuth 令牌已过期”` |令牌已过期 |请求新令牌 `“API 密钥无效”` |错误或已撤销的密钥 |验证控制台中的密钥 `“超出速率限制”` |请求过多 |退出，重试 `“身份验证冲突”` |令牌和密钥集 |明确一种方法函数 detectorAuthError(输出：字符串): '过期' | '无效' | '冲突' |空{ if (output.includes('OAuth 令牌已过期')) 返回 '过期' if (output.includes('身份验证失败')) 返回 '无效' if (output.includes('无效的 API 密钥')) 返回 '无效' if (output.includes('验证冲突')) 返回 '冲突' 返回空值 } // 在 IPC 处理程序中 sandbox.process.getSessionCommandLogs(会话, cmdId, （标准输出）=> { 常量错误 = detectorAuthError(stdout) 如果（错误）{ sendToRenderer('auth-error', { 类型: 错误 }) } }, （标准错误）=> { 常量错误 = detectorAuthError(stderr) 如果（错误）{ sendToRenderer('auth-error', { 类型: 错误 }) } } ） ## 检查身份验证状态在交互式克劳德代码中： /状态显示当前的身份验证方法和帐户信息。 ## 令牌撤销如果凭证被泄露： 1. **API 密钥** ：在 console.anthropic.com 撤销 → API 密钥 2. **OAuth 令牌**：在 claude.ai 撤销 → 账户设置 → 安全 → 活动会话 ## 最佳实践 1. **首选 API 密钥** 用于沙箱/无头使用 - 最可靠 2. **输入时验证** \- 保存前测试凭据 3. **处理过期** \- OAuth token 可以过期、检测并提示 4. **安全存储** \- 始终使用 safeStorage，切勿使用明文 5. **最小范围** \- 仅请求所需的权限 6. **注销时清除** \- 用户注销时删除凭据

认证流程

包含技能