Claude Code

Claude Code 是 Anthropic 推出的终端 AI 编程助手，可通过 SilvaMux Coding Plan 接入。

前置准备

1. 购买订阅：在订阅页选择 Lite / Pro / Max 档位与月付/季付/年付周期，购买 Coding Plan 个人版；支付成功后订阅立即生效。
2. 创建订阅 API Key：进入控制台 → Coding Plan → API Keys，点击创建，并立即复制以 cp_live_ 开头的完整 Key。
3. 确认端点与协议：Base URL 为 https://www.silvamux.com/api/coding-plan/v1，兼容 OpenAI 与 Anthropic 两种协议；各端点字段详情见端点与协议。

购买套餐、创建 Key 与验证调用的完整流程见快速接入。

安装 Claude Code

macOS / Linux

1. 安装或更新 Node.js（v18.0 或更高版本）。
2. 在终端中执行以下命令安装 Claude Code。

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

运行以下命令验证安装，若有版本号输出则表示安装成功。

claude --version

Windows

在 Windows 上使用 Claude Code 需要 WSL 或 Git for Windows，然后在 WSL 或 Git Bash 中执行：

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

配置接入凭证

在 Claude Code 中接入 Coding Plan，需要配置以下信息：

• ANTHROPIC_BASE_URL：https://www.silvamux.com/api/coding-plan/v1
• ANTHROPIC_AUTH_TOKEN：cp_live_ 订阅专用 API Key
• ANTHROPIC_MODEL：Coding Plan 支持的模型（如 deepseek-v4-pro）

macOS / Linux

1. 创建并打开配置文件 ~/.claude/settings.json（~ 代表当前系统账户的主目录，.claude 目录不存在时可先用 mkdir -p ~/.claude 创建）。

mkdir -p ~/.claude
nano ~/.claude/settings.json

2. 写入以下配置，将 YOUR_API_KEY 替换为你的 cp_live_ Key。可用模型以 GET /api/coding-plan/v1/models 与模型广场为准。

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://www.silvamux.com/api/coding-plan/v1",
    "ANTHROPIC_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-pro"
  }
}

3. 编辑或新增 ~/.claude.json，将顶层字段 hasCompletedOnboarding 设置为 true，可避免启动时报 Unable to connect to Anthropic services。

{
  "hasCompletedOnboarding": true
}

保存后重新打开一个终端即可生效。

Windows

1. 创建配置目录（PowerShell）：

mkdir -Force $HOME\.claude
notepad $HOME\.claude\settings.json

2. 在打开的 %USERPROFILE%\.claude\settings.json 中写入与 macOS/Linux 相同的 env 配置（Base URL 与 cp_live_ Key 相同）。
3. 编辑或新增 %USERPROFILE%\.claude.json，将顶层字段 hasCompletedOnboarding 设置为 true。

配置上下文窗口大小

Claude Code 默认使用 200K 上下文窗口。若所用模型支持更长上下文，可通过在 ~/.claude/settings.json 的 env 中增加 CLAUDE_CODE_MAX_CONTEXT_TOKENS 扩大窗口：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://www.silvamux.com/api/coding-plan/v1",
    "ANTHROPIC_MODEL": "deepseek-v4-pro",
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "1000000"
  }
}

具体可用的上下文长度由模型决定。

权限模式配置

Claude Code 提供多种权限模式，控制工具执行操作时的确认行为：

使用 --permission-mode 指定本次会话的默认权限模式：

claude --permission-mode plan
claude --permission-mode acceptEdits

也可在会话中输入 /permissions 动态管理预批准与预拒绝规则，或在 ~/.claude/settings.json 中配置 permissions 字段：

{
  "permissions": {
    "allow": ["Bash(git:*)", "Read", "Edit"],
    "deny": ["Bash(rm:*)"],
    "defaultMode": "default"
  }
}

allow 自动批准匹配的工具调用，deny 自动拒绝匹配的工具调用；规则支持通配符。

使用 Claude Code

1. 打开终端并进入项目目录，启动 Claude Code。

cd path/to/your_project
claude

2. 首次启动需要授权 Claude Code 执行文件。
3. 输入 /status 确认模型、Base URL、API Key 是否配置正确。
4. 在 Claude Code 中开始对话。

切换模型

• 启动时切换：claude --model deepseek-v4-pro
• 会话期间切换：输入 /model deepseek-v4-pro

常见命令

更多命令与用法详见 Claude Code 官方文档。

使用 IDE 插件

Claude Code 提供 VS Code 与 JetBrains 系列 IDE 的插件。

VS Code

1. 先完成上方「配置接入凭证」。
2. 打开 VS Code，在扩展市场中搜索 Claude Code for VS Code 并安装。
3. 安装完成后重启 VS Code，点击右上角图标进入 Claude Code 开始对话。若弹出 Anthropic 登录界面，说明配置尚未生效，请先完成配置。

JetBrains

1. 先完成「安装 Claude Code」和「配置接入凭证」。
2. 打开 JetBrains（如 IntelliJ IDEA、PyCharm 等），在扩展市场中搜索 Claude Code 并安装。
3. 安装后重启 IDE，点击右上角图标即可使用，可通过 /model <模型名称> 切换模型。

常见问题

报错 Unable to connect to Anthropic services

表示 Claude Code 尝试连接 Anthropic 官方服务而非 SilvaMux，通常是因为配置未生效：

1. 确认 ~/.claude/settings.json 中 ANTHROPIC_BASE_URL 为 https://www.silvamux.com/api/coding-plan/v1、ANTHROPIC_AUTH_TOKEN 为 cp_live_ Key。
2. 检查 ~/.claude.json 中 hasCompletedOnboarding 是否为 true。
3. 修改配置后重新打开一个新的终端再执行 claude。

调用时返回 401

表示 API Key 与 Base URL 不匹配：Coding Plan 的 cp_live_ Key 必须搭配 https://www.silvamux.com/api/coding-plan/v1，不要使用常规 sk_live_ Key。

调用时返回 429

订阅额度任一窗口耗尽会返回 429 QUOTA_EXCEEDED（错误信息会标明 5h / weekly / monthly）。等待窗口恢复，或在控制台查看剩余额度。

最佳实践

• 上下文管理：使用 /clear 定期重置对话，使用 /compact 压缩历史，用 @ 明确引用文件。
• 先计划再执行：复杂任务先进入 Plan 模式分析方案，确认后再修改文件。
• 沉淀项目知识：在项目根目录维护 CLAUDE.md，记录构建命令、代码规范与工作流。
• 扩展能力：通过 MCP 连接外部服务，用 Skills 沉淀工作流知识。
• 建立自检闭环：要求修改后运行相关测试，并定义明确的成功标准。