Claude Code 配置教程
通过 YourAgent 使用 Claude
Opus 4.6,省 95.5%
💡 官方价格 $100 → YourAgent 仅需 $4.5(等值 5000 万 Tokens,省 95.5%)
📋 前置要求
- YourAgent API Key(以
sk-开头)— 联系管理员获取 - Node.js 18+(仅 npm 安装方式需要,原生安装不需要)
- Git(Windows 用户需要先安装 Git)
1安装 Claude Code
方式一:原生安装(推荐 ✅)
无需 Node.js,自动后台更新,始终保持最新版本:
curl -fsSL https://cli.anthropic.com/install.sh | sh
方式二:Homebrew 安装
brew install claude-code
💡 提示:Homebrew 安装可能不会自动更新,建议定期运行
brew upgrade claude-code方式三:npm 安装(需要 Node.js 18+)
npm install -g @anthropic-ai/claude-code
⚠️ Windows 建议:推荐使用 WSL 或 Git
Bash 运行 Claude Code。PowerShell 兼容性较差,可能遇到文件锁定、写入失败等问题。
方式一:原生安装(推荐 ✅)
在 PowerShell 中运行:
irm https://cli.anthropic.com/install.ps1 | iex
方式二:WinGet 安装
winget install Anthropic.ClaudeCode
方式三:npm 安装(需要 Node.js 18+)
npm install -g @anthropic-ai/claude-code
💡 Git 要求:如果没有安装 Git,请先从 git-scm.com 下载安装。建议 Git 2.40+
以避免中文路径问题。
方式一:原生安装(推荐 ✅)
curl -fsSL https://cli.anthropic.com/install.sh | sh
方式二:npm 安装(需要 Node.js 18+)
# Ubuntu/Debian sudo apt install nodejs npm npm install -g @anthropic-ai/claude-code
验证安装成功:
claude --version
2配置 YourAgent API
这是最关键的一步!需要设置 API 中转地址和密钥。
永久配置(推荐)
编辑 ~/.zshrc(或 ~/.bashrc),添加:
export ANTHROPIC_BASE_URL=https://your-agent.cc/api export ANTHROPIC_API_KEY=sk-xxx
保存后运行:
source ~/.zshrc
永久配置(需要管理员权限)
按 Win+X → 终端管理员,运行:
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://your-agent.cc/api", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-xxx", "User")
设置后重新打开终端生效。
⚠️ 重要:将
sk-xxx 替换为你从 YourAgent 管理员处获取的实际 API Key。3清理旧配置(如有)
如果之前配置过其他中转服务,settings.json 中的 env 优先级高于系统环境变量,需要先清理:
# 检查 settings.json cat ~/.claude/settings.json # 如果 settings.json 中有 ANTHROPIC_BASE_URL,需要删除该行 # 或者修改为 YourAgent 的地址
4启动 Claude Code
# 进入你的项目目录 cd ~/your-project # 启动 Claude Code claude
首次启动会进行初始化,稍等片刻即可开始使用。你现在正在使用 Claude Opus 4.6,价格仅为官方的 4.5%!
✅ 验证配置
# 检查环境变量是否生效 echo $ANTHROPIC_BASE_URL # 应该输出: https://your-agent.cc/api echo $ANTHROPIC_API_KEY # 应该输出: sk-xxx (你的密钥)
❓ 常见问题
Q: 提示 API Key 无效?
检查 settings.json 中是否有旧的 ANTHROPIC_BASE_URL 配置覆盖了环境变量。settings.json
的 env 优先级高于系统环境变量。
Q: Windows 上 PowerShell 报错?
建议切换到 WSL 或 Git Bash 运行 Claude Code。PowerShell 兼容性较差。
Q: 如何查询余额?
访问 余额查询页面,输入你的 API Key 即可查看剩余额度。