Claude Code环境变量配置全指南：从基础到生产环境最佳实践

1次阅读

没有评论

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

在 Claude Code 开发过程中，环境变量管理常常成为项目后期维护的痛点。很多开发者可能都遇到过这样的情况：

项目初期为了快速开发，直接将 API 密钥、数据库连接信息等敏感数据硬编码在代码中，导致后期需要逐个文件修改
不同环境（开发、测试、生产）的配置混杂在一起，难以区分和管理
团队成员间通过微信或邮件分享.env 文件，存在泄露风险
部署到生产环境时，发现某些配置遗漏或错误，导致服务无法启动

更严重的是，由于配置管理不当引发的安全事故屡见不鲜。例如某知名公司因为将 AWS 访问密钥提交到公共代码库，导致黑客利用这些密钥创建了价值数万美元的加密货币挖矿实例。这些问题的根源往往在于缺乏规范的环境变量管理策略。

在 Claude Code 项目中，我们主要有三种管理环境变量的方式：

.env 文件
适合开发环境使用
便于版本控制和团队共享
需要确保不提交到代码仓库
系统环境变量
适合生产环境使用
由部署平台管理
安全性较高
配置中心
适合大型分布式系统
支持动态更新配置
如 AWS Parameter Store、Consul 等

Python 中常用的 dotenv 库工作原理很简单：

解析.env 文件内容
将键值对注入到 os.environ
应用程序通过 os.getenv 访问

安全增强方案：

在.gitignore 中添加.env
使用.env.example 模板文件
对敏感值进行加密处理

我们可以通过环境变量实现配置分层：

# config.py
import os
from functools import lru_cache

class Settings:
    @property
    def env(self) -> str:
        return os.getenv("ENVIRONMENT", "dev")

    @property
    def database_url(self) -> str:
        return os.getenv(f"DATABASE_URL_{self.env.upper()}")

@lru_cache()
def get_settings() -> Settings:
    return Settings()

import os
from typing import Optional

def get_env_var(key: str, default: Optional[str] = None) -> str:
    """安全获取环境变量"""
    value = os.getenv(key)
    if value is None:
        if default is None:
            raise ValueError(f"环境变量 {key} 未设置")
        return default
    return value

# 使用示例
API_KEY = get_env_var("API_KEY")
DB_URL = get_env_var("DB_URL", "sqlite:///temp.db")

使用 python-decouple 实现类型安全转换：

from decouple import config

DEBUG = config("DEBUG", default=False, cast=bool)
PORT = config("PORT", default=8000, cast=int)
ALLOWED_HOSTS = config(
    "ALLOWED_HOSTS", 
    default="localhost,127.0.0.1", 
    cast=lambda v: [s.strip() for s in v.split(",")]
)

import boto3
from botocore.exceptions import ClientError

def get_ssm_parameter(name: str, region: str = "us-east-1") -> str:
    """从 AWS Parameter Store 获取参数"""
    client = boto3.client("ssm", region_name=region)
    try:
        response = client.get_parameter(
            Name=name,
            WithDecryption=True
        )
        return response["Parameter"]["Value"]
    except ClientError as e:
        raise ValueError(f"获取参数 {name} 失败: {e}")

IAM 权限配置示例：

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": ["ssm:GetParameter"],
            "Resource": "arn:aws:ssm:us-east-1:123456789012:parameter/claude/*"
        }
    ]
}

推荐方案：

使用 AWS KMS 加密敏感环境变量
在应用启动时解密
内存中使用后尽快清除

import boto3
from base64 import b64decode

kms = boto3.client("kms")

def decrypt_env(encrypted: str) -> str:
    """解密 KMS 加密的环境变量"""
    return kms.decrypt(CiphertextBlob=b64decode(encrypted)
    )["Plaintext"].decode("utf-8")

Docker Compose 示例：

version: "3.8"

services:
  app:
    build: .
    environment:
      - DATABASE_URL=postgres://user:pass@db:5432/app
      - REDIS_URL=redis://redis:6379/0
    depends_on:
      - db
      - redis

  db:
    image: postgres:13
    environment:
      - POSTGRES_PASSWORD_FILE=/run/secrets/db_password
    secrets:
      - db_password

secrets:
  db_password:
    file: ./secrets/db_password.txt

建议方案：