Home

深色模式

Claude Code 配置与使用说明 ​

简单介绍 ​

Claude Code 是一个在终端里使用的编码助手。日常真正高频的内容主要就两块：配置和使用。安装与登录只要跑通一次即可：

sh
brew install --cask claude-code
claude
claude auth login
claude auth status --text

如果已经准备好 Claude 账号、Anthropic Console API 或云厂商接入方式，后面重点就可以直接放在配置文件和命令使用上。

配置方法 ​

Claude Code 最常用的配置入口有三个：

  • ~/.claude/settings.json：用户级配置，对所有项目生效
  • .claude/settings.json：项目级配置，适合团队共享
  • .claude/settings.local.json：当前项目的个人覆盖配置

同一个字段如果同时出现在多个层级，通常是更具体的配置覆盖更通用的配置。对大多数人来说，最值得先理解的是 settings.json 和 CLAUDE.md。

settings.json 里最常见的字段通常是：

  • model：默认模型
  • permissions：允许和拦截哪些操作
  • env：会话环境变量
  • includeGitInstructions：是否保留内置 Git 提示
  • effortLevel：推理强度

一个够用的起步示例：

json
{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "claude-sonnet-4-6",
  "permissions": {
    "allow": [
      "Bash(git status)",
      "Bash(npm run lint)",
      "Read"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)"
    ]
  },
  "env": {
    "FOO": "bar"
  },
  "includeGitInstructions": true,
  "effortLevel": "medium"
}

CLAUDE.md 更像项目级说明文件，适合写不会频繁变化、但 Claude 每次都应该知道的信息，例如目录结构、启动命令、代码规范、哪些目录不要改：

md
# Project Notes

- 前端在 `apps/web`
- 组件库在 `packages/ui`
- 本地启动使用 `pnpm dev`
- 提交前先执行 `pnpm lint`
- 不要修改 `generated/` 下的文件

如果项目比较大，或者团队规范比较明确，把约束写进 CLAUDE.md 往往比每次手动补充提示词更稳定。

中转 API 配置 ​

如果你不是直连 Anthropic，而是通过第三方网关、自建代理或兼容中转访问模型，最核心的配置项是：

text
ANTHROPIC_BASE_URL

它的作用是把 Claude Code 的模型请求转发到你的中转地址。这里要区分两个概念：

  • HTTP_PROXY、HTTPS_PROXY：网络层代理
  • ANTHROPIC_BASE_URL：模型 API 中转地址

如果目标是接入 LLM gateway 或第三方转发服务，一般优先配置 ANTHROPIC_BASE_URL。

最简单的方式是在 shell 里配置：

sh
export ANTHROPIC_BASE_URL="https://your-gateway.example.com"
export ANTHROPIC_API_KEY="your-gateway-key"
claude

如果希望持久生效，可以写进 ~/.zshrc、~/.bashrc，或者直接写进 settings.json 的 env：

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://your-gateway.example.com",
    "ANTHROPIC_API_KEY": "your-gateway-key"
  }
}

如果中转要求自定义认证头，可以继续配置：

  • ANTHROPIC_AUTH_TOKEN
  • ANTHROPIC_CUSTOM_HEADERS

示例：

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://your-gateway.example.com",
    "ANTHROPIC_AUTH_TOKEN": "gateway-token",
    "ANTHROPIC_CUSTOM_HEADERS": "X-Team-ID: dev\nX-Env: prod"
  }
}

其中 ANTHROPIC_AUTH_TOKEN 会转成 Authorization: Bearer ...，ANTHROPIC_CUSTOM_HEADERS 用来补充额外请求头。

如果代理不兼容 Anthropic 的 beta 请求头，可以增加：

sh
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1

如果 ANTHROPIC_BASE_URL 指向非官方域名，而你的中转又支持相关能力，可以按需开启：

sh
export ENABLE_TOOL_SEARCH=true

配置完成后，可以在会话里执行 /status 检查当前设置是否已经生效。

使用方法 ​

Claude Code 最常见的用法就是四种：交互式、一次性、管道、恢复会话。

交互式模式最常用：

sh
claude
claude "解释这个项目的目录结构"

一次性模式适合问完就退出：

sh
claude -p "解释这个函数的作用"

管道模式适合直接处理命令输出、日志和 diff：

sh
git diff | claude -p "总结这次改动，并指出潜在风险"
cat logs.txt | claude -p "帮我定位报错原因"

继续和恢复会话：

sh
claude -c
claude -r

进入交互式会话后，最常用的几个命令通常是：

  • /help
  • /config
  • /model
  • /resume
  • /clear
  • /status

如果只从实际使用频率看，/config 负责看配置，/status 负责看当前状态，/model 负责切换模型，这三个通常最常用。

参考 ​