首页 教程 Claude Code

Claude Code 配置教程
通过 YourAgent 使用 Claude Opus 4.6,省 95.5%

⏱️ 预计 10 分钟 🖥️ Windows / macOS / Linux 📅 更新于 2026-03-05
💡 官方价格 $100 → YourAgent 仅需 $4.5(等值 5000 万 Tokens,省 95.5%)

📋 前置要求

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 建议:推荐使用 WSLGit 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.jsonenv 优先级高于系统环境变量。

Q: Windows 上 PowerShell 报错?

建议切换到 WSLGit Bash 运行 Claude Code。PowerShell 兼容性较差。

Q: 如何查询余额?

访问 余额查询页面,输入你的 API Key 即可查看剩余额度。