欢迎访问易策 · ZeroToOne，从0到1的成长与探索！

Claude Code 多配置完整安装教程

2026年2月7日 Claude 0 20分钟

Claude Code 多配置完整安装教程

本教程教你如何配置多个独立的 Claude Code 环境，实现官方API和反代API的灵活切换

📋 目录

🎯 前提条件

确保已经安装了 Claude Code：

# 检查是否已安装
claude --version

# 如果没安装，先安装
npm install -g @anthropic-ai/claude-code

🚀 完整安装步骤

第一步：创建配置目录

# 创建两个独立的配置文件夹
mkdir -p ~/.claude-official # 官方API配置
mkdir -p ~/.claude-proxy # 反代/购买的API配置

说明：

  • ~/.claude-official：存放官方API的配置
  • ~/.claude-proxy：存放反代或购买的API配置
  • 可以创建更多目录，比如 ~/.claude-test、~/.claude-backup 等

第二步：分别配置API Key

2.1 配置官方API

CLAUDE_CONFIG_DIR=~/.claude-official claude auth login

提示输入时，粘贴你的官方 Anthropic API Key（格式：sk-ant-xxxxx）

2.2 配置反代API

CLAUDE_CONFIG_DIR=~/.claude-proxy claude auth login

提示输入时，粘贴你的反代/购买的 API Key

2.3 配置反代端点（如需要）

如果你的反代API有自定义地址，需要手动编辑配置文件：

# 编辑反代配置文件
nano ~/.claude-proxy/config.json

修改为：

{
"apiKey": "你的API Key",
"baseURL": "https://你的反代地址/v1"
}

保存退出（Ctrl+O → Enter → Ctrl+X）

第三步：设置快捷命令（永久生效）

3.1 确定你的 Shell 类型

echo $SHELL

结果判断：

  • 显示 /bin/bash → 编辑 ~/.bashrc
  • 显示 /bin/zsh → 编辑 ~/.zshrc（Mac 默认）

3.2 打开配置文件

# Bash 用户
nano ~/.bashrc

# Zsh 用户（Mac）
nano ~/.zshrc

3.3 添加快捷命令

在文件最后添加以下内容：

# ========== Claude Code 多配置 ==========

# 官方API（带权限确认，更安全）
alias co='CLAUDE_CONFIG_DIR=~/.claude-official claude'

# 反代API（跳过权限确认，全自动）
alias cp='CLAUDE_CONFIG_DIR=~/.claude-proxy claude --dangerously-skip-permissions'

# 可选：如果官方也想跳过权限确认
# alias co='CLAUDE_CONFIG_DIR=~/.claude-official claude --dangerously-skip-permissions'

自定义命名：你可以改成任何喜欢的名字，例如：

# 用数字
alias c1='CLAUDE_CONFIG_DIR=~/.claude-official claude'
alias c2='CLAUDE_CONFIG_DIR=~/.claude-proxy claude --dangerously-skip-permissions'

# 用中文拼音
alias gf='CLAUDE_CONFIG_DIR=~/.claude-official claude'
alias fd='CLAUDE_CONFIG_DIR=~/.claude-proxy claude --dangerously-skip-permissions'

# 用全称
alias claude-official='CLAUDE_CONFIG_DIR=~/.claude-official claude'
alias claude-proxy='CLAUDE_CONFIG_DIR=~/.claude-proxy claude --dangerously-skip-permissions'

3.4 保存并生效

保存文件：

  • 按 Ctrl + O 保存
  • 按 Enter 确认
  • 按 Ctrl + X 退出

让配置生效：

# Bash 用户
source ~/.bashrc

# Zsh 用户
source ~/.zshrc

第四步：验证安装

# 1. 查看快捷命令是否生效
alias | grep claude

# 应该看到类似输出：
# co='CLAUDE_CONFIG_DIR=~/.claude-official claude'
# cp='CLAUDE_CONFIG_DIR=~/.claude-proxy claude --dangerously-skip-permissions'

# 2. 测试官方API
co "你好，介绍一下你自己"

# 3. 测试反代API
cp "你好，今天是几号？"

如果都能正常回复，说明配置成功！✅

🔧 权限说明

--dangerously-skip-permissions 参数详解

作用：跳过所有文件操作的权限确认提示

不带参数（默认行为）

co "读取 config.json 文件并分析"

会提示：

⚠️ Allow reading config.json? (y/n)
⚠️ Allow writing to output.txt? (y/n)

每个文件操作都需要手动确认。

带参数（自动通过）

cp "读取 config.json 文件并分析"

直接执行，不会有任何提示，自动允许所有操作。

推荐配置策略

# 官方API：保留权限确认（更安全，适合不确定的操作）
alias co='CLAUDE_CONFIG_DIR=~/.claude-official claude'

# 反代API：跳过权限确认（提高效率，适合自动化任务）
alias cp='CLAUDE_CONFIG_DIR=~/.claude-proxy claude --dangerously-skip-permissions'

或者两个都跳过（如果你完全信任）：

alias co='CLAUDE_CONFIG_DIR=~/.claude-official claude --dangerously-skip-permissions'
alias cp='CLAUDE_CONFIG_DIR=~/.claude-proxy claude --dangerously-skip-permissions'

📝 日常使用

基本命令

# 用官方API询问问题
co "Python 如何读取 JSON 文件？"

# 用反代API处理项目
cp "分析这个项目的代码结构"

文件操作

# 读取文件
co "读取 data.csv 并统计行数"

# 创建文件
cp "创建一个 Python 爬虫脚本保存为 spider.py"

# 修改文件
cp "优化 app.py 的性能"

项目级操作

# 进入项目目录
cd /path/to/your/project

# 分析整个项目
cp "分析这个项目，生成技术文档"

# 重构代码
cp "重构所有 Python 文件，添加类型注解"

# 批量处理
cp "给所有 .js 文件添加 JSDoc 注释"

自动化脚本示例

# 定时任务：每天自动生成报告
cp "读取 logs/ 目录下的所有日志，生成今日错误报告"

# 代码审查
cp "审查最近修改的代码，指出潜在问题"

# 文档生成
cp "扫描所有源代码，自动生成 API 文档"

🗂️ 配置文件位置

# 官方API配置目录
~/.claude-official/
├── config.json # API Key 和配置
└── history/ # 对话历史

# 反代API配置目录
~/.claude-proxy/
├── config.json # API Key 和配置
└── history/ # 对话历史

查看配置内容

# 查看官方API配置
cat ~/.claude-official/config.json

# 查看反代API配置
cat ~/.claude-proxy/config.json

# 查看对话历史
ls ~/.claude-official/history/
ls ~/.claude-proxy/history/

🔍 故障排查

问题1：输入 co 或 cp 提示命令不存在

原因：配置文件未加载

解决：

# 重新加载配置
source ~/.bashrc # 或 source ~/.zshrc

# 检查是否添加成功
cat ~/.bashrc | grep claude

# 如果没有内容，重新添加
nano ~/.bashrc # 按教程第三步操作

问题2：提示 API Key 无效

原因：API Key 错误或过期

解决：

# 重新登录官方API
CLAUDE_CONFIG_DIR=~/.claude-official claude auth login

# 重新登录反代API
CLAUDE_CONFIG_DIR=~/.claude-proxy claude auth login

# 检查配置是否正确
cat ~/.claude-proxy/config.json

问题3：反代API连接失败

原因：未配置正确的反代地址

解决：

# 编辑配置文件
nano ~/.claude-proxy/config.json

# 确保格式正确
{
"apiKey": "sk-ant-xxxxx",
"baseURL": "https://your-proxy-domain.com/v1"
}

# 保存后测试
cp "测试连接"

问题4：权限被拒绝

现象：提示 Permission denied

解决：

# 方案1：添加 --dangerously-skip-permissions
cp "操作文件"

# 方案2：手动确认每个权限
co "操作文件" # 然后逐个输入 y 确认

💡 最佳实践

推荐配置方案

# ~/.bashrc 或 ~/.zshrc 中添加：

# 1. 官方API - 日常小任务，保留权限确认
alias co='CLAUDE_CONFIG_DIR=~/.claude-official claude'

# 2. 反代API - 大型项目，自动化执行
alias cp='CLAUDE_CONFIG_DIR=~/.claude-proxy claude --dangerously-skip-permissions'

# 3. 快速查看当前配置
alias cconfig='cat ~/.claude-official/config.json && cat ~/.claude-proxy/config.json'

# 4. 查看历史记录
alias chist='ls -lh ~/.claude-official/history/ && ls -lh ~/.claude-proxy/history/'

使用场景建议

场景 推荐命令 原因
快速提问 co 官方API稳定，小任务不消耗太多
代码审查 cp 反代无限制，可以深度分析
批量处理 cp 自动化操作，跳过权限确认
学习教程 co 权限确认能学到文件操作流程
生产项目 cp 高效处理，无中断

安全建议

  1. 不要在公共目录使用 --dangerously-skip-permissions
  2. 定期检查 ~/.claude-*/history/ 目录，删除敏感对话
  3. API Key 保密，不要分享配置文件
  4. 反代API 仅用于自己信任的服务

⚡ 一键安装脚本（可选）

如果你想一次性完成所有配置，可以使用这个自动化脚本。

创建安装脚本

创建文件 setup-claude.sh：

#!/bin/bash

echo "🚀 开始配置 Claude Code 多环境..."

# 1. 创建目录
echo "📁 创建配置目录..."
mkdir -p ~/.claude-official ~/.claude-proxy

# 2. 检测 Shell 类型
if [[ "$SHELL" == *"zsh"* ]]; then
CONFIG_FILE="$HOME/.zshrc"
elif [[ "$SHELL" == *"bash"* ]]; then
CONFIG_FILE="$HOME/.bashrc"
else
echo "⚠️ 未知的 Shell 类型: $SHELL"
exit 1
fi

echo "📝 使用配置文件: $CONFIG_FILE"

# 3. 添加快捷命令
if grep -q "Claude Code 多配置" "$CONFIG_FILE"; then
echo "⚠️ 配置已存在，跳过添加"
else
echo "✏️ 添加快捷命令到 $CONFIG_FILE..."
cat >> "$CONFIG_FILE" << 'EOF'

# ========== Claude Code 多配置 ==========
alias co='CLAUDE_CONFIG_DIR=~/.claude-official claude'
alias cp='CLAUDE_CONFIG_DIR=~/.claude-proxy claude --dangerously-skip-permissions'
EOF
fi

# 4. 生效配置
source "$CONFIG_FILE"

echo ""
echo "✅ 配置完成！"
echo ""
echo "📌 下一步："
echo "1. 配置官方API："
echo " CLAUDE_CONFIG_DIR=~/.claude-official claude auth login"
echo ""
echo "2. 配置反代API："
echo " CLAUDE_CONFIG_DIR=~/.claude-proxy claude auth login"
echo ""
echo "3. 开始使用："
echo " co \"你好\" # 使用官方API"
echo " cp \"你好\" # 使用反代API"
echo ""

运行安装脚本

# 1. 保存上面的内容为文件
nano setup-claude.sh
# 粘贴内容，保存退出

# 2. 添加执行权限
chmod +x setup-claude.sh

# 3. 运行脚本
./setup-claude.sh

# 4. 按提示配置 API Key
CLAUDE_CONFIG_DIR=~/.claude-official claude auth login
CLAUDE_CONFIG_DIR=~/.claude-proxy claude auth login

# 5. 重新加载配置
source ~/.bashrc # 或 source ~/.zshrc

📚 常见问题 FAQ

Q1: 可以创建3个或更多配置吗？

可以！ 例如：

# 创建目录
mkdir -p ~/.claude-test ~/.claude-backup

# 登录
CLAUDE_CONFIG_DIR=~/.claude-test claude auth login

# 添加快捷命令
alias ct='CLAUDE_CONFIG_DIR=~/.claude-test claude'
alias cb='CLAUDE_CONFIG_DIR=~/.claude-backup claude'

Q2: 如何删除某个配置？

# 删除配置目录
rm -rf ~/.claude-proxy

# 从 ~/.bashrc 中删除对应的 alias 行
nano ~/.bashrc # 手动删除

# 重新加载
source ~/.bashrc

Q3: 如何查看当前用的是哪个配置？

# 方案1：添加辅助命令
alias cwhich='echo "Official: $(test -f ~/.claude-official/config.json && echo OK || echo NO)" && echo "Proxy: $(test -f ~/.claude-proxy/config.json && echo OK || echo NO)"'

# 方案2：直接查看
cat ~/.claude-official/config.json
cat ~/.claude-proxy/config.json

Q4: 反代API如何配置自定义模型？

编辑配置文件：

nano ~/.claude-proxy/config.json

修改为：

{
"apiKey": "sk-ant-xxxxx",
"baseURL": "https://your-proxy.com/v1",
"model": "claude-sonnet-4-20250514"
}

Q5: 如何备份配置？

# 备份整个配置目录
tar -czf claude-config-backup.tar.gz ~/.claude-official ~/.claude-proxy

# 恢复
tar -xzf claude-config-backup.tar.gz -C ~/

🎉 总结

完成本教程后，你将拥有：

✅ 多个独立的 Claude Code 配置
✅ 灵活切换官方API和反代API
✅ 自动化权限管理，提高效率
✅ 完整的故障排查能力

核心命令回顾：

# 官方API（带权限确认）
co "你的问题或任务"

# 反代API（自动执行）
cp "你的问题或任务"

📞 获取帮助

教程制作时间：2025年2月
适用版本：Claude Code 最新版
作者：Claude Assistant

附录：完整示例配置文件

~/.bashrc 或 ~/.zshrc 完整示例

# ========== Claude Code 多配置 ==========

# 基础配置
alias co='CLAUDE_CONFIG_DIR=~/.claude-official claude'
alias cp='CLAUDE_CONFIG_DIR=~/.claude-proxy claude --dangerously-skip-permissions'

# 辅助工具
alias cconfig='echo "=== Official ===" && cat ~/.claude-official/config.json && echo "" && echo "=== Proxy ===" && cat ~/.claude-proxy/config.json'
alias chist='echo "=== Official History ===" && ls -lh ~/.claude-official/history/ && echo "" && echo "=== Proxy History ===" && ls -lh ~/.claude-proxy/history/'
alias cclean='rm -rf ~/.claude-official/history/* ~/.claude-proxy/history/* && echo "✅ History cleaned"'

# 快速切换
export CLAUDE_DEFAULT='proxy' # 默认使用哪个配置
alias c='cp' # 默认快捷命令指向反代

# 环境变量（可选）
export CLAUDE_OFFICIAL_KEY='sk-ant-xxxxx' # 如果需要
export CLAUDE_PROXY_KEY='sk-ant-xxxxx' # 如果需要

祝使用愉快！🚀

​

版权声明

本文作者：易策 · ZeroToOne

本文链接：https://yicego.com/claude/260.html

版权声明：本站所有文章除特别声明外，均采用 CC BY-NC-SA 4.0 许可协议。转载请注明出处！

评论