Claude Code 进阶配置

本文介绍 Claude Code 的进阶配置方法，包括多套配置管理、项目级别配置、以及在不同 API 源之间切换的技巧。

💡 前置阅读 如果你还没配置过 Claude Code，请先阅读 Claude Code 快速配置 完成基础设置。

多套配置管理

如果你需要同时使用 KvioAI 中转 API 和 Anthropic 官方 API，或者有多个 KvioAI 的 Key，可以通过以下几种方式管理多套配置。

方式一：使用 alias 别名

在你的 shell 配置文件中定义不同的 alias，按需切换：

nano ~/.bashrc   # 或 ~/.zshrc

添加以下内容：

# KvioAI 中转 API
alias claude-kvio='export ANTHROPIC_BASE_URL="https://kvioai.cloud/v1" && export ANTHROPIC_API_KEY="你的KvioAI_Key" && claude'

# Anthropic 官方 API
alias claude-official='export ANTHROPIC_BASE_URL="https://api.anthropic.com" && export ANTHROPIC_API_KEY="你的官方Key" && claude'

保存后执行 source ~/.bashrc（或 source ~/.zshrc）使其生效。

使用时：

• 运行 claude-kvio → 使用 KvioAI 中转
• 运行 claude-official → 使用官方 API

方式二：使用 .env 文件

Claude Code 支持从项目根目录的 .env 文件读取环境变量。你可以在不同项目中使用不同的配置：

# 在项目 A 中
cd ~/project-a
cat > .env << EOF
ANTHROPIC_BASE_URL=https://kvioai.cloud/v1
ANTHROPIC_API_KEY=你的KvioAI_Key
EOF

# 在项目 B 中
cd ~/project-b
cat > .env << EOF
ANTHROPIC_BASE_URL=https://api.anthropic.com
ANTHROPIC_API_KEY=你的官方Key
EOF

进入对应项目目录后运行 claude，它会自动读取该目录下的 .env 文件。

方式三：使用不同的 settings.json

Claude Code 的配置存储在 ~/.claude/settings.json 中。你可以备份多套配置按需替换：

# 保存当前配置为 kvio 配置
cp ~/.claude/settings.json ~/.claude/settings-kvio.json

# 保存当前配置为 official 配置
cp ~/.claude/settings.json ~/.claude/settings-official.json

切换时复制对应的配置回去：

# 切换到 KvioAI
cp ~/.claude/settings-kvio.json ~/.claude/settings.json

# 切换到官方
cp ~/.claude/settings-official.json ~/.claude/settings.json

关于 Key 格式

从 KvioAI 控制台获取的 Key 是 JSON 数组格式：

[{"_type":"newapi_channel_conn","key":"sk-xxxxx...xxxxx","url":"https://kvioai.cloud"}]

你需要从中提取：

• key 字段的值 → ANTHROPIC_API_KEY
• url 字段加上 /v1 → ANTHROPIC_BASE_URL（即 https://kvioai.cloud/v1）

不要直接复制整个 JSON 字符串，只复制 key 字段的值即可。

项目级别模型选择

Claude Code 支持通过环境变量指定默认使用的模型。在项目 .env 文件中添加：

ANTHROPIC_MODEL=claude-sonnet-4-20250514

不同项目可以指定不同模型，Claude Code 启动时会自动读取。

验证配置

配置完成后，可以用以下方式验证：

# 检查环境变量是否生效
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY

# 启动 Claude Code 后，它会自动连接到配置的 API 地址
claude

如果 Claude Code 正常启动并能够对话，说明配置成功。

常见问题

配置不生效？

• 确认 .env 文件在项目根目录（与 Claude Code 启动目录一致）
• 确认环境变量没有多余的空格或引号
• 确认 ANTHROPIC_BASE_URL 包含 /v1 后缀
• 如果使用 alias，确认已执行 source 使配置生效

如何在同一台电脑上管理多个 KvioAI Key？

推荐用方式一（alias），每个 Key 定义一个独立的 alias，使用时直接调用对应 alias 即可。

可以从 Claude Code 官方配置切换回来吗？

可以。只需把 ANTHROPIC_BASE_URL 改回 https://api.anthropic.com，或取消设置该变量即可。

📱 获取帮助 使用过程中如有问题，请添加微信 xgckck 获取技术支持。