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
这是最关键的一步!直接编辑 Claude Code 的配置文件 settings.json,填入 API 地址和密钥。
方式一:编辑 settings.json(推荐 ✅)
settings.json 的优先级高于环境变量,是最可靠的配置方式。
编辑 ~/.claude/settings.json:
nano ~/.claude/settings.json
填入以下内容:
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
"ANTHROPIC_BASE_URL": "https://your-agent.cc/api"
},
"model": "opus",
"naturalLang": {
"command": "coline",
"type": "command"
}
}
编辑 %USERPROFILE%\.claude\settings.json:
notepad %USERPROFILE%\.claude\settings.json
填入以下内容:
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
"ANTHROPIC_BASE_URL": "https://your-agent.cc/api"
},
"model": "opus",
"naturalLang": {
"command": "coline",
"type": "command"
}
}
⚠️ 重要:将
sk-你的密钥 替换为你从 YourAgent 管理员处获取的实际 API Key。settings.json 中的 env 优先级高于系统环境变量。💡 提示:如果
~/.claude/ 目录不存在,先运行一次 claude 命令让它自动创建,或者手动 mkdir -p ~/.claude。方式二:使用环境变量
如果更喜欢命令行方式,也可以在 ~/.zshrc(或 ~/.bashrc)中添加:
export ANTHROPIC_BASE_URL=https://your-agent.cc/api export ANTHROPIC_API_KEY=sk-你的密钥
保存后运行 source ~/.zshrc 生效。
3启动 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 即可查看剩余额度。