主题
Claude Code 配置教程
Claude Code 是 Anthropic 官方推出的 AI 编程助手，原生使用 Anthropic API。通过源力AI 中转，你可以更稳定、更经济地使用 Claude Code。
适用场景
源力AI 中转适合：国内网络环境稳定访问、需要统一管理 API 消费、享受更优惠的定价。
配置方式
Claude Code 支持三种配置方式，推荐按顺序优先使用：
- 环境变量（最简单，推荐开发环境）
- CLI 参数（临时覆盖，适合测试）
- settings.json 配置文件（持久化，适合长期使用）
方式一：环境变量配置（推荐）
临时配置（当前终端会话）
bash
export ANTHROPIC_BASE_URL="https://bww.letcareme.com"
export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"
# 验证配置
claude --version永久配置（写入 shell 配置文件）
Bash 用户（~/.bashrc 或 ~/.bash_profile）：
bash
echo 'export ANTHROPIC_BASE_URL="https://bww.letcareme.com"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"' >> ~/.bashrc
source ~/.bashrcZsh 用户（~/.zshrc）：
bash
echo 'export ANTHROPIC_BASE_URL="https://bww.letcareme.com"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"' >> ~/.zshrc
source ~/.zshrcWindows PowerShell（用户级别永久生效）：
powershell
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://bww.letcareme.com", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-xxxxxxxxxxxxxxxxxxxxxxxx", "User")Windows CMD（系统级别）：
cmd
setx ANTHROPIC_BASE_URL "https://bww.letcareme.com"
setx ANTHROPIC_API_KEY "sk-xxxxxxxxxxxxxxxxxxxxxxxx"Windows 设置后需要重新打开终端窗口才能生效。
也支持 OPENAI 格式变量
部分 Claude Code 版本同时读取 OpenAI 格式的环境变量：
bash
export OPENAI_BASE_URL="https://bww.letcareme.com/v1"
export OPENAI_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"变量优先级
ANTHROPIC_API_KEY > OPENAI_API_KEY，建议同时设置两组，保证兼容性。
方式二：CLI 参数（临时使用）
在启动 Claude Code 时直接传入参数：
bash
# 指定 API Key
claude --api-key sk-xxxxxxxxxxxxxxxxxxxxxxxx
# 指定 Base URL（如果支持该参数）
claude --base-url https://bww.letcareme.com
# 组合使用
ANTHROPIC_API_KEY=sk-xxx ANTHROPIC_BASE_URL=https://bww.letcareme.com claude方式三：settings.json 配置文件
Claude Code 的持久化配置文件位于：
| 平台 | 路径 |
|---|---|
| macOS / Linux | ~/.claude/settings.json |
| Windows | C:\Users\<用户名>\.claude\settings.json |
配置文件格式
编辑或创建 ~/.claude/settings.json：
json
{
"env": {
"ANTHROPIC_API_KEY": "sk-xxxxxxxxxxxxxxxxxxxxxxxx",
"ANTHROPIC_BASE_URL": "https://bww.letcareme.com"
}
}安全提示
settings.json 中包含 API Key 明文，确保：
- 不要将此文件提交到 Git 仓库
- 检查
~/.gitignore_global是否已排除.claude/目录 - 定期轮换 API Key
完整 settings.json 示例
json
{
"env": {
"ANTHROPIC_API_KEY": "sk-xxxxxxxxxxxxxxxxxxxxxxxx",
"ANTHROPIC_BASE_URL": "https://bww.letcareme.com"
},
"model": "claude-3-5-sonnet-20241022",
"theme": "dark"
}Windows 路径操作
powershell
# 创建 .claude 目录（如果不存在）
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude"
# 创建或编辑 settings.json
notepad "$env:USERPROFILE\.claude\settings.json"在记事本中粘贴以下内容并保存：
json
{
"env": {
"ANTHROPIC_API_KEY": "sk-xxxxxxxxxxxxxxxxxxxxxxxx",
"ANTHROPIC_BASE_URL": "https://bww.letcareme.com"
}
}验证配置是否生效
配置完成后，启动 Claude Code 并发送测试消息：
bash
claude在对话中输入：
你好，请告诉我你是什么模型？如果能正常收到回复，说明通过源力AI 中转配置成功。
也可以通过以下命令检查环境变量是否正确加载：
bash
# Linux / macOS
echo $ANTHROPIC_API_KEY
echo $ANTHROPIC_BASE_URL
# Windows PowerShell
echo $env:ANTHROPIC_API_KEY
echo $env:ANTHROPIC_BASE_URL使用推荐模型
通过源力AI 中转，Claude Code 可以使用以下 Claude 模型：
| 模型 ID | 适用场景 |
|---|---|
claude-3-5-sonnet-20241022 | 默认推荐，代码能力最强 |
claude-3-5-haiku-20241022 | 快速响应，日常轻量任务 |
claude-3-opus-20240229 | 复杂推理，深度代码分析 |
在 settings.json 中通过 model 字段指定默认模型：
json
{
"model": "claude-3-5-sonnet-20241022",
"env": {
"ANTHROPIC_API_KEY": "sk-xxxxxxxxxxxxxxxxxxxxxxxx",
"ANTHROPIC_BASE_URL": "https://bww.letcareme.com"
}
}常见问题
Q: 配置后提示 "Authentication Error"
A: 按以下顺序排查：
- 确认
ANTHROPIC_API_KEY的值以sk-开头 - 确认
ANTHROPIC_BASE_URL为https://bww.letcareme.com（不带/v1） - 在终端重新
source ~/.bashrc（或重开终端窗口） - 确认源力AI 账户余额充足
Q: 环境变量设置了但不生效
A: 常见原因是终端未重新加载配置：
bash
# 重新加载 bashrc
source ~/.bashrc
# 或直接在当前会话设置
export ANTHROPIC_API_KEY="sk-xxx"Q: settings.json 和环境变量同时存在，哪个优先？
A: 环境变量优先级高于 settings.json。如果你希望 settings.json 生效，需要确保没有同名的环境变量覆盖它。
Q: 使用源力AI 后会影响 Claude Code 的功能吗
A: 不会。源力AI 完整转发所有 API 请求和响应，Claude Code 的所有功能（代码补全、对话、文件读写等）均正常工作。
Q: 如何在多个项目中使用不同的 API Key
A: 可以在项目根目录创建 .env 文件（确保加入 .gitignore）：
bash
# 项目根目录的 .env
ANTHROPIC_API_KEY=sk-project-specific-key
ANTHROPIC_BASE_URL=https://bww.letcareme.com然后在启动 Claude Code 前加载：
bash
source .env && claude