新手入门：从零开始使用 Claude Code
本指南帮助你从零开始安装 Claude Code CLI 并接入 Inkess 平台，全程约 5 分钟。
前提条件
开始之前，请确保你已经：
- 注册了 Inkess LLM 账号 — 点击注册
- 创建了 API Token — 进入控制台 → 令牌页 → 创建令牌，获得形如
ik-xxxxxxxx...的 Token - 账户有余额 — 进入控制台 → 充值页，微信扫码充值（最低 ¥1）
第一步：安装 Claude Code CLI
macOS
方式一：原生安装器（推荐）
打开终端（Terminal），执行：
curl -fsSL https://claude.ai/install.sh | bash
安装完成后会自动将 claude 命令加入 PATH。
方式二：Homebrew
brew install --cask claude-code
注意：Homebrew 安装不会自动更新，需手动
brew upgrade claude-code。
验证安装：
claude --version
看到版本号输出即安装成功。
Windows
方式一：原生安装器（推荐）
- 先安装 Git for Windows（Claude Code 依赖 git）
- 打开 PowerShell（非 CMD），执行：
irm https://claude.ai/install.ps1 | iex
- 关闭并重新打开 PowerShell（必须，新的 PATH 才会生效）
验证安装：
claude --version
常见问题：如果提示
claude 不是内部或外部命令，说明 PATH 未生效。请参考下方排查指南。
方式二：WSL2（适合开发者）
如果你已有 WSL2 + Ubuntu 环境，可以在 WSL 中使用 Linux 安装方式：
curl -fsSL https://claude.ai/install.sh | bash
Linux
打开终端，执行：
curl -fsSL https://claude.ai/install.sh | bash
安装完成后重新打开终端或执行 source ~/.bashrc。
验证安装：
claude --version
第二步：配置 Inkess API
安装好 Claude Code 后，需要配置它连接 Inkess 平台。有两种方式：
方式一：CC Switch（推荐，图形界面）
CC Switch 是一款跨平台桌面工具（支持 macOS / Windows / Linux），可以在多个 API 配置之间一键切换，无需手动设置环境变量。
安装 CC Switch：
- macOS：
brew tap farion1231/ccswitch && brew install --cask cc-switch - Windows / Linux：从 GitHub Releases 下载安装包
添加 Inkess 配置：
- 打开 CC Switch
- 点击「Add Provider」
- 填写：
| 字段 | 填写内容 |
|---|---|
| Provider Name | Inkess LLM |
| API Type | Anthropic Compatible |
| API Base URL | https://llm.starapp.net/api/llm |
| API Key | 你的 Token（ik-...） |
- 保存后选择 Inkess 配置，点击切换即可
详细说明请参考 CC Switch 配置指南。
方式二：手动设置环境变量
如果不想装额外工具，可以直接设置两个环境变量：
ANTHROPIC_BASE_URL— API 端点地址ANTHROPIC_AUTH_KEY— 你的 Token
⚠️ 重要：必须使用
ANTHROPIC_AUTH_KEY，不是ANTHROPIC_API_KEY。这是 Claude Code 识别第三方代理的专用变量。
macOS / Linux
临时配置（当前终端有效）：
export ANTHROPIC_BASE_URL=https://llm.starapp.net/api/llm
export ANTHROPIC_AUTH_KEY=ik-你的token
永久配置（写入 Shell 配置文件）：
echo 'export ANTHROPIC_BASE_URL=https://llm.starapp.net/api/llm' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_KEY=ik-你的token' >> ~/.zshrc
source ~/.zshrc
如果你使用 Bash，将
~/.zshrc替换为~/.bashrc。
Windows PowerShell
临时配置（当前 PowerShell 有效）：
$env:ANTHROPIC_BASE_URL="https://llm.starapp.net/api/llm"
$env:ANTHROPIC_AUTH_KEY="ik-你的token"
永久配置（写入用户环境变量）：
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://llm.starapp.net/api/llm", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_KEY", "ik-你的token", "User")
设置后必须关闭并重新打开 PowerShell 才能生效。
Windows CMD
setx ANTHROPIC_BASE_URL "https://llm.starapp.net/api/llm"
setx ANTHROPIC_AUTH_KEY "ik-你的token"
设置后关闭并重新打开 CMD。
第三步：验证并开始使用
配置完成后，运行以下命令验证连接：
claude "用中文说一句话"
看到模型回复即表示配置成功！🎉
基本使用
# 进入项目目录，启动 Claude Code
cd your-project
claude
# 直接提问
claude "解释这段代码的作用"
# 查看帮助
claude --help
推荐模型
| 模型 | 特点 | 适合场景 |
|---|---|---|
claude-sonnet-4-5 |
性价比高，速度快 | 日常编程、代码审查 |
claude-opus-4-5 |
最强推理能力 | 复杂架构设计、深度分析 |
claude-haiku-4-5 |
极速响应，价格最低 | 简单问答、快速补全 |
常见问题排查
Windows PATH 问题
现象：安装后提示 claude 不是内部或外部命令 或 无法将 claude 识别为 cmdlet
解决方法：
- 首先尝试：关闭所有终端窗口，重新打开 PowerShell
- 如果仍然不行，手动添加 PATH：
# 检查安装路径
Test-Path "$env:USERPROFILE\.local\bin\claude.exe"
# 临时添加 PATH（当前会话）
$env:PATH = "$env:USERPROFILE\.local\bin;$env:PATH"
# 永久添加 PATH
[Environment]::SetEnvironmentVariable("PATH", "$env:USERPROFILE\.local\bin;$([Environment]::GetEnvironmentVariable('PATH', 'User'))", "User")
- 重新打开 PowerShell 验证：
claude --version
401 Unauthorized
Token 无效或配置错误。逐项检查：
- Token 是否完整复制（无多余空格，以
ik-开头） - 环境变量名是否为
ANTHROPIC_AUTH_KEY（不是ANTHROPIC_API_KEY） - 在控制台令牌页确认 Token 未被禁用
连接超时 / Connection refused
- 确认
ANTHROPIC_BASE_URL为https://llm.starapp.net/api/llm（注意是 https，不是 http） - 如果使用公司网络，检查是否有防火墙拦截
- 尝试在浏览器访问
https://llm.starapp.net/api/llm/health确认服务可达
环境变量不生效
- macOS / Linux：运行
echo $ANTHROPIC_AUTH_KEY检查是否有值。如果为空，运行source ~/.zshrc（或~/.bashrc） - Windows：运行
echo $env:ANTHROPIC_AUTH_KEY（PowerShell）检查。永久设置后必须重新打开新的终端窗口 - CC Switch 用户：切换配置后需重新打开终端
余额不足 (402)
账户余额为 0 或以下。进入控制台充值页充值后即可恢复使用。