配置概述

配置位置

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`

Codex/Windsurf 仅支持系统级配置

环境变量

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 配置

示例

实用的配置示例

快速入门

配置

指南

配置位置

Claude Code

Codex/Windsurf

OpenCode

配置级别

系统级(全局)

项目级(本地)

环境变量

Claude Code

Codex/Windsurf

OpenCode

验证环境变量

配置优先级

备份文件

工具特定配置

Claude Code 配置

Codex/Windsurf 配置

OpenCode 配置

快速配置检查

验证所有配置

测试 API 连接

手动配置

配置最佳实践

团队使用项目级配置

保护 API 密钥

定期备份

更改后测试

下一步

Claude Code 配置

Codex 配置

OpenCode 配置

示例

​配置位置

Claude Code

Codex/Windsurf

OpenCode

​配置级别

​系统级(全局)

​项目级(本地)

​环境变量

​Claude Code

​Codex/Windsurf

​OpenCode

​验证环境变量

​配置优先级

​备份文件

​工具特定配置

Claude Code 配置

Codex/Windsurf 配置

OpenCode 配置

​快速配置检查

​验证所有配置

​测试 API 连接

​手动配置

​配置最佳实践

团队使用项目级配置

保护 API 密钥

定期备份

更改后测试

​下一步

Claude Code 配置

Codex 配置

OpenCode 配置

示例

配置位置

配置级别

系统级(全局)

项目级(本地)

环境变量

Claude Code

Codex/Windsurf

OpenCode

验证环境变量

配置优先级

备份文件

工具特定配置

快速配置检查

验证所有配置

测试 API 连接

手动配置

配置最佳实践

下一步