Claude Code配置

getting-started / Claude Code配置

Claude Code配置

配置必需的环境变量

在启动 Claude Code CLI 或 VS Code 插件之前,需要先准备若干环境变量。推荐一次性配置在 shell/系统设置里,并在修改后重新打开终端或编辑器,这样每个新会话都会自动继承。

macOS 或 Linux

将下列内容添加到 ~/.zshrc(zsh)或 ~/.bashrc(bash)中:

1
# Claude Code
2
export ANTHROPIC_BASE_URL="https://www.codebyai.net/api/agent"
3
export ANTHROPIC_AUTH_TOKEN="sk-proj-xxxx" # 替换成刚刚复制的 apikey
4
export API_TIMEOUT_MS=600000
5
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

保存文件后运行 source ~/.zshrc 使配置立即生效。

若希望逐条追加,可运行(bash 用户将 ~/.zshrc 改为 ~/.bashrc):

1
echo 'export ANTHROPIC_BASE_URL="https://www.codebyai.net/api/agent"' >> ~/.zshrc
2
echo 'export ANTHROPIC_AUTH_TOKEN="sk-proj-xxxx"' >> ~/.zshrc
3
echo 'export API_TIMEOUT_MS=600000' >> ~/.zshrc
4
echo 'export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1' >> ~/.zshrc
5
 
6
source ~/.zshrc

Windows

以下任意方式都可以完成同样的配置:

方式 1 · GUI(推荐,永久生效)

  1. Win + R,输入 sysdm.cpl 并回车。
  2. 打开 高级环境变量
  3. 用户变量 中点击 新建,逐个添加:
    • ANTHROPIC_BASE_URLhttps://www.codebyai.net/api/agent
    • ANTHROPIC_AUTH_TOKENsk-proj-xxxx
    • API_TIMEOUT_MS600000
    • CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC1
  4. 关闭所有窗口,重启终端或 IDE。

方式 2 · 命令提示符(永久)

1
setx ANTHROPIC_BASE_URL "https://www.codebyai.net/api/agent"
2
setx ANTHROPIC_AUTH_TOKEN "sk-proj-xxxx"
3
setx API_TIMEOUT_MS "600000"
4
setx CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC "1"

方式 3 · PowerShell(永久)

1
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://www.codebyai.net/api/agent', 'User')
2
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'sk-proj-xxxx', 'User')
3
[System.Environment]::SetEnvironmentVariable('API_TIMEOUT_MS', '600000', 'User')
4
[System.Environment]::SetEnvironmentVariable('CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC', '1', 'User')

方式 4 · 临时会话(只对当前 CMD 窗口生效)

1
set ANTHROPIC_BASE_URL=https://www.codebyai.net/api/agent
2
set ANTHROPIC_AUTH_TOKEN=sk-proj-xxxx
3
set API_TIMEOUT_MS=600000
4
set CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

启动 Claude 编码环境

在任意项目目录中运行:

1
cd your-project
2
claude

成功启动后将出现类似界面:

若使用 VS Code(或其他 IDE)插件,也需要上述环境变量。若看到如下提示:

说明插件没有读到配置,需要重新检查。也可以直接在配置文件里写死这些值:

  • Claude 全局设置

    • macOS/Linux:~/.claude/settings.json
    • Windows:C:/Users/<UserName>/.claude/settings.json
      内容示例:
    1
    {
    2
      "env": {
    3
        "ANTHROPIC_AUTH_TOKEN": "sk-proj-xxxx",
    4
        "ANTHROPIC_BASE_URL": "https://www.codebyai.net/api/agent",
    5
        "API_TIMEOUT_MS": "600000",
    6
        "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
    7
      }
    8
    }
  • VS Code settings.json – 添加:

    1
    "claudeCode.environmentVariables": [
    2
      { "name": "ANTHROPIC_BASE_URL", "value": "https://www.codebyai.net/api/agent" },
    3
      { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-proj-xxxx" }
    4
    ],

修改后请重新加载 VS Code 或重启终端。

Claude Code配置 - Documentation | Code By AI | 统一 AI 编码代理