Claude API 环境变量配置全指南：从零搭建到生产环境最佳实践

1次阅读

共计 2363 个字符，预计需要花费 6 分钟才能阅读完成。

去年我们团队在接入 Claude API 时，曾因开发人员将 API 密钥硬编码在代码中并上传至公开 GitHub 仓库，导致密钥泄露。攻击者利用该密钥在 24 小时内发起超过 50 万次非法调用，产生巨额费用并触发 API 限流。这个案例让我深刻意识到环境变量管理的重要性。

优点：开发友好，无需修改系统配置
缺点：容易误提交到版本控制，缺乏权限控制
适用场景：本地开发环境

优点：进程隔离，不同应用可独立配置
缺点：备份恢复复杂，缺乏版本历史
适用场景：单服务器部署

优点：自动加密，细粒度访问控制
缺点：增加架构复杂度
适用场景：生产环境和云原生部署

import os
from dotenv import load_dotenv
import logging
from anthropic import Anthropic

# 环境检测
ENV = os.getenv('APP_ENV', 'dev')
env_file = f'.env.{ENV}'

if not os.path.exists(env_file):
    logging.error(f'Missing environment file: {env_file}')
    raise FileNotFoundError(env_file)

load_dotenv(env_file)

try:
    client = Anthropic(api_key=os.environ['CLAUDE_API_KEY'],
        max_retries=3
    )
    # 验证配置
    models = client.models.list()
    logging.info(f'API connection established with {len(models)} models available')
except KeyError as e:
    logging.critical(f'Missing required environment variable: {e}')
    raise
except Exception as e:
    logging.error(f'API connection failed: {e}')
    raise

require('dotenv').config({path: `.env.${process.env.NODE_ENV || 'development'}` })
const {Anthropic} = require('@anthropic-ai/sdk')
const winston = require('winston')

const logger = winston.createLogger({
  level: 'info',
  format: winston.format.json(),
  transports: [new winston.transports.Console()]
})

async function initClaude() {if (!process.env.CLAUDE_API_KEY) {logger.error('CLAUDE_API_KEY is required')
    process.exit(1)
  }

  const client = new Anthropic({apiKey: process.env.CLAUDE_API_KEY,})

  try {const models = await client.models.list()
    logger.info(`Connected to Claude API with ${models.length} models`)
    return client
  } catch (err) {logger.error(`API connection failed: ${err.message}`)
    throw err
  }
}

module.exports = initClaude

为 Claude API 密钥创建专用 IAM 用户
仅赋予 claude-invoke 和claude-models:list权限
禁用控制台登录和编程访问

每月 1 日自动生成新密钥
新旧密钥并行使用 24 小时
通过 API 网关逐步切换流量
旧密钥保留 7 天后彻底删除

# 审计日志示例
import boto3
from datetime import datetime

cloudtrail = boto3.client('cloudtrail')

def log_api_call(user, action):
    cloudtrail.put_events(
        Events=[{'EventTime': datetime.utcnow(),
            'EventSource': 'claude-api',
            'EventName': action,
            'Username': user,
            'Resources': [{'ARN': 'arn:aws:claude:us-west-2:123456789012:api'}]
        }]
    )