配置指南¶

环境变量¶

所有配置都通过环境变量进行。创建 .env 文件或直接设置系统环境变量。

必需配置：

ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxx

可选配置（使用自定义 API 端点）：

ANTHROPIC_BASE_URL=https://api.anthropic.com
ANTHROPIC_API_VERSION=2023-06-01

如果使用 MiniMax 作为模型提供商，配置如下：

ANTHROPIC_BASE_URL=https://api.minimaxi.chat/v1
ANTHROPIC_API_KEY=your_minimax_api_key

启用 Serper.dev 作为网络搜索引擎：

SERPER_API_KEY=your_serper_api_key

注: 如果不配置此项，将使用 Anthropic 原生搜索功能。

如果要禁用模型的交错思考功能：

ANTHROPIC_DISABLE_INTERLEAVED_THINKING=true

# 运行环境
NODE_ENV=development|production

# 日志级别
LOG_LEVEL=debug|info|warn|error

# 调试模式
DEBUG=*

环境变量的加载优先级（从高到低）：

在项目根目录创建 .env 文件：

open-claude-code/
├── .env                 # 主配置文件
├── .env.local          # 本地覆盖（不提交）
├── .env.example        # 示例配置（已提交）
└── ...

确保以下文件在 .gitignore 中，不要提交含敏感信息的配置：

.env
.env.local
.env.*.local

ANTHROPIC_API_KEY=your_api_key
NODE_ENV=development
LOG_LEVEL=debug

ANTHROPIC_API_KEY=your_prod_api_key
NODE_ENV=production
LOG_LEVEL=info
SERPER_API_KEY=your_serper_key

ANTHROPIC_BASE_URL=https://api.minimaxi.chat/v1
ANTHROPIC_API_KEY=minimax_key
SERPER_API_KEY=serper_key
NODE_ENV=production

ANTHROPIC_API_KEY=placeholder_key
# 仅使用文件操作、Git 等本地工具

# 显示所有已配置的 Anthropic 相关变量
env | grep ANTHROPIC

bun run cli advisor "test connection"

启用调试模式查看配置加载过程：

DEBUG=* bun run cli --version

解决方案: 1. 验证密钥是否正确复制 2. 检查密钥是否过期 3. 确保密钥有正确的权限 4. 查看 API 文档确认密钥格式

解决方案: 1. 验证 SERPER_API_KEY 是否配置 2. 检查 API 配额是否耗尽 3. 如果配置了自定义 URL，检查网络连接

解决方案: 1. 检查网络连接 2. 如果使用自定义端点，验证端点可用性 3. 尝试禁用交错思考: ANTHROPIC_DISABLE_INTERLEAVED_THINKING=true