yycode 快速开始指南

前置条件：安装 Node.js 环境

Claude Code 依赖 Node.js 运行环境，请先参考 Node.js 环境安装指南 完成安装并验证。

更省事的方式：自动配置

如果你不想手动安装和逐项写配置，推荐直接使用 自动配置工具。

1. 配置 Claude Code

第一步：安装 Claude Code

npm install -g @anthropic-ai/claude-code

macOS / Linux 遇到权限问题时加 sudo：

sudo npm install -g @anthropic-ai/claude-code

验证安装：

claude --version

第二步：创建 API Key

登录 yycode 控制台，进入 令牌管理 页面，点击 添加令牌。

填写密钥名称，选择分组（模型和倍率），按需配置 IP 限制、额度限制、模型限制和有效期。新手建议直接使用默认配置。

安全提示：API Key 等同于账号凭证，请妥善保管，切勿提交到代码仓库或公开分享。

第三步：导入密钥到 Claude Code

点击密钥旁的 复制 按钮获取 API Key。

需要设置以下两个环境变量：

临时设置（当前终端会话有效）

Windows (PowerShell)：

$env:ANTHROPIC_BASE_URL = "https://yycode.net"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"

macOS / Linux：

export ANTHROPIC_BASE_URL="https://yycode.net"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"

永久设置（重启后依然有效）

Windows (PowerShell)：

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://yycode.net", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_API_KEY", [System.EnvironmentVariableTarget]::User)

macOS (Zsh)：

echo 'export ANTHROPIC_BASE_URL="https://yycode.net"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"' >> ~/.zshrc
source ~/.zshrc

Linux (Bash)：

echo 'export ANTHROPIC_BASE_URL="https://yycode.net"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"' >> ~/.bashrc
source ~/.bashrc

第四步：开始使用

进入任意项目目录，运行：

claude

Claude Code 会自动分析当前目录的代码并提供智能编程辅助。

常见问题（FAQ）

Q：运行 npm install -g 提示权限不足？
A：macOS / Linux 在命令前加 sudo；Windows 使用管理员权限运行 PowerShell。

Q：claude --version 提示命令不存在？
A：确认 npm 全局目录已加入系统 PATH，可运行 npm bin -g 查看路径并手动添加。

Q：连接失败或返回 401 错误？
A：检查 ANTHROPIC_BASE_URL 是否为 https://yycode.net，以及 ANTHROPIC_AUTH_TOKEN 是否填写正确且未过期。

Q：如何切换不同模型或倍率？
A：在 yycode 控制台) 创建不同分组的密钥，通过 CC Switch 在多个配置间快速切换。