Inkess LLM
文档中心

Claude Code 配置指南

Claude Code 是 Anthropic 官方的 AI 编程助手 CLI 工具，通过配置环境变量即可接入 Inkess 平台。

还没有安装 Claude Code？请先阅读新手入门指南。

重要：必须使用 ANTHROPIC_AUTH_KEY 环境变量，不能使用 ANTHROPIC_API_KEY。 Claude Code 会优先检查 ANTHROPIC_AUTH_KEY，用于第三方代理认证。

配置方法

macOS / Linux

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

export ANTHROPIC_BASE_URL=https://llm.starapp.net/api/llm
export ANTHROPIC_AUTH_KEY=your-token-here

永久配置（写入 Shell 配置文件）：

echo 'export ANTHROPIC_BASE_URL=https://llm.starapp.net/api/llm' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_KEY=your-token-here' >> ~/.zshrc
source ~/.zshrc

如果使用 Bash，将 ~/.zshrc 替换为 ~/.bashrc。

Windows (PowerShell)

临时配置（当前 PowerShell 会话有效）：

$env:ANTHROPIC_BASE_URL="https://llm.starapp.net/api/llm"
$env:ANTHROPIC_AUTH_KEY="your-token-here"

永久配置（写入用户环境变量）：

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://llm.starapp.net/api/llm", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_KEY", "your-token-here", "User")

配置后重启终端使其生效。

验证配置

claude --version
claude "用中文说一句话"

看到模型响应则配置成功。

常见报错

401 Unauthorized

Token 无效或配置错误。检查：

  • Token 是否正确复制（无多余空格）
  • 确认使用 ANTHROPIC_AUTH_KEY 而非 ANTHROPIC_API_KEY
  • 在控制台令牌页确认 Token 未被禁用

连接被拒绝 / Connection refused

检查 ANTHROPIC_BASE_URL 是否配置正确，完整 URL 为：

https://llm.starapp.net/api/llm

模型不支持

从控制台模型列表页复制正确的模型 ID，注意大小写。