Claude Code

本文介绍 Claude Code (CLI) 的具体使用方法。

安装¶

推荐使用 npm 安装，便于灵活调整版本，同时也能避免被阻止下载：

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

当然如果你的 IP 不在受限区域，可以直接运行官方下载脚本：

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

配置¶

跳过初始登录¶

编辑 ~/.claude.json 文件，新增以下字段来跳过初始登录：

{
    "hasCompletedOnboarding": true
}

配置个人端点¶

在实际使用场景中，Claude Code CLI 的配置级别主要分「用户级」和「项目级」两种。

对于用户级配置，例如整个机器都属于你（个人 PC 或个人服务器等），直接编辑 ~/.claude/settings.json 即可：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxx",
    "ANTHROPIC_BASE_URL": "https://api.example.com/",
    "ANTHROPIC_MODEL": "gpt-5.5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gpt-5.5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gemini-3.1-pro-preview",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-pro",
    "CLAUDE_CODE_SUBAGENT_MODEL": "gpt-5.5",
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "262144",
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "90",
    "DISABLE_AUTOUPDATER": "1"
  },
  "permissions": {
    "allow": [
      "Bash(npm install *)",
      "Bash(node *)",
      "Bash(npm *)",
      "Bash(git *)",
      "Bash(python -)",
      "Bash(rg *)",
      "Bash(timeout 30 bash *)",
      "Read(//tmp/**)"
    ],
    "defaultMode": "auto"
  },
  "model": "gpt-5.5",
  "effortLevel": "xhigh",
  "theme": "auto",
  "editorMode": "normal",
  "verbose": true,
  "skipAutoPermissionPrompt": true,
  "useAutoModeDuringPlan": true
}

对于项目级配置，例如很多人共享一台服务器。需要在项目根目录编辑 .claude/settings.json，配置内容和上述几乎一致，唯一的区别是不要写 ANTHROPIC_AUTH_TOKEN 字段，因为明文存储 API 密钥是非常危险的，建议每次启动 Claude Code CLI 之前都将 ANTHROPIC_AUTH_TOKEN 作为环境变量输入终端。虽然麻烦了一点，但是可以确保 API 密钥绝对安全：

# 启动方法一
export ANTHROPIC_AUTH_TOKEN="sk-xxx"
claude

# 启动方法二
ANTHROPIC_AUTH_TOKEN="sk-xxx" claude

使用¶

TODO