Claude Code 配置指南

以下配置以默认端点 iina.ai 为例，如需使用国内加速端点，请将 iina.ai 替换为 acc.iina.ai。

安装 Claude Code Cli

Homebrew

# 安装
brew install --cask claude-code

# 卸载
brew uninstall --cask claude-code

macOS, Linux, WSL

# 安装
curl -fsSL https://claude.ai/install.sh | bash

# 卸载
claude uninstall

Windows (PowerShell)

# 安装
irm https://claude.ai/install.ps1 | iex

# 卸载
claude uninstall

配置 API 密钥

1. 获取 API 密钥: 登录控制台新建令牌，建议留空 模型限制列表 以支持所有模型。

2. 修改配置:

   ~/.claude/settings.json

   {
     "$schema": "https://json.schemastore.org/claude-code-settings.json",
     "env": {
       "ANTHROPIC_AUTH_TOKEN": "<API_KEY>",
       "ANTHROPIC_BASE_URL": "https://iina.ai",
       "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
     },
     "includeCoAuthoredBy": false
   }

   ~/.claude/config.json

   {
     "primaryApiKey": "iina"
   }

使用 Claude Code

配置完成后，可以通过以下命令使用 Claude Code：

# 交互式对话
claude

# 检查更新
claude update

# 安装 context7 mcp (需单独注册 context7 账户并获取 API 密钥)
claude mcp add --scope user --transport http context7 https://mcp.context7.com/mcp --header "CONTEXT7_API_KEY: YOUR_CONTEXT7_API_KEY"

开启 1M 上下文

默认情况下，claude-opus-4-6 和 claude-sonnet-4-5-20250929 使用 200K 上下文，在 Claude Code 中使用 /model opus[1m] 或 /model sonnet[1m] 命令开启 1M 上下文支持。

与 IDE 集成

推荐安装 IDE 插件以提升使用体验：

• Visual Studio Code：安装 Claude Code for VS Code 插件。
• JetBrains 系列：安装 Claude Code [Beta] 插件。

更多使用详情请参考 Claude Code 官方中文文档。

在 VSCode Sidebar 中使用 Claude Code

前提条件:

• Visual Studio Code 1.97+
• Claude Code v2.0.56+
• VSCode Extension v2.0.56+

设置步骤:

1. 打开 VSCode 设置，搜索 @ext:Anthropic.claude-code，将 Claude Code: Preferred Location 设置为 sidebar。
2. 点击右上角 Claude 图标，即可在侧边栏使用 Claude Code，默认为左侧边栏（Primary Side Bar），使用右键点击 Claude 图标选择移动到右侧边栏（Secondary Side Bar）。

提示缓存

在 Claude Code 中使用模型，可能会对 API 费用产生疑问，这主要是提示缓存导致的价格差异，当 Claude Code 将某些输入内容写入缓存时，IINA 会对写入和读取缓存的内容分别计费，具体价格请参考官方，阅读文档理解提示缓存。

可通过添加以下环境变量禁用提示缓存：

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "DISABLE_PROMPT_CACHING": "1", // 禁用所有模型的提示缓存
    "DISABLE_PROMPT_CACHING_HAIKU": "1", // 禁用 haiku 模型的提示缓存
    "DISABLE_PROMPT_CACHING_OPUS": "1", // 禁用 opus 模型的提示缓存
    "DISABLE_PROMPT_CACHING_SONNET": "1", // 禁用 sonnet 模型的提示缓存
    ...
  },
  ...
}