Claude Code - VibeCodeCheap

Claude Code 是一个基于终端的编程代理，能够理解您的代码库，并通过自然语言命令帮助您更快地编程——执行日常任务、解释复杂代码并处理 git 工作流。 Claude Code 与编程套餐结合使用会更加强大——Pro 套餐提供的使用量超过 Claude Pro（20 美元/月），Max 套餐提供的使用量超过 Claude Max（200 美元/月）。使用更多 token 和更高的可靠性，更快地编程、更智能地调试、更顺畅地管理工作流。

步骤 1：安装 Claude Code

推荐安装
Cursor 引导安装

要求： Node.js 18 或更新版本

# 安装 Claude Code
npm install -g @anthropic-ai/claude-code

如果您不熟悉 npm 但已安装 Cursor，您可以在 Cursor 中输入命令进行引导安装：

https://docs.anthropic.com/en/docs/claude-code/overview
帮我安装 Claude Code

如果安装过程中遇到权限错误，请尝试使用 sudo（MacOS/Linux）或以管理员身份运行命令提示符（Windows）。

步骤 2：配置编程套餐

获取 API Key

访问 VibeCodeCheap 开放平台，注册或登录。
在 API Keys 页面创建 API Key。
复制 API Key 以供使用。

配置环境变量

有2种配置方式：通过 settings.json 文件（推荐）或通过导出环境变量。

方法1：settings.json 文件（推荐）
方法2：导出环境变量
方法3：使用 --settings 标志

步骤1：找到正确的 settings.json 文件路径

配置文件位于不同操作系统的不同位置：

Windows
macOS
Linux

路径：%USERPROFILE%\.claude\settings.json示例：C:\Users\YourName\.claude\settings.json

路径：~/.claude/settings.json示例：/Users/YourName/.claude/settings.json

路径：~/.claude/settings.json示例：/home/YourName/.claude/settings.json

步骤2：打开 settings.json 进行编辑

选择以下方法之一打开文件：

使用 claude 命令
VS Code
Cursor
Notepad++ / Sublime / Vim
手动打开

# Windows（Git Bash 或 WSL）
claude --settings "$USERPROFILE\.claude\settings.json"

# macOS/Linux
claude --settings ~/.claude/settings.json

此命令将在系统默认编辑器中打开文件。如果不起作用，请尝试下面的其他方法。

# Windows
code "%USERPROFILE%\.claude\settings.json"

# macOS/Linux
code ~/.claude/settings.json

# Windows
cursor "%USERPROFILE%\.claude\settings.json"

# macOS/Linux
cursor ~/.claude/settings.json

# Notepad++（Windows）
notepad++ "%USERPROFILE%\.claude\settings.json"

# Sublime Text
subl ~/.claude/settings.json

# Vim
vim ~/.claude/settings.json

# Nano
nano ~/.claude/settings.json

Windows：

打开文件资源管理器
在地址栏中输入 %USERPROFILE%\.claude
找到 settings.json 并用记事本或任何编辑器打开

macOS/Linux：

打开 Finder/文件管理器
按 Cmd+Shift+G（macOS）或 Ctrl+H 显示隐藏文件
导航到 ~/.claude/
打开 settings.json

步骤3：将配置添加到文件

将 env 字段添加到 settings.json 文件：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your_api_key",
    "ANTHROPIC_BASE_URL": "https://api.vibecodecheap.com/v1/ai",
    "API_TIMEOUT_MS": "3000000"
  }
}

将 your_api_key 替换为您的 VibeCodeCheap API Key 并保存文件。

常见故障排除

打开文件命令不起作用或打开错误的文件

原因：code、cursor 等命令可能不在 PATH 中，或文件在错误的位置打开。解决方案：

验证文件位置：

# Windows（PowerShell）
ls $env:USERPROFILE\.claude\settings.json

# macOS/Linux
ls -la ~/.claude/settings.json

如果文件不存在，创建目录和文件：

# Windows（PowerShell）
mkdir -Force $env:USERPROFILE\.claude
echo '{"env":{}}' > $env:USERPROFILE\.claude\settings.json

# macOS/Linux
mkdir -p ~/.claude
echo '{"env":{}}' > ~/.claude/settings.json

使用绝对路径打开文件：

# Windows
code "C:\Users\YourName\.claude\settings.json"

# macOS
code "/Users/YourName/.claude/settings.json"

保存后配置不生效

检查 JSON 格式：使用 JSONLint 进行验证
关闭所有运行 Claude Code 的终端
打开新终端并再次运行 claude
在 Claude Code 中运行 /status 以验证配置

找不到 .claude 目录

原因：.claude 目录尚未创建，因为 Claude Code 尚未运行。解决方案：

运行一次 claude（可立即退出）

或手动创建：

# Windows
mkdir %USERPROFILE%\.claude

# macOS/Linux
mkdir -p ~/.claude

settings.json 文件被覆盖或丢失配置

原因：Claude Code 在某些情况下可能会自动覆盖 settings.json。解决方案：

备份配置文件：

cp ~/.claude/settings.json ~/.claude/settings.json.backup

锁定文件以防止覆盖（仅在必要时）：

# macOS/Linux
chmod 444 ~/.claude/settings.json

# Windows（PowerShell - 以管理员身份运行）
Set-ItemProperty -Path "$env:USERPROFILE\.claude\settings.json" -Name IsReadOnly -Value $true

需要编辑时解锁：

# macOS/Linux
chmod 644 ~/.claude/settings.json

# Windows（PowerShell）
Set-ItemProperty -Path "$env:USERPROFILE\.claude\settings.json" -Name IsReadOnly -Value $false

WSL：'node: not found' 错误或 Node 版本错误

原因：WSL 使用的是 Windows Node.js 而不是 Linux 版本。检查：

which node
which npm
# 如果结果是 /mnt/c/... 则使用的是 Windows Node

解决方案：

为 Linux 安装 Node.js：

# 使用 nvm（推荐）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install --lts

# 或使用包管理器
sudo apt update
sudo apt install nodejs npm

修复 PATH 优先级 - 添加到 ~/.bashrc 或 ~/.zshrc：

# 确保加载 nvm
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

# 优先使用 Linux 路径
export PATH="$HOME/.local/bin:/usr/local/bin:/usr/bin:$PATH"

应用更改：
```
source ~/.bashrc
```

macOS：编辑文件或运行命令时出现权限错误

原因：macOS 具有 gatekeeper 和 SIP（系统完整性保护）安全机制。解决方案：

允许终端访问文件：
- 打开 系统设置 > 隐私与安全性 > 完全磁盘访问权限
- 添加 Terminal.app 或 iTerm2

修复目录权限：

sudo chown -R $(whoami) ~/.claude
chmod -R u+w ~/.claude

当 settings.json 不起作用或您想快速测试时，此方法很有用。

临时（仅当前终端会话）

# macOS/Linux
export ANTHROPIC_AUTH_TOKEN="your_api_key"
export ANTHROPIC_BASE_URL="https://api.vibecodecheap.com/v1/ai"
export API_TIMEOUT_MS="3000000"
claude

# Windows（PowerShell）
$env:ANTHROPIC_AUTH_TOKEN="your_api_key"
$env:ANTHROPIC_BASE_URL="https://api.vibecodecheap.com/v1/ai"
$env:API_TIMEOUT_MS="3000000"
claude

这些环境变量仅存在于当前终端。关闭终端后，您必须重新导出它们。

永久（每次打开终端时自动加载）

macOS/Linux（Bash）
macOS（Zsh - 默认）
Windows（PowerShell）

添加到 ~/.bashrc 或 ~/.bash_profile：

# 打开文件
nano ~/.bashrc
# 或
nano ~/.bash_profile

# 添加到文件末尾
export ANTHROPIC_AUTH_TOKEN="your_api_key"
export ANTHROPIC_BASE_URL="https://api.vibecodecheap.com/v1/ai"
export API_TIMEOUT_MS="3000000"

# 保存文件（Ctrl+O，Enter，Ctrl+X）

# 应用更改
source ~/.bashrc
# 或
source ~/.bash_profile

添加到 ~/.zshrc：

# 打开文件
nano ~/.zshrc

# 添加到文件末尾
export ANTHROPIC_AUTH_TOKEN="your_api_key"
export ANTHROPIC_BASE_URL="https://api.vibecodecheap.com/v1/ai"
export API_TIMEOUT_MS="3000000"

# 保存文件（Ctrl+O，Enter，Ctrl+X）

# 应用更改
source ~/.zshrc

添加到 PowerShell 配置文件：

# 检查配置文件
notepad $PROFILE

# 如果不存在，创建新文件
New-Item -Path $PROFILE -Type File -Force

# 添加到文件
$env:ANTHROPIC_AUTH_TOKEN="your_api_key"
$env:ANTHROPIC_BASE_URL="https://api.vibecodecheap.com/v1/ai"
$env:API_TIMEOUT_MS="3000000"

# 保存并重新加载
. $PROFILE

验证环境变量是否已设置

# macOS/Linux
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL

# Windows（PowerShell）
echo $env:ANTHROPIC_AUTH_TOKEN
echo $env:ANTHROPIC_BASE_URL

如果 settings.json 在不同位置或您想指定自定义文件。

# 在任意位置创建 settings.json
nano ~/my-claude-config.json

# 添加内容
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your_api_key",
    "ANTHROPIC_BASE_URL": "https://api.vibecodecheap.com/v1/ai",
    "API_TIMEOUT_MS": "3000000"
  }
}

# 使用 --settings 标志运行 claude
claude --settings ~/my-claude-config.json

# 或创建别名以永久使用
# 添加到 ~/.bashrc 或 ~/.zshrc
alias claude-vcc='claude --settings ~/my-claude-config.json'

# 然后只需输入
claude-vcc

步骤 3：开始使用 Claude Code

配置完成后，您可以在终端中开始使用 Claude Code：

cd your-project-directory
claude

如果您使用的是 Windows，首次需要使用 Git Bash 或 Ubuntu (WSL) 运行 claude。

首次运行 Claude Code 时，您可能会看到请求文件访问权限的安全提示：

Do you trust the files in this folder?

 Claude Code may read, write, or execute files contained in this directory. 
 This can pose security risks, so only use files from trusted sources.

 ❯ 1. Yes, proceed
   2. No, exit

选择 “Yes, proceed” 并按 Enter 授予 Claude Code 访问项目目录中文件的权限。

常见问题

如何更改使用的模型

Claude Code 内部模型环境变量与模型的映射关系：

模型	倍率	上下文
`claude-sonnet-4-5`	1x	200K tokens
`claude-sonnet-4-5-20250929`	1x	200K tokens
`claude-opus-4-5-20251101`	2x	200K tokens
`gpt-5-mini`	0x（免费使用）	128K tokens
`glm-4.6`	0x（免费使用）	200K tokens
`glm-4.7`	0x（免费使用）	200K tokens

gpt-5-mini、glm-4.6 和 glm-4.7 是免费使用的模型，订阅 VibeCodeCheap 编程套餐后可无限使用。

如需调整，您可以直接编辑配置文件 ~/.claude/settings.json：

Claude 模型
GPT-5 Mini
GLM 4.6
GLM 4.7

{
  "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5-20250929",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-5-20251101"
  }
}

{
  "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gpt-5-mini",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-5-mini",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gpt-5-mini"
  }
}

{
  "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.6",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.6"
  }
}

{
  "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.7",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.7"
  }
}

如何查看当前模型状态

打开新终端并运行 claude，输入 /help 查看所有可用命令。

输入 /status 查看当前模型状态。
输入 /models 列出所有可用模型。

手动配置不生效

如果您已编辑 ~/.claude/settings.json 文件但更改未生效：

关闭所有 Claude Code 窗口，打开新终端并重新运行 claude。
如果仍不生效，尝试删除 ~/.claude/settings.json 文件并重新配置。
确认 JSON 格式正确，检查变量名称并确保没有缺少或多余的逗号。

​步骤 1：安装 Claude Code

​步骤 2：配置编程套餐

​步骤1：找到正确的 settings.json 文件路径

​步骤2：打开 settings.json 进行编辑

​步骤3：将配置添加到文件

​常见故障排除

​临时（仅当前终端会话）

​永久（每次打开终端时自动加载）

​验证环境变量是否已设置

​步骤 3：开始使用 Claude Code

​常见问题

​如何更改使用的模型

​如何查看当前模型状态

​手动配置不生效

​推荐的 Claude Code 版本

步骤 1：安装 Claude Code

步骤 2：配置编程套餐

步骤1：找到正确的 settings.json 文件路径

步骤2：打开 settings.json 进行编辑

步骤3：将配置添加到文件

常见故障排除

临时（仅当前终端会话）

永久（每次打开终端时自动加载）

验证环境变量是否已设置

步骤 3：开始使用 Claude Code

常见问题

如何更改使用的模型

如何查看当前模型状态

手动配置不生效

推荐的 Claude Code 版本