配置位置
Claude Code
JSON 文件位于 ~/.claude/ 或 ./.claude/
Codex/Windsurf
TOML 文件位于 ~/.codex/
OpenCode
JSON 文件位于 ~/.config/opencode/ 或 ./
配置级别
系统级(全局)
应用于您计算机上的所有项目。
| 工具 | 位置 |
|---|
| Claude Code | ~/.claude/settings.json
~/.claude.json |
| Codex/Windsurf | ~/.codex/config.toml |
| OpenCode | ~/.config/opencode/opencode.json |
项目级(本地)
仅应用于当前项目目录。
| 工具 | 位置 |
|---|
| Claude Code | ./.claude/settings.json
./.claude/settings.local.json |
| Codex/Windsurf | 不支持 |
| OpenCode | ./opencode.json |
环境变量
CLI 会自动在您的 Shell 配置文件中设置这些环境变量。
Claude Code
export ANTHROPIC_BASE_URL="https://ai.megallm.io"
export ANTHROPIC_API_KEY="sk-mega-your-api-key-here"
Codex/Windsurf
export MEGALLM_API_KEY="sk-mega-your-api-key-here"
OpenCode
export MEGALLM_API_KEY="sk-mega-your-api-key-here"
注意: Codex/Windsurf 和 OpenCode 共享相同的 MEGALLM_API_KEY 环境变量。
验证环境变量
# Claude Code
echo $ANTHROPIC_BASE_URL
# 输出: https://ai.megallm.io
echo $ANTHROPIC_API_KEY
# 输出: sk-mega-your-api-key-here
# Codex/Windsurf & OpenCode
echo $MEGALLM_API_KEY
# 输出: sk-mega-your-api-key-here
配置优先级
当存在多个配置时,它们按以下顺序应用(从高到低):
备份文件
CLI 在修改配置之前会自动创建备份文件:
~/.claude/settings.json.backup
~/.codex/config.toml.backup
~/.config/opencode/opencode.json.backup
mv ~/.claude/settings.json.backup ~/.claude/settings.json
工具特定配置
选择您的 AI 工具以获取详细的配置信息:
Claude Code 配置
JSON 配置、环境变量和状态栏设置
Codex/Windsurf 配置
TOML 配置和模型提供商设置
OpenCode 配置
JSON 配置和 API 设置
快速配置检查
验证所有配置
# 检查 Claude Code
ls -la ~/.claude/
cat ~/.claude/settings.json
# 检查 Codex
ls -la ~/.codex/
cat ~/.codex/config.toml
# 检查 OpenCode
ls -la ~/.config/opencode/
cat ~/.config/opencode/opencode.json
# 检查环境变量
env | grep -E "ANTHROPIC|MEGALLM"
测试 API 连接
# 使用 Claude Code 凭据测试
curl -H "Authorization: Bearer $ANTHROPIC_API_KEY" \
-H "Content-Type: application/json" \
$ANTHROPIC_BASE_URL/v1/models
# 使用 Codex/OpenCode 凭据测试
curl -H "Authorization: Bearer $MEGALLM_API_KEY" \
-H "Content-Type: application/json" \
https://ai.megallm.io/v1/models
手动配置
如果您不想使用 CLI,可以手动配置:
Claude Code
Codex/Windsurf
OpenCode
# 创建目录
mkdir -p ~/.claude
# 创建设置文件
cat > ~/.claude/settings.json << 'EOF'
{
"env": {
"ANTHROPIC_BASE_URL": "https://ai.megallm.io",
"ANTHROPIC_API_KEY": "your-api-key"
}
}
EOF
# 添加到 shell 配置
echo 'export ANTHROPIC_BASE_URL="https://ai.megallm.io"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="your-api-key"' >> ~/.bashrc
source ~/.bashrc
# 创建目录
mkdir -p ~/.codex
# 创建配置文件
cat > ~/.codex/config.toml << 'EOF'
model_provider = "megallm"
model = "gpt-5"
[model_providers.megallm]
name = "OpenAI using Chat Completions"
base_url = "https://ai.megallm.io/v1"
env_key = "MEGALLM_API_KEY"
query_params = {}
EOF
# 添加到 shell 配置
echo 'export MEGALLM_API_KEY="your-api-key"' >> ~/.bashrc
source ~/.bashrc
# 创建目录
mkdir -p ~/.config/opencode
# 创建配置文件
cat > ~/.config/opencode/opencode.json << 'EOF'
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"anthropic": {
"options": {
"apiKey": "{env:MEGALLM_API_KEY}",
"baseURL": "https://ai.megallm.io/v1"
}
}
}
}
EOF
# 添加到 shell 配置
echo 'export MEGALLM_API_KEY="your-api-key"' >> ~/.bashrc
source ~/.bashrc
配置最佳实践
团队使用项目级配置
将项目特定配置保存在版本控制中(不包含 API 密钥)
保护 API 密钥
永远不要提交 API 密钥。使用 .gitignore 和环境变量
定期备份
CLI 会创建自动备份,但请保留重要配置的副本
下一步
Claude Code 配置
详细的 Claude Code 配置
Codex 配置
详细的 Codex/Windsurf 配置
OpenCode 配置
详细的 OpenCode 配置
