Linux/macOS システム設定

このガイドでは、Linux と macOS で Claude Code のサードパーティ API 用環境変数を設定する一般的な方法を説明します。例の sk-xxxx-uocode は、UoCode のトークン管理で作成した API Key に置き換えてください。

方法 1：Shell 設定ファイル（永続設定）

Bash（Linux と古い macOS）

~/.bashrc を編集します：

nano ~/.bashrc

または、使い慣れたエディタを使用します：

vim ~/.bashrc

ファイル末尾に次の内容を追加します：

# Claude Code サードパーティ API 設定
export ANTHROPIC_AUTH_TOKEN="sk-xxxx-uocode"
export ANTHROPIC_BASE_URL="https://www.uocode.com"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

保存後、次を実行します：

source ~/.bashrc

有効になったか確認します：

echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL

Zsh（macOS Catalina 以降のデフォルト）

~/.zshrc を編集します：

nano ~/.zshrc

ファイル末尾に追加します：

# Claude Code サードパーティ API 設定
export ANTHROPIC_AUTH_TOKEN="sk-xxxx-uocode"
export ANTHROPIC_BASE_URL="https://www.uocode.com"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

保存後、次を実行します：

source ~/.zshrc

Fish Shell

~/.config/fish/config.fish を編集します：

nano ~/.config/fish/config.fish

ファイル末尾に追加します：

# Claude Code サードパーティ API 設定
set -gx ANTHROPIC_AUTH_TOKEN "sk-xxxx-uocode"
set -gx ANTHROPIC_BASE_URL "https://www.uocode.com"
set -gx CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC "1"

保存後、Fish Shell を再起動します。

方法 2：一時設定（現在のターミナルセッションのみ）

現在のセッションだけで使用する場合：

export ANTHROPIC_AUTH_TOKEN="sk-xxxx-uocode"
export ANTHROPIC_BASE_URL="https://www.uocode.com"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

# 確認
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL

# Claude Code を起動
claude

ターミナルを閉じると、この設定は失われます。

方法 3：プロジェクト単位の設定（.env + 起動スクリプト）

手順 1：プロジェクトルートに .env ファイルを作成

cd your-awesome-project

cat > .env << 'EOF'
ANTHROPIC_AUTH_TOKEN=sk-xxxx-uocode
ANTHROPIC_BASE_URL=https://www.uocode.com
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
EOF

手順 2：run-claude.sh を作成

cat > run-claude.sh << 'EOF'
#!/bin/bash

# .env の環境変数を読み込む
if [ -f .env ]; then
  echo "環境変数を読み込み中..."
  export $(cat .env | xargs)
  echo "環境変数を読み込みました"
else
  echo "警告: .env ファイルが見つかりません"
fi

# 環境変数を確認
echo "現在の設定:"
echo "ANTHROPIC_AUTH_TOKEN: $ANTHROPIC_AUTH_TOKEN"
echo "ANTHROPIC_BASE_URL: $ANTHROPIC_BASE_URL"

# Claude Code を起動
echo "Claude Code を起動します..."
claude
EOF

手順 3：実行権限を付与

chmod +x run-claude.sh

手順 4：スクリプトを実行

./run-claude.sh

手順 5（任意）：システムショートカットを作成

# ユーザー bin ディレクトリにシンボリックリンクを作成
ln -s $(pwd)/run-claude.sh ~/bin/my-claude

# 確認
which my-claude

# 以後、どこからでも使用できます
my-claude

settings.json を編集する（推奨、より分かりやすい）

VS Code、Cursor、または互換エディタで Claude Code を使用する場合、Shell の起動ファイルではなく settings.json に環境変数を設定できます。

エディタの settings JSON ファイルを開き、次の設定を追加または更新します：

{
  "claudeCode.allowDangerouslySkipPermissions": true,
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "sk-xxxx-uocode"
    },
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://www.uocode.com"
    },
    {
      "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC",
      "value": "1"
    }
  ],
  "claudeCode.preferredLocation": "panel",
  "claudeCode.initialPermissionMode": "bypassPermissions",
  "claudeCode.selectedModel": "claude-haiku-4-5-20251001"
}

保存後、エディタを再起動して Claude Code を開き直します。

コマンドライン CLI の使用

ターミナルで Claude Code を直接使用する場合は、環境変数を設定してから claude を起動します：

export ANTHROPIC_AUTH_TOKEN="sk-xxxx-uocode"
export ANTHROPIC_BASE_URL="https://www.uocode.com"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

claude

起動時にモデルを指定することもできます：

ANTHROPIC_AUTH_TOKEN="sk-xxxx-uocode" ANTHROPIC_BASE_URL="https://www.uocode.com" CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1" claude -m claude-haiku-4-5-20251001

CLI が正常にインストールされているか確認します：

claude --version
claude doctor

クイックスタート

Bash の場合は次を実行できます：

echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxxx-uocode"' >> ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://www.uocode.com"' >> ~/.bashrc
echo 'export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"' >> ~/.bashrc
source ~/.bashrc
claude

Zsh を使用している場合は、~/.bashrc を ~/.zshrc に置き換えてください。