# AI コーディングアシスタント: Claude Code & Codex

**AI コーディングアシスタント**は、ターミナル（またはエディタ）に常駐し、プロジェクトのファイルを読み、*会話*で
あなたを助けるプログラムです。やりたいことを平易な言葉で伝えると、コードを説明し、ファイルを書き・編集し、
コマンドを実行することさえできます — すべてあなたのレビューのもとで。qc-rs 初学者にとって、これは緩やかな
入口です。*「このスクリプトは何をする？」*、*「この分子を最適化して Mulliken 電荷を表示するスクリプトを書いて」*、
*「なぜこの計算は失敗した？」*と尋ねれば、プロジェクトを理解した具体的な答えが返ってきます。

この章では、人気のある 2 つ — **Claude Code**（Anthropic）と **Codex CLI**（OpenAI）— を紹介します。任意の
ツールで、qc-rs に必須ではありません。（本マニュアル自体も Claude Code で起草されました — git 履歴に
`Co-Authored-By: Claude` が見えます。）

:::{note} アカウントと費用
どちらもアカウントが必要で、**有料**サービスです（サブスクリプションまたは従量制 API 利用）。頼る前に、現行の
価格と公式セットアップ文書 — リンクは下記 — を確認してください。
:::

## qc-rs 初学者にとって何ができるか

- **コードとエラーの説明** — トレースバックを貼るか、ファイルを指して意味を尋ねる。
- **小さなスクリプトを書く** — 「水分子を作り、B3LYP を実行し、双極子モーメントを表示して」。
- **コードベースを案内** — 大きなリポジトリで「SCF の収束閾値はどこで設定されている？」。
- **テストやドキュメントの下書き** — あなたがレビューして磨く初版。

これらはアシスタントであってオラクルではありません。**生成物は必ず読み**、`git` で作業を管理して、いつでも
元に戻せるようにしましょう。

## どう動くか

どちらもターミナルで**エージェントループ**を回します:要求を読み、関連ファイルを見て、行動（回答・編集・シェル
コマンド）を提案し、あなたの許可のもとで実行し、繰り返します。知っておく価値のある 2 点:

- **プロジェクト自身の指示を読む。** このリポジトリはコーディング規約を書いた `AGENTS.md`（と `CLAUDE.md`）、
  マニュアル用の `docs/user/CLAUDE.md` を同梱しています。アシスタントはこれらを自動で読み込むので、提案は
  最初からプロジェクトの規則に従います。
- **行動の前に尋ねる。** 既定では、ファイル編集やコマンド実行の前に確認を求めます。承認・編集・拒否ができます。
  緩めたり厳しくしたりもできます（権限モード）が、初学者は確認を有効のままにし、提案された行動を毎回読んで
  ください。

## 典型的なセッション

リポジトリ内での短いやり取りはこんな感じです:

```text
$ claude
> ベンゼンの HOMO–LUMO ギャップを B3LYP/def2-SVP で計算し eV で表示するスクリプトを書いて。

  （アシスタントが新規ファイル gap.py を提案し、作成の許可を求める）   [y] 承認

> 実行して。

  （`python gap.py` を実行し、出力を表示し、その数値を説明）

> 値が大きすぎる — Hartree–Fock vs B3LYP で妥当？

  （HF がギャップを過大評価する理由を説明し、汎関数の切り替えを提案）
```

あなたは常に主導権を握ります:ファイルを承認し、実行を承認し、科学を判断します。

## Claude Code

**インストール** — **ネイティブインストーラ**が最も簡単です。Node.js 不要で自動更新もします:

```bash
curl -fsSL https://claude.ai/install.sh | bash      # macOS / Linux / WSL
```

（npm からも入れられます — `npm install -g @anthropic-ai/claude-code`、[Node.js](https://nodejs.org/) 18+
必要 — が、ネイティブインストーラならそれを避けられます。`npm install` は `sudo` で実行せず、権限エラーが出たら
[`nvm`](https://github.com/nvm-sh/nvm) などのユーザーごとの Node 管理ツールを。）Windows など現行の選択肢は
公式の [Claude Code セットアップ文書](https://code.claude.com/docs/en/setup) を参照。

**実行**は qc-rs のチェックアウト内で:

```bash
cd ~/path/to/qc_rs
claude
```

初回実行で**認証**（Claude サブスクリプションまたは Anthropic API キー）を案内されます。あとはやりたいことを
入力するだけ。qc-rs 風のプロンプト例:

```text
> docs/user のクイックスタートが何をしているか、手順ごとに説明して。
> ベンゼンを B3LYP/def2-SVP で最適化し、C–C 結合長を報告するスクリプトを書いて。
> この SCF が収束しなかった — どの収束オプションを試せる？
```

Claude Code はシェルコマンドを実行しファイルを編集できます。操作の前に確認を求め、各変更をあなたがレビュー
します。

## Codex CLI

OpenAI の **Codex CLI** も同様です。**インストール** — ネイティブインストーラ（macOS/Linux）も Node.js 不要:

```bash
curl -fsSL https://chatgpt.com/codex/install.sh | sh
```

（または npm から:`npm install -g @openai/codex`、Node.js 18+。）

チェックアウトから**実行して認証**:

```bash
cd ~/path/to/qc_rs
codex           # ChatGPT アカウントでサインイン、または OpenAI API キーを設定
```

現行のセットアップ詳細は公式の [Codex CLI 文書](https://developers.openai.com/codex/cli) を参照。

## うまく使うために

- **git ブランチで作業する。** 差分を確認し、不要なものを破棄できるように（プロジェクト文書の貢献ワークフロー
  参照）。
- **実行前にレビューする。** これらはシェルコマンドを実行しファイルを変更できます。特に削除・インストール・
  push を伴うものは、提案された操作を先に読むこと。
- **具体的に。** 「ピリジンの HOMO–LUMO ギャップを ωB97X-D/def2-TZVP で計算し eV で表示して」は「化学をやって」
  より良い。ファイルや関数を名前で指す。
- **科学を検証する。** アシスタントは qc-rs スクリプトを書けますが、化学の責任は*あなた*にあります — 手法・
  基底・結果が妥当かを確認しましょう（本マニュアルの残りは、それを学ぶためのものです）。

## アシスタントに qc-rs をセットアップさせる

これらのツールはコマンドを実行できるので、優れた*最初の*使い道はビルドそのものです。新しいマシンで qc-rs を
ビルドするとは `make setup` と `make install` を実行し、環境固有の細部を正しく整えること — まさにアシスタントが
得意な面倒な雑務です。**前提**（git、`uv` と Python、Rust、BLAS/LAPACK、必要なら MPI。[次章](installation-and-make-setup.md)
で扱います）が入っていれば、リポジトリをクローンし、アシスタントで開いてこう頼みます:

> `make setup` と `make install` で qc-rs をビルドして、ビルド設定をこのマシンのプロファイルに保存して。

アシスタントはマシンを検出し、`make setup`（プロファイルと `.vscode`・ビルド設定を生成）を実行し、
`make install`（`maturin` ビルド）を実行し、`import qc` を確認します。これはしばしば qc-rs をビルドする*最も
簡単な*方法です — ただし太字の前提に注意:**前提（uv, Python, Rust, BLAS, MPI）は既に入っている必要があります**
— アシスタントがビルドするのは *qc-rs* であってシステムのツールチェーンではありません。

次は qc-rs をインストールしましょう — 手で、あるいはアシスタントで — [インストールとビルド](installation-and-make-setup.md) で。

---

*インストールコマンドの出典:[Claude Code setup](https://code.claude.com/docs/en/setup) ·
[Codex CLI](https://developers.openai.com/codex/cli)。ツールは速く変わります — 現行の方法は公式文書を
優先してください。*